Unified Portal

Unified Portal provides unified login, management view switching, navigation, and access control. After logging in, users can access Home, Cloud Federation, Operations, Network Services, Access Control, and connected component pages from one entry, and view or manage resources based on role permissions.

This chapter introduces key concepts, authentication methods, unified navigation, access control, and component access paths for the Unified Portal.

Key Concepts

Before using the Unified Portal, learn the following concepts related to access methods, authentication, identity objects, and navigation scope.

Access and Authentication

ZCF uses ZIAM as the unified identity source to centrally store user accounts and authentication information, and uses SSO access configurations to apply unified authentication settings to components. After configuration is complete, users can log in to ZCF through SSO and access connected components based on permissions.

Concept Description
Unified Portal The unified access interface that users enter after logging in to ZCF. Users can switch between Global Management and region views, and access connected components and services based on permissions.
SSO Unified authentication login. After logging in to ZCF through the SSO entry, users can access components across the platform based on permissions.
Unified Identity Source ZIAM serves as the unified identity source. It centrally stores user accounts and authentication information, and synchronizes identity information to connected components as configured, providing identity consistency for unified login and cross-component access.
SSO Access Configuration Delivers identity information and unified authentication settings from ZIAM to connected components, allowing users to access the corresponding components through SSO.
Local Login Uses the ZStack Cloud local account of the Default Region to log in to ZCF, providing a management login entry when SSO is temporarily unavailable.
Access Control Controls the pages, features, resources, and operations available to different users through permission assignment and role binding.

Identity Objects

Concept Description
User An account used to log in to ZCF and access functions and resources.
User Group A collection of users for centralized management and authorization of similar users.
Project An identity scope for a specific business or collaboration objective, used to organize users, user groups, and role authorization.
Role Defines the features and resources a user can access. A role can be assigned directly to a user, or assigned to a user group, project, or department and inherited by users.
Organization Structure A structure for managing user affiliations by department or organizational hierarchy.

Access Scope and Navigation

Concept Description
Region A scope in ZCF that carries a group of resources and service pages. Users can switch regions to manage resources and services by scope.
Default Region The region that users enter by default after logging in to ZCF.
Global Management A ZCF-wide management view for platform-level configuration and services across regions and components, such as monitoring and operations, component connection, identity, and permissions.
Unified Navigation The menu system in the Unified Portal. Menus show accessible pages based on the current management view and user permissions. Pages may differ between Global Management and region views.

Enable SSO

Before enabling SSO, make sure that:

  • ZCF and ZIAM are deployed, and the current administrator has the required Global Management, Access Control, and Cloud Federation permissions.
  • The components that require unified access are deployed and accessible from ZCF.

