You can configure themes to allow users control over how their web applications are displayed.
You can configure themes to allow users control over how their web applications are displayed.
To use your corporate design in web applications, create your own custom themes and deploy them for use in web applications. This involves providing a customized version of the default web applications' SCSS file.
To create and deploy a custom theme
Set up a working environment for using the GitHub repository. For more information, see the One Identity Manager HTML5 Development Guide.
In the fork with the source files in the GitHub repository, open the imxweb\custom-theme\custom-theme.scss file.
Make your changes to the imxweb\custom-theme\custom-theme.scss file. Further information on customizing Angular themes can be found here.
Change the value of the $theme-name variable to the corresponding name of your custom theme (such as $theme-name: 'company-theme').
Save the file.
In the imxweb\custom-theme folder, open a command line prompt.
On the command line, run the command npm run build.
Add the custom-theme.scss file to a new ZIP file with the name Html_<ThemeName>.zip. Replace <ThemeName> with the corresponding name of the theme.
Copy the ZIP file to the bin\imxweb subfolder of your IIS installation.
In the bin\imxweb folder, create a new folder with the name Html_<ThemeName>. Replace <ThemeName> with the corresponding name of the theme.
In the newly created folder, create a new JSON file with the name imx-theme-config.json and the following parameters:
Name: Unique identifier of the theme
DisplayName: Theme name displayed in the web applications
Class: CSS class ID used for the theme (such as eui-light-theme in the default)
Urls: List of all relevant files for this theme (including images, icons, or other resources that are referenced if required)
TIP: You can define multiple themes in this file. However, each theme still requires its own ZIP file.
{ |
"Themes": [ |
{ |
"Name": "CompanyTheme", |
"DisplayName": "Company Theme", |
"Class": "company-theme", |
"Urls": [ |
"../company-theme/custom-theme.css" |
] |
}, |
{ |
"Name": "DarkCompanyTheme", |
"DisplayName": "Dark Company Theme", |
"Class": "dark-company-theme", |
"Urls": [ |
"../dark-company-theme/custom-theme.css" |
] |
} |
] |
} |
Use the Software Loader to import the ZIP file and the imx-theme-config.json file into your One Identity Manager database.
Restart your API Server.
To display the web application for users in a certain theme, you can specify a default theme.
Required configuration keys:
Default theme (DefaultHtmlTheme): Specifies which theme to use by default.
To configure a default theme
Log in to the Administration Portal (see Logging in to the Administration Portal).
In the navigation, click Configuration.
On the Configuration page, in the Show configuration for the following API project drop-down, select the API Server API project.
Expand the Default theme configuration key.
In the Value drop-down, select which theme to use by default.
Click Apply.
Perform one of the following actions:
If you want to apply the changes locally only, click Apply locally.
If you want to apply the changes globally, click Apply globally.
Click Apply.
Specify the HTTP headers to add to all responses.
Required configuration keys:
HTTP headers (HttpHeaders): Specifies the HTTP headers to add to all the responses.
To configure the HTTP headers
Log in to the Administration Portal (see Logging in to the Administration Portal).
In the navigation, click Configuration.
On the Configuration page, in the Show configuration for the following API project drop-down, select the API Server API project.
Expand the HTTP headers configuration key.
In the Value field, enter the HTTP headers to add to all responses. Enter each HTTP header on a new line.
Click Apply.
Perform one of the following actions:
If you want to apply the changes locally only, click Apply locally.
If you want to apply the changes globally, click Apply globally.
Click Apply.
© 2025 One Identity LLC. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center