Configuring a Custom Domain for a Portal Page

Beginning v6.3.5 you can define Custom Domain for Portal Pages. The example described in this article implies that Okta is used for user authentication, however, the same configuration can be applied with other single sign-on providers.
Note: Configuration can only be performed by a user designated as a System Admin.

The process comprises the following steps:

  1. Configure Custom Domain in SSO Provider Settings

1.1.    Access SAML Settings

1.2.   Configure Advanced Settings

  1. Add DNS Name to Certificate
  2. Modify saml.php File
  3. Configure Custom Domain for Portal Page

1. Configure Custom Domain in SSO Provider Settings

1.1. Access SAML Settings

  1. Access Applications
  2. Under the SAML Settings section click [Edit]
  3. [Next]

1.2. Configure Advanced Settings

  1. [Show advanced settings]
  2. Click [+ Add Another] to add a new value by copying the initial SSO URL and replacing the MI hostname part of the URL with the Custom Domain

2. Add DNS Name to Certificate

Alternatively, if your MI application is deployed on AWS, you can assign SSL certificate with Network Load Balancer.

3. Modify saml.php File

Access the web container

  1. Access /opt/mi/external_config/saml.php
  2. Add define('SAML_ENTITY_ID', 'https://<MI hostname>/simplesaml/module.php/saml/sp/metadata.php/metricinsights-sp'); to the saml.php file replacing <MI hostname> with the hostname of your MI application

4. Configure Custom Domain for Portal Page

Access the Advanced tab

  1. Enter a Custom Domain for your Portal Page that was previously configured in SSO provider settings and have been added to the certificate
  2. The Portal Page can be accessed by its Custom Domain