Use this task to enable SSO. After preparing identity information and authorization relationships, connect the components through Cloud Federation and apply the SSO configuration. Users can then sign in to ZCF through SSO and access connected components based on their permissions.

  1. Prepare the identity objects used for SSO and authorization.

    Navigate to Global Management > Access Control > Identity Management and maintain users, user groups, projects, and organizations based on your organizational structure and authorization model.

    Object Purpose Preparation
    User An account that signs in to ZCF and accesses resources. Create users as needed and make sure that their status is available.
    User Group Centrally manages similar users and grants permissions in batches. Add users who require the same permissions to the same user group.
    Project Organizes users and authorization by business or collaboration scope. Create projects according to collaboration boundaries and add the corresponding users or user groups.
    Organization Manages user membership by department or organizational hierarchy. Maintain departments and user membership according to your organizational structure.
  2. Create or confirm the roles used for access control.

    Navigate to Global Management > Access Control > Identity Management > Roles. Confirm that existing roles meet the access requirements. To define a different permission scope, create a custom role.

    A role defines the pages, features, and resources that users can access. Users obtain the corresponding permissions after the role is assigned to a user, user group, project, or department.

  3. Grant access permissions to users.

    Select an authorization method based on the required scope. Assign a role directly to an individual user, or use a user group, project, or department to grant the same permissions to multiple users.

    Authorization Method Use Case Procedure
    Authorize a user through a role An individual user requires independent permissions. Open the user details and assign the role directly to the target user.
    Authorize users through a user group Multiple users require the same permissions. Assign the role to a user group, and then add the users to the group.
    Authorize users through a project Permissions are controlled by business or collaboration scope. Assign the role to a project, and then add users or user groups to the project.
    Inherit roles through an organization Permissions are managed by department or organizational hierarchy. Assign the role to a department, and then add users to the corresponding department.
  4. Connect the components that require unified access through Cloud Federation.

    Navigate to Global Management > Cloud Federation > Platform Management. Add a connected platform as prompted and save the configuration. Then make sure that its connection status is normal.

    After a component is connected, ZCF can apply an SSO configuration through the connection and display the corresponding component entry in Unified Portal.

  5. Add an SSO configuration.

    Navigate to Global Management > Cloud Federation > SSO Configuration. When you open the page for the first time, confirm the fallback authentication method, configuration overwrite impact, and preparation required before deleting a configuration, and then click Start Configuration.

    You can use the built-in Default configuration or click Add SSO Configuration to create a custom configuration. The authentication server is fixed to ZIAM, and the authentication protocol is fixed to OIDC. Select SCIM, JIT, or both modes based on the target platform type and the required identity provisioning method.

  6. Apply the SSO configuration to the connected components.

    On the SSO Configuration page, click the configuration name. On the details page, click Apply Configuration, and then click + Add Platform to select the target components. If the configuration includes SCIM, confirm the sync scope and perform a SCIM connection test.

    Applying a configuration overwrites the existing SSO configuration on the target component. After the configuration is applied, check the configuration and synchronization status on the Platform tab of the configuration details.

  7. Sign in to ZCF through SSO and verify component access.

    On the login page, select SSO. After authentication, Unified Portal opens. Users can switch management views and access connected components based on their permissions.

    If a user cannot see an expected menu or access a component page, check the current management view, component connection status, SSO configuration status, and user authorization relationships.

After the configuration is complete, users can sign in to ZCF through SSO. Unified Portal displays accessible pages based on the current management view, component connection status, and user permissions.

To adjust a user's access scope, view the user's permission sources in Access Control, and then update the corresponding user, user group, project, role, or organization.

Login and Authentication

After ZCF is installed, access the ZCF UI address in a browser to open the login page. The login page provides two login methods: local login and SSO.

Login Method Scenario
SSO Applies to environments where ZIAM-based SSO has been configured. Users can log in through the unified authentication entry, enter Unified Portal, and access connected components based on role permissions.
Local Login Uses the ZStack Cloud local account of the Default Region to log in to ZCF. This method provides an entry to the management UI when unified authentication is temporarily unavailable.

Log In Locally

Local login uses the ZStack Cloud local account system of the Default Region. This login method includes the Account Login and Tenant Login tabs. Administrators typically use account login to enter the management UI. Tenant users can select tenant login based on tenant account configuration in the environment.

  1. On the login page, select Local Login.
  2. Select Account Login or Tenant Login based on the account type.
  3. Enter the local account and password.
  4. Click Login.
  5. After login succeeds, enter Unified Portal.

Log In Through SSO

After SSO access is configured and applied to connected components, users can select SSO on the login page and complete identity authentication through ZIAM.

  1. On the login page, select SSO.
  2. Click the SSO login button.
  3. Complete account authentication as prompted.
  4. After authentication succeeds, enter Unified Portal.
Note: SSO login depends on ZIAM-based SSO configuration. If SSO has not been configured in the current environment, use local login or contact the administrator to complete authentication configuration.

Unified Navigation and Access

After logging in to ZCF, users can switch management views in the Unified Portal and open platform-level pages such as Home, Cloud Federation, Access Control, Operations, and ZNS Network Center.

This section describes how to switch management views, access Home, open connected components, and check menu availability.

Switch Management Views

