The branding feature lets you customize logon pages for multi-brand and multi-domain scenarios. Configure your company logo, favicon, page style, interface text, privacy policy terms, and default redirect — separately per brand and per language.
Brand types
IDaaS supports two types of brands:
| Brand type | Quantity limit | Scope | Configurable items |
|---|---|---|---|
| Default brand | 1 built-in, cannot be deleted | Default endpoint only | Enterprise (icon, favicon, name), Policy Configuration, Default Jump |
| Custom brand | 1 custom brand maximum | Can attach a custom domain | All of the above, plus Style Settings and Text Settings |
The Style Settings and Text Settings tabs are not available for the default brand. To access full style and text customization, create a custom brand.
Prerequisites
Before you begin, ensure that you have:
An IDaaS instance in the Alibaba Cloud IDaaS console
Create a custom brand
Log on to the Alibaba Cloud IDaaS console and select the target instance. In the left navigation pane, click Branding.
Click Create Brand. The Create Brand dialog box appears.
Enter a brand name (1–64 characters). Click Save.
To rename or delete a custom brand later, click Modify or Delete to the right of the brand name.
Configure the effective domain
In the left navigation pane, click Branding. Find the target brand and click Configure Effective Domain.
In the Configure Effective Domain dialog box, select Custom Domain Name and click OK.
Configure company information
In the Enterprise area for the target brand, click Configure.
Upload your assets and set the company name. The following table lists the requirements for each asset:
Asset Format Max size Recommended dimensions Notes Enterprise Icon PNG or JPG 1 MB 256 × 256 px (square) Appears on the logon page and portal page Favicon PNG — 32 × 32 px (square) Appears in the browser tab Enterprise Name Text 1–64 characters — Set a different name per interface language To preview how the page looks, select PC or Mobile in the upper-right corner.
Click Save and Publish to apply the configuration immediately.
Configure logon page style
Style Settings is available for custom brands only.
In the left navigation pane, click Branding and find the target brand. On the brand configuration page, click Login Page Configuration > Configure.
In the Style Settings tab, configure the following:
Setting Options Enterprise Icon size Large, Medium, or Small Enterprise Icon alignment Left, Center, or Right Company Name alignment Left, Center, or Right Page Background Solid Color Background — pick a color using the color picker. Image Background — upload an image and choose a display mode (Fill Screen, Center, Tile, Stretch, or Fit To Screen) Login Form Position Left, Center, or Right Preview and test the style:
Select PC or Mobile in the Preview section on the right.
Click Logon Experience to open the actual logon page and test the interaction.
To revert to the last saved state, click Restore Configuration.
Click Save in the lower-left corner to save the configuration as a draft, or click Publish to make it live.
Configure logon page text
Text Settings is available for custom brands only.
In the left navigation pane, click Branding and find the target brand. On the brand configuration page, click Login Page Configuration > Configure.
From the Select Language drop-down list, choose the language to configure (for example, 简体中文（zh-Hans-CN） or English (en-US)).
Each language has its own set of text and style settings. Switch between languages to configure and save them separately.
Configure the following text elements:
Element What it controls Configuration options Enterprise Name Company name displayed on the logon page Font weight, font size Username placeholder Hint text shown in the username input field Placeholder text, font weight, font size Password placeholder Hint text shown in the password input field Placeholder text, font weight, font size Custom Link A link displayed at a specified location on the logon page, pointing to an external page Link Name (display text, for example, Help Center or Forgot Password) and Link URL (full URL, must start with https://)
Configure terms
In the left navigation pane, click Branding and find the target brand. On the brand configuration page, click Login Page Configuration > Configure.
In the Custom Privacy Policy area, click the Select Policy drop-down list and select a policy. If the list is empty, click Add Policy in the Custom Privacy Policy section to create one first.
Click Save and Publish to apply the configuration immediately.
Configure default redirect
In the left navigation pane, click Branding and find the target brand. On the brand configuration page, click Login Page Configuration > Configure.
Click the search icon to the right of the Default Redirection Application input box. From the list, select the application to redirect to after logon (for example, MyApp or IDaaS Application Portal).
Click Save in the lower-left corner.
Related operations
To disable, enable, modify, or delete a custom brand, find the target brand on the Branding tab and click Disable, Enable, Modify, or Delete in the Permissions area.