Skip to main content

Capabilities

Gather Alibaba Cloud credentials

The Alibaba Cloud connector is read-only. It syncs users, groups, roles and policies, along with group memberships, who can assume each role, and who each policy is attached to. It cannot change access in Alibaba Cloud.
1
Create or select an Alibaba Cloud RAM user for the connector. Do not use Alibaba Cloud account root AccessKeys.
2
Attach the Alibaba-managed AliyunRAMReadOnlyAccess policy, or attach a custom read-only policy that allows ram:GetAccountAlias, ram:ListUsers, ram:GetUser, ram:ListGroups, ram:ListUsersForGroup, ram:ListRoles, ram:GetRole, ram:ListPolicies, and ram:ListEntitiesForPolicy.
3
Create an AccessKey pair for that RAM user.
4
Copy the AccessKey ID.
5
Copy the AccessKey Secret.

Configuration fields

Synced resource types

  • Account: account alias from RAM GetAccountAlias.
  • Users: active and frozen users from IMS ListUsers.
  • Groups: groups from IMS ListGroups.
  • Group membership grants: group members from IMS ListUsersForGroup.
  • Roles: roles from RAM ListRoles, with each role’s trust policy document from RAM GetRole in the role profile.
  • Role trust grants: the users, roles, and account allowed to assume each role by its trust policy, from RAM GetRole.
  • Policies: system and custom policies from RAM ListPolicies.
  • Policy attachment grants: the users, groups, and roles each policy is attached to, from RAM ListEntitiesForPolicy.

Special notes

  • Authentication uses Alibaba Cloud ACS3-HMAC-SHA256 request signing.
  • Use one connector instance per Alibaba Cloud account.
  • Group membership, role trust and policy attachment are the access this connector syncs. Accounts and users carry no entitlements of their own.
  • Each role has a trusted entitlement, granted to the RAM users and roles in the same account that its trust policy allows to assume it. A trust policy that allows the whole account (acs:ram::<account-id>:root) is granted to the Account resource. Principals from other accounts, cloud services, and identity providers are not synced as grants.
  • The trusted entitlement reflects the role’s trust policy only. To actually assume a role, the RAM user or role also needs sts:AssumeRole permission, for example through the AliyunSTSAssumeRoleAccess policy. Trust policy conditions are not evaluated.
  • Each policy that is attached to at least one user, group, or role has an attached entitlement. Policies that are not attached to anything do not show an entitlement, so if a policy is detached from everyone, its entitlement disappears from C1 on the next sync and returns once the policy is attached again.
  • When a policy is attached to a group, every member of that group is shown as having the policy. When it is attached to a role, only the role is shown as having the policy. Users and roles that can assume the role are not shown as having it, because the connector does not check their sts:AssumeRole permission. See the role’s trusted entitlement for who its trust policy allows.
  • Only policies attached at the account level are synced. Policies attached to a specific resource group are not shown.
  • If the connector’s credential is missing ram:ListEntitiesForPolicy, the sync still succeeds, but no policy shows who it is attached to. Add the permission, or use AliyunRAMReadOnlyAccess, to sync policy attachments.
  • The connector keeps Alibaba RAM and IMS metadata snapshots in the repo for local validation.

Configure the Alibaba Cloud connector

Follow these instructions to use a built-in, no-code connector hosted by C1.
1
In C1, navigate to Apps > Connectors and click Add connector.
2
Search for Alibaba Cloud and click Add.
3
Choose where to add the connector: Create a new app, or Add to an existing app (then select the app).If you’re creating a new app, choose whether to link it to an application discovered from your identity provider: select Yes and pick the IdP application, or No to continue with just the connector.
4
Set the connector’s Name and, optionally, a Description.
5
Click the pencil icon next to Owners to choose who can configure and manage this connector.
6
Click Add. The connector is created and its configuration page opens.
7
Find the Settings area of the page and click Edit.
8
Paste the Alibaba Cloud credentials into the relevant fields:
  • AccessKey ID: The RAM identity AccessKey ID.
  • AccessKey Secret: The paired AccessKey Secret.
9
Click Save.
10
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
Done. Your Alibaba Cloud connector is now pulling access data into C1.