After login, users can switch between the Default Region and Global Management. The Default Region carries resource and tenant-related pages in the default scope. Global Management provides platform-level pages for cross-component operations, component access, identity and permissions, observability, and network services.

View Description
Default Region View or manage resources and tenant-related objects in the default resource scope.
Global Management Open platform-level pages such as Home, Dashboards and Reports, Operations, Cloud Federation, Access Control, and ZNS Network Center.
  1. Log in to ZCF.
  2. In the upper-right corner of the main menu, switch to Global Management.
  3. In the Global Management view, access Home, Dashboards and Reports, Operations, Cloud Federation, Access Control, or ZNS Network Center as needed.
  4. To return to resource and tenant-related pages within the current region, switch back to the Default Region from the same location.
Note: ZNS Network Center is the UI entry for network services.

Access Home

Home is located in the Global Management view and is used to view the global overview of ZCF. Resource, health, capacity, and performance data on Home depends on product access and data collection status. If no infrastructure component has been connected, related data might be empty.

  1. Log in to ZCF.
  2. In the upper-right corner of the main menu, switch to Global Management.
  3. In the main menu, click Home.

Access Connected Components

Users can open ZCF functional modules and connected component pages from Unified Portal. Before access, confirm the current management goal and management view.

Access Paths

Goal Page How to Access
View the global overview Home Switch to Global Management, and then open Home to view the overall resource and running status.
Connect and manage components Cloud Federation Switch to Global Management, and then open Cloud Federation pages.
View observability data Dashboards and Reports / Operations Switch to Global Management, and then open the related observability pages.
Manage network resources ZNS Network Center Switch to Global Management, and then open ZNS Network Center.

Access Restrictions

Unified Portal displays only the pages that are available in the current environment and accessible to the current user. If a component is not deployed, not connected, not licensed, or unavailable, the related page might not be displayed. Users might also be unable to open a page from historical links or direct URLs.

To access a component, make sure the component has been deployed, connected, and licensed, and make sure the current account has the required access permissions.

Check Menu Availability

In Unified Portal, if an expected menu is not displayed, or if a page or operation is unavailable after you open a menu, check the following items.

Check Item Description
Login method Access Control and related global identity management pages must be accessed after logging in through SSO. When local login is used, related menus or pages might be unavailable.
Management view Some menus are displayed only in the Global Management view or in a specified region view. Switch to the view that contains the feature you want to access.
Component deployment status If a component is not deployed or its service is unavailable, the menu might be hidden, or the page might be inaccessible.
Component connection status For resources or data that require a Cloud Federation connection, complete information might be displayed only after the connection is completed.
License status If the license is unavailable, expired, or does not cover the required capability, the related menu or operation might be unavailable.
User permissions Menus that the current account is not authorized to access might not be displayed. After a page is opened, unauthorized operations might also be unavailable.

To access platform-level pages such as Cloud Federation, Operations, Access Control, or ZNS Network Center, first switch to the Global Management view. If the related menu is still unavailable, check the component deployment, license, and account permission status.

Access Control

Access Control provides unified management of identities and role assignments for ZCF and integrated platforms. Administrators can centrally manage users, user groups, projects, roles, and organizations, and assign roles to users directly or through associations.

Access Control maintains unified identity information and role assignments. Integrated platforms interpret roles according to their own permission models and determine which features and resources users can access.

Understand Access Control

Before you begin configuration, verify the requirements for accessing Access Control and understand how each identity object participates in role assignments. Select users, user groups, projects, or organizations based on the authorization objective to reduce duplicate configuration and centrally maintain role assignments.

Users, user groups, projects, roles, and organizations are centrally maintained in Access Control and serve as the authoritative identity data for integrated platforms. ZCF synchronizes identity data to integrated platforms in one direction. Integrated platforms do not modify or overwrite this identity data.

Access and Permissions

Item Description
Sign-in Method Sign in to ZCF through SSO.
Management Perspective Access Control is available from the Global Management perspective.
Account Permissions The current user must have Access Control permissions.
Navigation Navigate to Global Management > Access Control. The Access Control navigation includes Overview, Users, User Groups, Projects, Roles, and Organizations.

