Connect an Alibaba Cloud Organization
Connect your Alibaba Cloud organization to automatically onboard all current and future accounts, without adding them individually.
Prerequisites
Before you begin:
- Grant sufficient permissions to the Alibaba Cloud account that will query the Resource Manager directory, create and manage ROS stacks and stack groups, create RAM roles, users, policies, and policy attachments, and generate RAM access keys across member accounts.
- Install and configure the Aliyun CLI with valid credentials before running the ROS deployment script.
-
Terraform-specific:
- Ensure you have Terraform CLI v0.13+ installed.
- Ensure terraform init can download and install Alibaba Cloud provider v1.252+ without conflicting with your existing configurations.
- Ensure Terraform is run where the access-key file can be handled securely.
Connect an Alibaba Cloud Organization
To connect an Alibaba Cloud organization:
- In the Tenable One Cloud Exposure Console, navigate to Settings > Integrations and click + Add Integration.
- In the Integrations Library, click Alibaba Cloud Organization. The Alibaba Cloud Organization wizard opens.
-
In the Configuration step (step 1 of 2):
- Enter a name for the integration.
-
Select the Alibaba Cloud environment type that matches your organization.
- Aliyun — Accounts in Alibaba Cloud China regions.
- International — Accounts in Alibaba Cloud international regions.
Under Capabilities, select the capabilities to enable. Your selection determines the required permissions and dynamically updates the deployment script. For more information, see Alibaba Cloud Required Permissions.
Note: Tenable recommends enabling all available capabilities to provide the most comprehensive security coverage. Enabling them now ensures the deployment script grants the required permissions from the start. If you enable them later, you will need to redeploy the script to update the permissions granted to Tenable.- Monitoring (read-only) — Selected by default. Gain full visibility for all cloud assets, including information about permissions, compartment usage, data and security configurations.
- Data Resources Scanning (Data Protection) — Scan and classify cloud resources.
- Workload Protection — Scan virtual machine instances and container image registries for vulnerabilities and misconfigurations.
Under Deployment, select one of the following deployment options:
- ROS. Script-based deployment. Run the script displayed in the wizard in your Alibaba Cloud environment using the Aliyun CLI. Learn more
- Terraform. Module-based deployment. See Prerequisites before deploying.
- Copy the first invocation displayed in the Cloud Exposure wizard, add it to your Terraform configuration, and then run terraform apply. The module creates the RAM user and access key.
- Retrieve the user ARN from the Terraform output and enter it in the User ARN field.
- Copy the second invocation displayed in the Cloud Exposure wizard, add it to your Terraform member account configurations, and then run terraform apply. The module creates the RAM role and grants Tenable the permissions to connect and scan the environment.
- Manual. Manually, via the Alibaba Cloud RAM console. See Manually Deploy an Alibaba Cloud Organization for step-by-step instructions.
Note: When you enable Workload Protection, the ROS script and the Terraform module also create the AliyunECSDiskEncryptDefaultRole and AliyunECSShareEncryptSnapshotDefaultRole roles in all the accounts in your organization to scan encrypted disks. If either role already exists in any of these account, the deployment fails for those accounts. To use these existing roles, see If a Role Already Exists. For manual deployment, you create these roles yourself. See Create Roles for Encrypted Disk Scanning.Caution: When you finish manual deployment, return to the wizard to complete Post Deployment and Step 2: Scopes.Under Post Deployment, enter the following values.
Note: Keep the following in mind about the integration values:- How to retrieve values
- ROS: Copy the values from the script output after the stack creation completes.
- Terraform: Retrieve the values from the Terraform outputs.
- Manual: See Manually Deploy an Alibaba Cloud Organization for how to retrieve these values.
- Shared integration values
- These values must be identical across the organization and all its member accounts.
- When an organization is connected, these fields can only be updated at the organization level. Changes automatically propagate to all member accounts.
- Main Account Role ARN — The ARN of the RAM role created in your management account.
- Access Key ID — The ID of the access key created for the Tenable RAM user. For Terraform, retrieve the ID from the access-key file saved by Terraform.
- Access Key Secret — The secret of the access key created for the Tenable RAM user. For Terraform, retrieve the secret from the access-key file saved by Terraform.
- How to retrieve values
- When finished, click Next.
-
In the Scopes step (step 2 of 2):
- (Optional) Select Automatically update compartments structure to mirror your compartment's structure as folders within Tenable, preserving the hierarchy and keeping the view synchronized. For more information, see Account Hierarchy and Folders.
- Under Scopes, choose which compartments to onboard:
- Sync all current and future accounts (recommended)
- Include specific folders and accounts
- Exclude specific folders and accounts
Note: If you include or exclude an entire folder, all current and future accounts within that folder are included or excluded. If you include or exclude specific accounts in a folder, only the selected accounts are included or excluded. - Click Finish.
Next steps:
After your organization is connected successfully:
- You can see the organization in Settings > Integrations.
- You can see accounts that belong to the organization in Settings > Organization > Accounts > Alibaba Cloud. From here, you can manage your accounts and view account details to see, for example, which features are enabled and whether the required permissions were granted.
Data about account resources will start to appear in Cloud Exposure. The time it takes for all data to appear varies depending on the size of your cloud environment.
Manually Deploy an Alibaba Cloud Organization
As an alternative to the ROS script, you can manually deploy your Alibaba Cloud organization via the Alibaba Cloud RAM console. These procedures apply if you selected Manual for the deployment type when connecting your Alibaba Cloud organization.
- Create a RAM User and Access Key
- Create a RAM Role for Tenable
- Create Custom Policies
- Assign Policies
- Set Up Roles in Member Accounts
- Create Roles for Encrypted Disk Scanning (if you enabled Workload Protection)
Create a RAM User and Access Key
Create a dedicated RAM user and generate the access key that Tenable uses to authenticate. Complete this step first. You will need the user ARN when creating the RAM role.
- In the RAM console, navigate to Identities > Users.
- Click Create User.
- For User Login Name, enter tenable-user.
- In the Access Configuration section, select Permanent AccessKey.
- Confirm that it is necessary to create an AccessKey.
- Click OK.
- Copy and save the AccessKey ID and AccessKey Secret shown on the confirmation page. The secret cannot be retrieved later. You will enter both values in the Tenable wizard's Post Deployment section.
- On the Users page, click tenable-user to open its details.
- Select the Permissions tab and click Grant Permission.
- For Resource Scope, select Account.
- Select the AliyunSTSAssumeRoleAccess policy, and then click OK.
Create a RAM Role for Tenable
Create a dedicated RAM role that Tenable uses to access and monitor your organization. The role's trust policy grants tenable-user permission to assume it.
- In the RAM console, navigate to Identities > Roles.
- Click Create Role.
- For Principal Type, select Cloud Account.
- Click Switch to Policy Editor.
- Under Cloud Account, click Edit.
- For Identity Type, select RAM user.
- For User Name, enter tenable-user.
- Click OK.
- For Action, select sts:AssumeRole.
- Click OK.
- For Role Name, enter tenable-role and click OK.
- On the Roles page, click tenable-role to open its details.
- Copy and save the ARN. You will enter this value in the Tenable wizard's Post Deployment section as the Main Account Role ARN.
Create Custom Policies
Create a custom RAM policy for each capability you selected in the wizard. For the full list of required permissions by capability, see Alibaba Cloud Required Permissions.
- In the RAM console, navigate to Permissions > Policies.
- Click Create Policy, and then select JSON Editor.
- Paste the policy from Alibaba Cloud Required Permissions in the JSON editor to create the Monitoring (read-only) policy.
- Click OK.
- For Policy Name, enter tenable-monitoring-policy and click OK.
-
(Optional) Return to the Policies page to create the Workload protection policy.
- Paste the policy from Alibaba Cloud Required Permissions in the JSON editor.
- Click OK.
- For Policy Name, enter tenable-workload-policy and click OK.
-
(Optional) Return to the Policies page to create the Data Resources Scanning (Data Protection) policy.
- Paste the policy from Alibaba Cloud Required Permissions in the JSON editor.
- Click OK.
- For Policy Name, enter tenable-data-scanning-policy and click OK.
Assign Policies
Assign the policies you created to tenable-role.
- In the RAM console, navigate to Identities > Roles.
- Open tenable-role and click Grant Permission.
- In the Policy section, select the policies you created earlier.
- Click OK and then Close.
Set Up Roles in Member Accounts
The steps above provision tenable-role and tenable-user in your management account only. To give Cloud Exposure visibility into member accounts, you must replicate tenable-role in each member account and grant it the same policies.
For each member account:
- Open the RAM console and log in to the member account.
- Repeat the Create Custom Policies steps to create the same policies in that account.
- Repeat the Create a RAM Role for Tenable steps to create the Tenable role. When editing Cloud Account, select Other Account and enter the account ID of the management account. Enter tenable-user for User Name.
- Repeat the Assign Policies steps to assign the same policies to the member account's tenable-role.
Create Roles for Encrypted Disk Scanning
If you enabled Workload Protection, create the two RAM roles that Tenable uses to scan disks in each account in your organization, and then attach the encrypted disk KMS policy to both. Alibaba Cloud looks for these roles by name, so enter the names exactly as shown.
Complete the following procedures in each account in your organization.
To create the encrypted disk KMS policy:
- Open the RAM console and log in to the account.
- Navigate to Permissions > Policies.
- Click Create Policy, and then select JSON Editor.
- Paste the Encrypted Disk KMS Policy in the JSON editor.
- Replace <AccountId> with the ID of the account, and replace <OutpostAccountId> with the value of the OutpostAccountId parameter in the deployment script displayed in the wizard.
- Click OK.
- For Policy Name, enter tenable-virtual-machine-scanning-encrypted-disk and click OK.
To create the roles:
Complete the following steps once for each role. Use the trust policy that matches the role from Trust Policies:
- AliyunECSDiskEncryptDefaultRole — Use the trust policy for AliyunECSDiskEncryptDefaultRole.
- AliyunECSShareEncryptSnapshotDefaultRole — Use the trust policy for AliyunECSShareEncryptSnapshotDefaultRole. Replace <OutpostAccountId> with the same value you used in the KMS policy.
- In the RAM console, navigate to Identities > Roles.
- Click Create Role.
- Click Switch to Policy Editor.
- Paste the trust policy in the JSON editor, and then click OK.
- For Role Name, enter the role name and click OK.
- On the Roles page, click the role to open its details.
- On the Permissions tab, click Grant Permission.
- For Resource Scope, select Account.
- Select the tenable-virtual-machine-scanning-encrypted-disk policy, and then click OK.
- Click Close.