IRIS Management & Interoperability Portal

A lightweight, web-based management portal for InterSystems IRIS and InterSystems IRIS HealthConnect.

The portal brings commonly used platform, security, scheduled task, system alert, HealthConnect production, and mirroring information into a single interface.

✨ Features

🌐 Web Application information

🔐 Roles and security resources

🔒 SSL/TLS configurations

📜 X.509 credentials

🔑 OAuth clients

🔑 OAuth server definitions

🔑 OAuth authorization server configurations

⏰ Scheduled system tasks

🚨 System alerts

🏭 HealthConnect production status

🔄 IRIS mirroring information

📱 Responsive web interface

🔌 REST API-based architecture

🔃 Refreshable operational information

🏗️ Architecture - High Level Information

The portal uses a REST API-based architecture.

The central REST service is: PORTAL.RESTService.Config.ResHandler

The REST service extends:%CSP.REST

REST routes are defined using the IRIS UrlMap class.

The portal UI consumes JSON responses provided by the REST APIs.

REST API

The REST APIs are available under:
/csp/irisportal/api/

Available REST API Endpoints

Endpoint	Purpose
`/WebRestApplication`	Web application information
`/RoleResource`	Roles and resource permissions
`/SSLConfigs`	SSL/TLS configuration information
`/X509Credentials`	X.509 credential information
`/OAuthClients`	OAuth client information
`/OAuthServerDefinitions`	OAuth server definitions
`/OAuthServerConfigurations`	OAuth authorization server configuration
`/Tasks`	Scheduled task information
`/Alerts`	System alert information
`/Production`	HealthConnect production information
`/Mirror`	IRIS mirroring information

Requirements

InterSystems IRIS
Developed and tested with: InterSystems IRIS for Windows (x86-64) 2025.1.1
Other compatible IRIS versions may work but should be tested before production use.

HealthConnect

HealthConnect is required for HealthConnect-specific functionality such as Production Management.
The other platform-management sections can be used based on the corresponding IRIS functionality available in the environment.

🛠️ Technology

The portal is built using the following technologies, frameworks, and open-source tools:

InterSystems IRIS

InterSystems HealthConnect

InterSystems %CSP.REST

REST APIs

JSON

HTML5

CSS3

JavaScript

Bootstrap

IRIS UrlMap routing

Web-based UI

Open-source libraries, tools, and development techniques

⚠️ Compatibility

The project has been developed and tested against:

InterSystems IRIS for Windows (x86-64) Version: 2025.1.1

Compatibility with other IRIS releases should be validated in a non-production environment before deployment.

📸 Screenshots

Landing Page

IRIS Management Portal - Landing Page

Web Applications & REST APIs

View configured IRIS web applications and REST API information.

IRIS Management Portal -Web Applications & REST APIs

Roles & Resources

View IRIS security roles and associated resources.

IRIS Management Portal -Roles and Resources

Security

View security-related configuration including SSL/TLS configurations, X.509 credentials, OAuth clients, and OAuth server configuration.

IRIS Management Portal -Security

Task Management

View scheduled IRIS system tasks and their operational information.

IRIS Management Portal -Task Management

System Management

View platform-level system management information from a centralized interface.

IRIS Management Portal -System Management

System Log & Alerts

View system alerts, alert counts, severity, monitoring status, and recent alert messages.

IRIS Management Portal -System Log & Alerts

HealthConnect Production — Current Status<

View HealthConnect production information including:

IRIS Management Portal -Production Status

IRIS Mirroring

View IRIS mirror information including:

IRIS Management Portal -Mirroring

API Examples :

GET http://localhost/csp/irisportal/api/WebRestApplication

Production Information

GET http://localhost/csp/irisportal/api/Production

The APIs return JSON responses for consumption by the portal UI.

🚀 Installation

Detailed installation instructions are provided in: INSTALLATIONGUIDE.md

For complete installation and configuration details, please refer to INSTALLATIONGUIDE.md.

🎥 Demo Video

▶️ Click the image above to watch the demo on YouTube

iris-management-portal