Managed Objects

Object Purpose
Users Maintain account identities that sign in to ZCF and integrated platforms, including user status, associations, and directly assigned roles.
User Groups Organize users with the same responsibilities or authorization requirements to centrally maintain role assignments and project relationships.
Projects Organize users and user groups around the same business or collaboration scope and centrally maintain project roles.
Roles Represent assignments passed between Access Control and integrated platforms. Roles can be assigned to users, user groups, projects, or departments.
Organizations Maintain user associations in a stable department hierarchy and centrally maintain roles by department.

View the Access Control Overview

The Access Control Overview page displays the numbers of users, user groups, projects, and roles, sign-in information for the current account, and shortcuts to common actions.

  1. Use an account with Access Control permissions to sign in to ZCF through SSO.
  2. Switch to the Global Management perspective.
  3. Navigate to Access Control > Overview.
  4. View identity statistics and Access Control shortcuts.
    Resource Description
    Users Account identities that ZCF currently recognizes and manages.
    User Groups Collections for organizing users and assigning roles in batches.
    Projects Scopes for organizing member collaboration and role assignments in the identity domain.
    Roles Role objects that can be assigned to users, user groups, projects, or departments and interpreted by integrated platforms.
  5. Use Quick Actions to create a user, user group, project, or role as needed, or open the Organizations page to manage department relationships.
Note: If the Access Control menu is not displayed, verify that the current account used SSO to sign in and has Access Control permissions.

Understand Roles, Assignments, and Permission Boundaries

Access Control maintains roles and their assignments to users, user groups, projects, and departments. After users join a user group, project, or department, they inherit the roles assigned to that object. Viewing role sources helps you determine which object to use to adjust an assignment.

Role Sources

Source Description
Direct The role is assigned directly to the user.
Inherited from User Group After joining a user group, the user inherits the roles assigned to that user group.
Inherited from Project The user inherits the roles assigned to a project after joining the project directly or through a user group.
Inherited from Department After being assigned to a department, the user inherits the roles assigned to that department.

Permission Boundary

When you create a custom role in Access Control, you specify only the role name and description. You cannot configure page permissions, feature permissions, or resource scopes. Integrated platforms map and interpret roles according to their own permission models and determine which resources and features users can access.

Business permissions and resource management settings on an integrated platform remain managed by that platform. Access Control does not replace the business permission management of individual platforms.

Select an Authorization Method

Select an authorization path based on the authorization target, user scope, and collaboration model. Prepare roles before assigning them. You can create departments, user groups, and projects first, and then configure these associations when you create users.

Authorization Objective Use Case Recommended Preparation Order
Authorize an individual user A user requires a role independently of other users. Role → User
Authorize a group of users consistently Multiple users have the same responsibilities and their roles must be maintained centrally. Role → User Group → User
Authorize by organization hierarchy Users must inherit roles based on their department associations. Role → Department → User
Authorize by project scope Users or user groups collaborate within the same business scope. Role → User or User Group → Project
Initialize complete identity relationships You are configuring Access Control for the first time and must establish complete identity relationships and role assignments. Role → Department → User Group → Project → User → View Role Sources
Note: Access Control maintains role objects and assignments. The features and resources that users can ultimately access on an integrated platform depend on the platform's role mappings and permission configuration.

Prepare Roles

Before you assign roles, identify the roles that the integrated platform recognizes. Review system roles first. If no system role meets the mapping requirements, create a custom role.

System Roles and Custom Roles

Role Type Description
System Role Predefined by the system and used for mapping roles on integrated platforms.
Custom Role Created by an administrator according to the mapping requirements of an integrated platform.

Preparation Order

Review system roles and verify whether they meet the mapping requirements of the integrated platform. If a custom role is required, create the role and complete its mapping on the integrated platform before assigning it to users, user groups, projects, or departments.

View System Roles

