After creating the service account, you have the option to link it with your target accounts, specifically AWS account integrations. You can accomplish this either during the creation of a new target account or by modifying an existing one.

​
Creating a new target account

​
Onboarding Multiple AWS Account Integrations

To onboard multiple AWS account integrations, follow the steps below:
  1. Go to the Settings ➤ Integrations section and click the + button within the AWS Account widget.
Inbound
  1. Choose Multiple AWS Accounts as the Deployment Strategy.
  2. By default, the Cloud Security Posture Management (CSPM) and Cloud Infrastructure Entitlement Management (CIEM) capabilities are selected. Additionally, select Cloud Workload Protection Platform (CWPP).
  3. Under the CWPP deployment strategy, select the Service account and choose the service account you previously created.
Select Capabilities
  1. Users have the option to onboard the accounts using the AWS Console or the CLI. Select the appropriate tab accordingly.
Add AWS Account - Create StackSet
  1. Ensure that you use the ServiceAccountId from the section below.
Select Capabilities
  1. Follow the instructions provided on the platform to onboard the accounts within your AWS organization.
  2. If some accounts in the management account have already been added and there are more to be added, select the Update Existing StackSet tab and follow the instructions.
Add AWS Account - Update StackSet
  1. Once the StackSet instance is completed, all the AWS account integrations created will be linked to the service account.

​
Onboarding Single AWS Account Integration

  1. On the Plerion Dashboard, click on Settings and click on Integrations
Tenant Settings
  1. Click on the Inbound tab and click the + button
Inbound
  1. By default, select the Cloud Security Posture Management (CSPM) and Cloud Infrastructure Entitlement Management (CIEM) capabilities. Additionally, select Cloud Workload Protection Platform (CWPP).
  2. Under the CWPP deployment strategy, select Service account and choose the service account you created in the previous step.
Select Capabilities
  1. Click on Next.
  2. Ensure that you have already signed in to your target AWS Account Management Console. Then, click Launch Stack.
Create Stack
  1. Make sure the service account parameter is present in the Stack Parameters. After confirming, click Create Stack.
Select Capabilities
  1. Once the stack is created, the AWS account integration will be created with the service account linked to it.

​
Updating an Existing Target Account

When editing an existing target account, you have the option to select the service account you wish to use for that particular target account.

​
Updating Multiple AWS Account Integration

  1. Go to Settings - Integrations and click the ’+’ button on the AWS Account widget. Choose Add accounts using Multi-Account Onboarding.
Add AWS Account
  1. By default, select the Cloud Security Posture Management (CSPM) and Cloud Infrastructure Entitlement Management (CIEM) capabilities. Additionally, select Cloud Workload Protection Platform (CWPP).
  2. Under the CWPP deployment strategy, select Service account and choose the service account you created in the previous step. Click on Next.
Select Capabilities
  1. Select the Update Existing StackSet tab and follow the provided instructions.
Select Update Guide
  1. Ensure that you use the ServiceAccountId from the section below.
Select Capabilities
  1. Follow the instructions on the platform to update the accounts within your AWS organization.
  2. Once the StackSet instance is completed, all existing AWS account integrations and new ones will be linked to the service account.

​
Updating Single AWS Account Integration

  1. Go to Settings - Integration and navigate to the AWS Account integration.
  2. Click the ‘Edit’ icon next to the Role ARN or capabilities.
  3. To link the service account to an existing integration, enable the Cloud Workload Protection Platform (CWPP) capability and choose Service account under the deployment strategy. Select the service account you created in the previous step.
Select Capabilities single
  1. To update the Plerion template for an existing integration, modify the stack parameters as shown in the above image.
  2. AWS Account integrations can be updated in ‘Automated’ mode, which is recommended by Plerion. Users can choose to update their existing stack using the AWS Console or AWS CLI, following the provided instructions.
  3. Once the stack is updated, the AWS account integration will be updated with the service account linked to it.

​
Verifying the Service Account is Linked to the Target Account

After linking the service account to the target account, you can verify it by going to the AWS Account integration in Settings - Integrations.
Verify
The scans will start appearing in the CWPP Asset Scans section.
Verify

​
Resources Created

  1. A new IAM role is created in the target account with the name PlerionApplianceRole. The role is passed to the Plerion appliances running in the target account to perform the scans.

​
Limitations

  1. The service account can only be linked to a target account that is part of the same AWS organization.