Configuring Agency Authorization for ModelArts with One Click

Scenario

ModelArts must access other services for AI computing. For example, ModelArts must access OBS to read your data for training. To ensure security, ModelArts requires your authorization before accessing any cloud services, which is the agency. Then, you can perform AI computing tasks on ModelArts.

ModelArts allows you to quickly configure and create agencies on the Permission Management page. This enables ModelArts to manage service-to-service permissions on your behalf.

Constraints

• Huawei Cloud account
  • Only a Huawei Cloud account can use an agency to authorize the current account or all IAM users under the current account.
  • Multiple IAM users or accounts can use the same agency.
  • A maximum of 100 agencies can be created under an account.
  • If you use ModelArts for the first time, add an agency. Generally, common user permissions are sufficient for your requirements. You can configure permissions for refined permissions management. On the new ModelArts console, new users can configure ModelArts agency authorization for their accounts in one-click mode.
• IAM user
  • If you have obtained the authorization, you can view the authorization information on the Permission Management page.
  • If you have not been authorized, ModelArts will display a message indicating that you have not been authorized when you access the Add Authorization page. In this case, contact your administrator to add authorization.
  • An IAM user with the admin permission can configure ModelArts authorization for itself or other IAM users.

One-Click Authorization

When you use ModelArts for the first time with a Huawei Cloud account or an IAM admin user, a cross-service authorization page appears on the new ModelArts console. Click the authorize button to set up ModelArts authorization quickly.

One-click authorization is only supported on the new ModelArts console in the following regions:

ME-Riyadh

Configuring Agency Authorization

If you are not using the ModelArts new console for the first time or you are using the ModelArts old console, you can configure agency authorization on the Permission Management page.

1. Log in to the ModelArts console. In the navigation pane on the left, choose System Management > Permission Management.
2. Click Add Authorization. On the displayed page, set parameters.

   Table 1 Parameters

   Parameter	Description
   Authorized User	The options are IAM user, Federated user, Agency, and All users. IAM user: You can use a tenant account to create IAM users and assign permissions for specific resources. Each IAM user has their own identity credentials (password and access keys) and uses cloud resources based on assigned permissions. For details about IAM users, see IAM User. Federated user: A federated user is also called a virtual enterprise user. For details about federated users, see Configuring Federated Identity Authentication. Agency: You can create agencies in IAM. For details about how to create an agency, see Creating an Agency. All users: If you select this option, the agency permissions will be granted to all IAM users under the account, including those created in the future. For individual users, choose All users. When an IAM user gets agency authorization, the order of priority is: IAM user-specific, then all-user. For federated users, the order is: federated user-specific, federated user group-specific, then all-user. Higher-priority authorizations override lower ones.
   Authorized To	This parameter is not displayed when Authorized User is set to All users. IAM user: Select an IAM user and configure an agency for the IAM user. Figure 1 Selecting an IAM user Federated user: The authorized object can be a federated user or user group. Enter the username or user ID of the federated user. Figure 2 Selecting a federated user or user group ModelArts only supports federated users of the virtual user SSO type. This restriction also applies to federated user groups. Permissions granted to a federated user group take effect only for AI jobs. To manage resource pools, the resource administrator must log in to the console using IAM. Add a federated user to only one user group to use the authorization feature. Adding a federated user to multiple groups can cause random authorization effects. When a federated user switches to a new user group, their permissions on ModelArts match those of the new group. After changing user groups for a notebook instance, restart the instance to access or edit notebook instances from the old group. Agency: Select an agency name. You can create an agency under account A and grant the agency permissions to account B. When using account B, you can switch the role in the upper right corner of the console to account A and use the agency permissions of account A. Figure 3 Switch Role
   Agency	Use existing: If there are agencies in the list, select an available one to authorize the selected user. Click the drop-down arrow next to the agency name to view its permission details. Add agency: If there is no available agency, create one. If you use ModelArts for the first time, select Add agency.
   Add agency > Agency Name	ModelArts automatically creates an agency name for you, but it is editable.
   Add agency > Permissions > Common	In common mode, users can customize the authorization scope based on service scenarios and grant only the minimum required access. This mode is flexible and secure. This mode applies to scenarios with refined management requirements on the authorization scope. You can select the required permission from the list. The common mode provides preset permissions templates that allow for quick configuration of permissions. For example, when selecting the permission template for the training module, the system automatically chooses all necessary service and function permissions.

3. Click Create, enter YES as prompted, and click OK.

   A message will then appear confirming that the agency has been created.

Viewing Authorized Permissions

You can view the configured authorizations on the Permission Management page. Locate an authorization and click View Permissions in the Operation column to view the permission details.

Figure 4 Viewing permissions

Modifying the Authorization Scope

1. To modify the authorization scope, click View all permissions at the bottom of the View Permissions dialog box.
   Figure 5 Modifying permissions in IAM
   

2. On the Agencies page of the IAM console, locate the target agency and click Modify in the Operation column to modify the agency information in the Basic Information tab. Select your required validity period.
   Figure 6 Agency information
   
3. On the Permissions page, click Authorize, select policies or roles, and click Next. Select the scope for minimum authorization and click OK.

   When setting the minimum authorization scope, you can select specified projects or all resources. If you select All resources, the selected permissions will be applied to all resources.

Deleting an Authorization

To better manage your authorization, you can delete the authorization of an IAM user or delete the authorizations of all users in batches.

• Deleting an authorization of a user

  The authorizations configured for the IAM user of the current account are displayed on the Permission Management page. You can locate an authorization, click Delete in the Operation column, enter DELETE in the text box, and click OK. After it is deleted, the user cannot use ModelArts functions.

• Batch deleting authorizations

  On the Permission Management page, click Clear Authorization above the authorization list. Enter DELETE in the text box and click OK. After the deletion, the account and all its IAM users cannot use ModelArts functions.

FAQs

1. How do I configure authorization when I use ModelArts for the first time?

   When you use ModelArts for the first time with a tenant account (administrator) or an IAM admin user, a cross-service authorization page appears on the new ModelArts console. Click the authorize button to set up ModelArts authorization quickly. For IAM users, permissions must be configured by an administrator. For details, see Creating an IAM User and Granting ModelArts Permissions. When the tenant account (administrator) or an IAM user with the admin permission accesses the ModelArts console of the old version, follow the instructions in Configuring Agency Authorization.

2. How do I delete an existing agency from the agency list?
   Figure 7 Use existing
   

   Go to the IAM console, choose Agencies in the navigation pane, and delete the target agency.

   Figure 8 Identity and Access Management
   

3. Why is a message indicating insufficient permissions displayed when I access a page on the ModelArts console?

   The permissions configured for the user agency are insufficient or the module has been upgraded. The authorization information needs to be updated. In this case, you can add authorization as prompted.