System roles are predefined by the system and used for mapping roles on integrated platforms. Before you configure role assignments, verify whether a system role already meets the requirements.

  1. Navigate to Global Management > Access Control > Roles.
  2. In the role list, set the source filter to System.
  3. Search for the role and open the role details page.
  4. View the role name, description, and audit records, and verify that the role meets the mapping requirements of the integrated platform.
Note: System roles cannot be edited or deleted.

Create a Custom Role

Verify that the target integrated platform supports mapping the custom role and determine the role name.

When an integrated platform must map a role that is not in the system role list, create a custom role in Access Control.

  1. Navigate to Global Management > Access Control > Roles.
  2. Click Create Role.
  3. Enter the role information.
    Parameter Description
    Name Enter a name that identifies the purpose of the role. The maximum length is 128 characters.
    Description Enter the purpose or applicable scope of the role. The maximum length is 256 characters.
  4. Click OK.
Note: Creating a custom role does not automatically create page permissions, feature permissions, or resource scopes on an integrated platform. Complete the role mapping on the integrated platform before assigning the role to users, user groups, projects, or departments.

Manage Custom Roles

Edit the name and description of a custom role, or delete a custom role that is no longer used.

  1. Navigate to Global Management > Access Control > Roles.
  2. Search for the role in the role list.
  3. Verify that the role source is Custom, and open the role details page.
  4. Perform a management action as needed.
    • To modify the role name or description, click Actions, select Edit, make the changes, and save them.
    • To delete the role, first remove role assignments to users, user groups, projects, or departments that are no longer required. Then click Actions, select Delete, and confirm the operation.
Warning: Before deletion, the system checks whether the role is still assigned to users, user groups, projects, or departments and whether an integrated platform still retains the role mapping. The delete operation is rejected if any of these relationships exist. A deleted role cannot be recovered, but its audit history is retained.

Manage Users and Roles by Organization

After you select organization-based authorization, create departments according to the actual organization hierarchy and assign roles to them. Then add users as direct users of the corresponding departments.

Departments, Direct Users, and Roles

A department can contain subdepartments and direct users. Roles assigned to a department apply to its direct users. To verify whether a user inherited a department role, view the role source on the user details page.

Ungrouped

Ungrouped is a system-defined department that contains users who are not assigned to a department. It cannot be edited, moved, deleted, assigned roles, or contain subdepartments. Users are automatically removed from Ungrouped after joining another department.

Create a Department

Create a department and configure its hierarchy to maintain user associations and roles by organization.

To assign roles when you create the department, prepare the required roles.

  1. Navigate to Global Management > Access Control > Organizations.
  2. Click Create Department.
  3. Configure the department parameters.
    Parameter Description
    Parent Department Optionally select a parent department. If no parent department is selected, the department is created at the top level of the organization hierarchy.
    Name Enter a department name of up to 128 characters. The name must not duplicate an existing department name.
    Description Enter the responsibilities or applicable scope of the department. The maximum length is 256 characters.
    Roles Optionally select the roles to assign to the department.
  4. Click OK.

    If you also assign roles, the system creates the department first and then configures the role relationship. If the page reports that creation failed, return to Organizations and verify whether the department was created. Then open the department details page and assign any roles that were not configured. Do not submit the create operation again before checking.

After the department is created, you can maintain direct users, roles, and the department hierarchy on the Organizations page.

Maintain Departments, Direct Users, and Roles

Maintain department information and hierarchy, direct users, and department roles.

  1. Navigate to Global Management > Access Control > Organizations.
  2. Select the department in the organization tree.
  3. Maintain the department as needed.
    Action Description
    Direct Users Add or remove users on the Direct Users tab.
    Roles Assign or unassign roles on the Roles tab.
    Audit View changes to the department, direct users, and role assignments on the Audit tab.
    Add Subdepartment Create a subdepartment under the current department.
    Edit Modify the department name or description.
    Move Department Select a new parent department for the current department. You cannot select the current department or one of its subdepartments as the parent.
    Delete Delete the current department and all of its subdepartments.
  4. Save the changes and verify that the organization hierarchy or details page is updated.
  5. To verify whether a user inherited a department role, open the Roles tab on the user details page and view the role source.
