Managing themes

Edit online

Themes are used to brand applic=accessations on your tenant. Themes give the users a customized look and feel of pages displayed by IBM® Verify.

About this task

Important:

Restrict access to managing themes by using the admin roles and entitlements features. Limit access to Theme Developer role and the manageThemes entitlement. Customized HTML might include inline JavaScript. Sanitize the HTML content before you upload the file, or set a custom Content Security Policy to prevent inline scripts from running.

When you configure an application in IBM Verify, you can apply a theme so that your brand displays on login pages. The group of files in a theme can be update as needed. Themes are specific to a tenant.

Most theme files contain macros that can be modified with context information. Macros are characters between the @ symbol where the data is rendered at run time. An example of the format is: 
@ACTION@
Keep the macros in the theme file, but the rest of the formatting of the page or notification can be modified according to your needs.
Note: The maximum file size for a theme file is 100 KB.

Theme files are downloaded and uploaded by using a compressed file in the following format:

/templates/
           {templateDirectories}/
                  	{locales}/
                               {templateNames}
Note: The pages under the following directories are only supported for the default theme. Pages in the default theme are not specific to an application. They apply to all applications on your Verify tenant.
  • templates/notifications/access_applications_request
  • templates/notifications/user_management/admin
  • templates/notifications/user_management/legacy_deprecated
  • templates/notifications/user_management/login/user_password_expired_email.xml
  • templates/notifications/user_management/login/user_password_expiring_email.xml

Once you have created a theme, apply it to your application by setting the Theme field in the application settings. For more information, see Setting the basic application details.

Procedure

Request an access token to work with the themes.
Use an API client that has the manageTemplates entitlement to generate an access token. For more information, see Creating API clients.
Request:

curl https://<tenant-hostname>/oidc/endpoint/default/token 
-d "grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>"
Response:
{
"access_token":"m1KhswVeQy84CF4sAki88phTkpmnYtaDzWi26ASX",
"grant_id":"079ffb03-61ed-44fe-b42f-cb6f51c8c169",
"token_type":"Bearer",
"expires_in":7200
}

Save the access token for subsequent requests.

What to do next

Select one of the following related tasks to continue branding your Verify tenant.