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.1. Access SAML Settings
1. Configure Custom Domain in SSO Provider Settings
1.1. Access SAML Settings
- Access Applications
- Under the SAML Settings section click [Edit]
- [Next]
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
- Access
/opt/mi/external_config/saml.php
- Add
define('SAML_ENTITY_ID', 'https://<MI hostname>/simplesaml/module.php/saml/sp/metadata.php/metricinsights-sp');
to thesaml.php
file replacing<MI hostname>
with the hostname of your MI application
4. Configure Custom Domain for Portal Page
Access the Advanced tab
- Enter a Custom Domain for your Portal Page that was previously configured in SSO provider settings and have been added to the certificate
- The Portal Page can be accessed by its Custom Domain