Note: Ungrouped cannot be edited, moved, deleted, assigned roles, or contain subdepartments. To allow a user to inherit department roles, add the user to another department first.
Warning: Deleting a department also deletes all of its subdepartments. Affected users are automatically moved to Ungrouped. Verify the department hierarchy and user associations before deletion.

Assign Roles Consistently to a Group of Users

After you select user group authorization, create a user group and assign roles to it, and then add users with the same authorization requirements to the group. You can also add a user group to a project so that group members inherit project roles.

How Relationships Take Effect

Roles assigned to a user group apply to its members. After a user joins the group, the user inherits the roles assigned to the group. After the user leaves the group, the user no longer inherits roles from that group.

After a user group joins a project, group members also inherit the roles assigned to that project. To adjust these roles, maintain the relationship between the user group and project or maintain the roles assigned to the project.

Create a User Group

To assign roles or associate projects when you create the user group, prepare the required roles or projects.

When multiple users require the same project scope or roles, create a user group to maintain them centrally.

  1. Navigate to Global Management > Access Control > User Groups.
  2. Click Create User Group.
  3. Configure the user group parameters.
    Parameter Description
    Name Enter a user group name of up to 128 characters. The name must not duplicate an existing user group name. Use a name based on a department, position, or business responsibility.
    Description Enter the purpose of the user group or its intended members. The maximum length is 256 characters.
    Users Optionally select the users to add to the user group.
    Projects Optionally select the projects that the user group must join.
    Roles Optionally select the roles to assign to the user group.
  4. Click OK.

    If you also configure users, projects, or roles, the system creates the user group first and then configures each relationship in sequence. If the page reports that creation failed, return to the user group list and verify whether the user group was created. Then open the details page and complete any relationships that were not configured. Do not submit the create operation again before checking.

After the user group is created, you can continue to maintain users, projects, and roles on the user group details page. After a user joins the group, the user inherits the roles assigned to the group.

Maintain User Group Members, Projects, and Roles

Centrally maintain members, projects, and roles on the user group details page to adjust role assignments for group members.

  1. Navigate to Global Management > Access Control > User Groups.
  2. Search for the user group and open the user group details page.
  3. Maintain user group members, projects, and roles as needed.
    Tab Description
    Users Add users to or remove users from the user group.
    Projects Add the user group to or remove the user group from projects.
    Roles Assign roles to or unassign roles from the user group.
    Audit View changes to user group membership and role assignments.
  4. Save the changes and verify that the members, projects, or roles are updated on the details page.
  5. To modify the name or description, click Actions, select Edit, make the changes, and save them.
  6. To delete the user group, verify that users no longer need to inherit roles or join projects through the user group. Then click Actions, select Delete, and confirm the operation.
  7. To verify whether a user inherited a role from the user group, open the Roles tab on the user details page and view the role source.

After user group relationships are updated, group members inherit roles assigned to the user group or associated projects.

Note: Deleting a user group does not delete its users, associated projects, or roles. However, membership and role assignments established by the user group no longer take effect.

Manage Members and Roles by Project Scope

After you select project authorization, create a project and assign roles to it, and then add users or user groups to the project. Users added directly and members of user groups in the project are project members.

Members and Roles

Roles assigned to a project apply to its members. A user can join a project directly or through a user group. After a user or user group leaves the project, the user no longer inherits roles from that project.

Project Boundary

A project in Access Control maintains only membership and role assignments in the identity domain. It does not maintain resources, quotas, region associations, or project extension attributes on integrated platforms such as ZStack Cloud.

Create a Project

To add members or assign roles when you create the project, prepare the required users, user groups, or roles.

When a group of users requires roles for the same business or collaboration objective, create a project and use project members and roles to control the access boundary.

  1. Navigate to Global Management > Access Control > Projects.
  2. Click Create Project.
  3. Configure the project parameters.
    Parameter Description
    Name Enter a project name of up to 128 characters. The name must not duplicate an existing project name. Use a name that identifies the business, team, or collaboration objective.
    Description Enter the purpose of the project or its member scope. The maximum length is 256 characters.
    Users Optionally select the users to add directly to the project.
    User Groups Optionally select the user groups to add to the project.
    Roles Optionally select the roles to assign to the project.
  4. Click OK.

    If you also configure users, user groups, or roles, the system creates the project first and then configures each relationship in sequence. If the page reports that creation failed, return to the project list and verify whether the project was created. Then open the details page and complete any relationships that were not configured. Do not submit the create operation again before checking.

After the project is created, you can continue to maintain members and roles on the project details page. Users and user groups added to the project inherit the roles assigned to the project.

Maintain Project Members and Roles

Maintain the users, user groups, and roles associated with a project so that project authorization matches the actual collaboration relationships.

  1. Navigate to Global Management > Access Control > Projects.
  2. Search for the project and open the project details page.
  3. Maintain project members and roles as needed.
    Tab Description
    Users Add or remove project users.
    User Groups Add or remove project user groups.
    Roles Assign roles to or unassign roles from the project.
    Audit View changes to project membership and role assignments.
  4. Save the changes and verify that the members or roles are updated on the details page.
  5. To modify the name or description, click Actions, select Edit, make the changes, and save them.
  6. To delete the project, verify that members no longer need to inherit roles from the project. Then click Actions, select Delete, and confirm the operation.
  7. To verify whether a user inherited a role from the project, open the Roles tab on the user details page and view the role source.

After project relationships are updated, project members inherit roles assigned to the project.

Note: Deleting a project does not delete its users, user groups, or roles. However, membership and role assignments established by the project no longer take effect.

Create and Manage Users

After you determine the authorization method for a user, create the user and configure associations. When you create a user, you can add the user to user groups, projects, or departments and assign roles directly. You can continue to maintain these relationships after the user is created.

Configuration Order

Before you create a user, prepare the roles, departments, user groups, or projects to associate with the user. After the user is created, maintain associations and direct role assignments on the user details page, and view role sources to verify how each role was assigned.

User Status

To temporarily prevent a user from signing in, disable the user to preserve existing associations and roles. Enable the user to restore access. Delete the user only when the account is no longer required.

Create a User and Configure Associations

Create a unified identity account and configure the user's user groups, projects, departments, and roles.

To configure all associations and roles when you create the user, prepare the required user groups, projects, departments, and roles.

  1. Navigate to Global Management > Access Control > Users.
  2. Click Create User.
  3. Enter the user information as prompted.
    Parameter Description
    Username Enter 2-64 characters. Use only letters, numbers, hyphens (-), underscores (_), and periods (.). Spaces are not allowed, and the username must not duplicate an existing username. Use a consistent account naming convention for your organization.
    Display Name Enter a name that identifies the user in the UI. The maximum length is 128 characters.
    Password Enter an initial password of 8-32 characters.
    Confirm Password Enter the initial password again. The two entries must match.
    Description Optionally enter information such as the user's responsibilities. The maximum length is 256 characters.
    Phone Number Optionally select a country calling code and enter a phone number. The complete number cannot exceed 15 digits.
    Email Optionally enter a valid email address. The maximum length is 254 characters.
    User Groups Optionally select the user groups that the user must join.
    Projects Optionally select the projects that the user must join directly.
    Departments Optionally select the user's direct departments.
    Roles Optionally select the roles to assign directly to the user. Do not select roles that the user already inherits from a user group, project, or department.
  4. Click OK.

    If you also configure user groups, projects, departments, or roles, the system creates the user first and then configures each relationship in sequence. If the page reports that creation failed, return to the user list and verify whether the user was created. Then open the user details page and complete any relationships that were not configured. Do not submit the create operation again before checking.

  5. Verify that the user status is Enabled in the user list.

After the user is created, you can open the user details page to maintain associations and direct role assignments and view roles inherited from user groups, projects, or departments.

Maintain User Associations and Direct Roles

As user responsibilities change, adjust the user's user groups, projects, and departments, or assign and unassign roles directly.

  1. Navigate to Global Management > Access Control > Users.
  2. Search for the user and open the user details page.
  3. To maintain user information, click Actions, select Edit or Change Password, make the changes, and save them.
  4. Click Actions and select a relationship management action as needed.
    Action Description
    Manage User Groups Adjust the user groups to which the user belongs. The user inherits roles assigned to those user groups.
    Manage Projects Adjust the projects that the user joins directly. The user inherits roles assigned to those projects.
    Manage Departments Adjust the user's direct departments. The user inherits roles assigned to those departments.
    Manage Roles Adjust roles assigned directly to the user.
  5. Save the changes.
  6. On the Roles tab of the user details page, verify the roles and their sources.

Enable, Disable, or Delete Users

Disable a user and retain identity relationships when the user must temporarily stop accessing ZCF. Enable the user to restore access. Delete the user when the account is no longer required. After deletion, the user is no longer displayed in the user list or user selectors for related resources. This page does not provide an action to recover deleted users.

  1. Navigate to Global Management > Access Control > Users.
  2. Search for the user in the user list. To operate on multiple users, select the users and click Batch actions.
  3. Perform an action based on the management objective.
    Action Use Case
    Disable Suspend account sign-in and access and terminate current sessions. User associations, roles, and audit records are retained.
    Enable Restore use of the account. The user can continue to access ZCF and integrated platforms according to existing authorization.
    Delete Delete a unified identity account that is no longer used. After deletion, the user is no longer displayed in the user list or user selectors for related resources. Before deletion, verify that the account no longer needs to sign in to ZCF or any integrated platform.
  4. Confirm the action as prompted.
  5. Verify the result in the user list or audit records.
Note: After you disable a user, the user cannot sign in and current sessions are terminated. When you enable the user again, the user's original associations and roles are retained.
Note: When you enable, disable, or delete users in a batch, the system processes each user separately. If some operations fail, use the failure details displayed on the page to retry the affected users.
Warning: This page does not provide an action to recover deleted users. To temporarily prevent a user from signing in, use Disable.

View and Adjust a User's Roles

Before you adjust a user's roles, view the role sources on the user details page. If a role is assigned directly to the user, adjust it on the current user. If a role comes from a user group, project, or department, adjust the assignment on the corresponding source object.

To affect only the current user, assign or unassign the role directly. To adjust multiple users consistently, modify the role on their common source object.

Assign a Role Directly to a User

A role is available for assignment. To create a role, see Create a Custom Role.

When an individual user requires an independent role, assign the role directly to the user. This method affects only the current user and is suitable for temporary authorization, individual accounts, or a small number of account adjustments.

  1. Navigate to Global Management > Access Control > Users.
  2. Search for the user and open the user details page.
  3. Open the Roles tab and click Assign Role.
  4. Select the role and verify that the required permission mapping for the role has been completed on the integrated platform.
  5. Save the changes and verify that the role is displayed on the user details page.
  6. To trace the source of the assignment, open the Audit tab and view the change record.
Note: If users of the same type require the same role, assign the role to a user group and add the users to that user group.

View User Role Sources

View roles assigned directly to a user or inherited from user groups, projects, and departments to determine which assignment to adjust.

  1. Navigate to Global Management > Access Control > Users.
  2. Search for the user and open the user details page.
  3. Open the Roles tab and view roles assigned directly to the user or inherited from other objects.
  4. Determine where to adjust the role based on its source.
    Role Source Adjustment Location
    Direct Adjust the assignment on the Roles tab of the user details page.
    Inherited from User Group Open the corresponding user group details page and adjust user group members or the roles assigned to the user group.
    Inherited from Project Open the corresponding project details page and adjust project members or the roles assigned to the project.
    Inherited from Department Open Organizations and adjust department users or the roles assigned to the department.
  5. Open the Audit tab and view changes to user group, project, role, and other relationships.