> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating an AWS account

> Update an onboarded AWS account to apply new permissions, enable CWPP, or refresh integration resources.

Updating an AWS account keeps Plerion’s permissions up to date, ensuring the platform can continue scanning your cloud environments and reporting accurate findings.

You should update an account if:

* **Template update required**: The Plerion CloudFormation template has been updated with new permissions. This is flagged by the **PLERION-PLN-02** detection. If this finding fails, update the account.
  <Frame>
    <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/plerion-detection-pln-2.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=8f291783526b1299ac14019549905375" alt="PLN-2 detection in Plerion Findings dashboard" width="2702" height="736" data-path="images/integrations/aws/plerion-detection-pln-2.png" />
  </Frame>

* **Enable or disable CWPP**: Add or remove the Cloud Workload Protection Platform (CWPP) capability for an existing account.

***

## Steps to update a single AWS account

### Automated mode (recommended)

If you onboarded your AWS account using the **Automated mode**, you can update the CloudFormation stack in one of three ways:

* **Update existing stack using the AWS Console**
* **Update existing stack using the CLI**
* **Create a new stack**

#### Update existing stack using the AWS Console

<Steps>
  <Step title="Open the AWS account you want to update">
    * On the Plerion dashboard, go to `Settings` > `Integrations`, and find the AWS account you want to update
    * Click the edit icon next to **Role ARN**

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/aws-integration-edit-role-arn.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=93681a6d5e3289df29040ad26adad40e" alt="Integrated AWS account with Role ARN highlighted" width="2240" height="1412" data-path="images/integrations/aws/aws-integration-edit-role-arn.png" />
    </Frame>
  </Step>

  <Step title="On the Update Existing Stack (Console) tab, click Launch stack">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/edit-aws-integration-update-existing-stack-console.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=363786d0f1a00cf4ce1cbc4b86c9274d" alt="Updating the existing stack using the AWS console" width="2528" height="1530" data-path="images/integrations/aws/edit-aws-integration-update-existing-stack-console.png" />
    </Frame>
  </Step>

  <Step title="On the Specify stack details page in AWS, open Configure stack options" />

  <Step title="Copy the AuthToken from Plerion to AWS">
    Copy the `AuthToken` value from Plerion’s **Stack Parameters** box into the matching field in AWS.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/stack-parameters-box.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=8a14a0710c2d06dd24e8ec8257acb024" alt="Stack Parameters box with AuthToken value" width="811" height="514" data-path="images/integrations/aws/stack-parameters-box.png" />
    </Frame>

    <br />

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/single-automated-specify-stack-details.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=3c18ae4f25b6fdb271e849fb37cd38be" alt="Specify stack details page in AWS with AuthToken parameter" width="1193" height="1002" data-path="images/integrations/aws/single-automated-specify-stack-details.png" />
    </Frame>
  </Step>

  <Step title="Select the CWPP capability (optional)">
    To enable workload protection, select **CWPP** before continuing.

    <Tip>
      Select **CWPP** if you want to scan workloads such as EC2, Lambda, or ECS.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/add-cwpp-capability.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=e51c38b3338003a1a99a68aea914f925" alt="CWPP capability checkbox selected" width="2039" height="553" data-path="images/integrations/aws/add-cwpp-capability.png" />
    </Frame>
  </Step>

  <Step title="Review and confirm capabilities">
    On the **Review** page, tick the required **Capabilities** box.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/cloudformation-allow-required-capabilities.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=fc64f82a8334057d4f071c1e19408dab" alt="CloudFormation Review page with required Capabilities box ticked" width="897" height="348" data-path="images/integrations/aws/cloudformation-allow-required-capabilities.png" />
    </Frame>
  </Step>

  <Step title="Submit the stack update">
    * In AWS, click `Update stack` to apply the changes.
    * Plerion will automatically detect the updated resources and refresh the integration when the update completes.
  </Step>
</Steps>

***

#### Update existing stack using the CLI

<Steps>
  <Step title="Open the AWS account you want to update">
    * On the Plerion dashboard, go to `Settings` > `Integrations`, and find the AWS account you want to update
    * Click the edit icon next to **Role ARN**

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/aws-integration-edit-role-arn.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=93681a6d5e3289df29040ad26adad40e" alt="Integrated AWS account with Role ARN highlighted" width="2240" height="1412" data-path="images/integrations/aws/aws-integration-edit-role-arn.png" />
    </Frame>
  </Step>

  <Step title="On the Update Existing Stack (CLI) tab, copy the CLI command">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/edit-aws-integration-update-existing-stack-cli.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=b1ba3d662e63c1accbfb82679dcce29b" alt="Updating the existing stack using the CLI command" width="1908" height="1068" data-path="images/integrations/aws/edit-aws-integration-update-existing-stack-cli.png" />
    </Frame>
  </Step>

  <Step title="Insert stack parameters">
    Copy all values from Plerion’s **Stack Parameters** box into the CLI command.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/stack-parameters-box.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=8a14a0710c2d06dd24e8ec8257acb024" alt="Stack Parameters box with values for CLI update" width="811" height="514" data-path="images/integrations/aws/stack-parameters-box.png" />
    </Frame>
  </Step>

  <Step title="Run the CLI command">
    * Execute the command in your terminal.
    * Plerion will automatically detect the updated resources once the update completes.
  </Step>
</Steps>

***

#### Create a new stack

<Steps>
  <Step title="Open the AWS account you want to update">
    * On the Plerion dashboard, go to `Settings` > `Integrations`, and find the AWS account you want to update
    * Click the edit icon next to **Role ARN**

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/aws-integration-edit-role-arn.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=93681a6d5e3289df29040ad26adad40e" alt="Integrated AWS account with Role ARN highlighted" width="2240" height="1412" data-path="images/integrations/aws/aws-integration-edit-role-arn.png" />
    </Frame>
  </Step>

  <Step title="On the Create a New Stack tab, click `Launch stack`">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/edit-aws-integration-create-new-stack.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=2314535832ac8835aa1e224efb8423b6" alt="Launching a new stack in AWS" width="2522" height="1458" data-path="images/integrations/aws/edit-aws-integration-create-new-stack.png" />
    </Frame>
  </Step>

  <Step title="Deploy the stack in AWS">
    Follow the on-screen instructions in AWS to create the new stack.
  </Step>

  <Step title="Verify the update in Plerion">
    After deployment, Plerion will detect the new resources and refresh the integration.
  </Step>
</Steps>

***

### Manual mode

If you onboarded your AWS account using **Manual mode**, update the IAM role directly.

<Steps>
  <Step title="Edit the IAM role in AWS">
    In your AWS account, open the IAM role used by Plerion and edit its configuration.
  </Step>

  <Step title="Apply the updated policy">
    Replace the trust policy or permissions JSON with the updated values shown in Plerion.
  </Step>

  <Step title="Validate the integration in Plerion">
    Save your changes in AWS, then return to Plerion and click `Update` to validate the integration.
  </Step>
</Steps>

***

## Steps for updating multiple AWS accounts

<Warning>
  You can only update multiple accounts from the **management account** integration.
</Warning>

<Steps>
  <Step title="Open the AWS management account you want to update">
    * On the Plerion dashboard, go to `Settings` > `Integrations`, and find the AWS management account you want to update
    * Click the edit icon next to **Role ARN**
  </Step>

  <Step title="Select Multi Account Onboarding">
    * On the **Edit integration** page, click `Update using Multi Account Onboarding`.
    * On the **Select capabilities** screen, click `Next`.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/update-using-multi-account-onboarding.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=6633aee62206e6e702a72c18ccbee692" alt="Update using Multi Account Onboarding option" width="2578" height="1306" data-path="images/integrations/aws/update-using-multi-account-onboarding.png" />
    </Frame>
  </Step>

  <Step title="Click the Update Existing StackSet tab">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/update-existing-stack-set-tab.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=ed50444e674bcab39f621660f9943fa4" alt="Update Existing StackSet tab selected in AWS console" width="1182" height="1144" data-path="images/integrations/aws/update-existing-stack-set-tab.png" />
    </Frame>
  </Step>

  <Step title="Copy the AuthToken to AWS">
    Copy the `AuthToken` value from Plerion’s **Stack Parameters** box into the matching field in AWS.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/stack-parameters-box.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=8a14a0710c2d06dd24e8ec8257acb024" alt="Stack Parameters box with AuthToken value" width="811" height="514" data-path="images/integrations/aws/stack-parameters-box.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/single-automated-specify-stack-details.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=3c18ae4f25b6fdb271e849fb37cd38be" alt="Specify stack details page with AuthToken field populated" width="1193" height="1002" data-path="images/integrations/aws/single-automated-specify-stack-details.png" />
    </Frame>
  </Step>

  <Step title="Set deployment options">
    On the **Set deployment options** page in AWS, set **Automatic deployment** to `Deactivated`.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/deactivate-automatic-deployment.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=624cf935179a867e182abd3b1da705c6" alt="Automatic deployment option set to Deactivated" width="1724" height="1344" data-path="images/integrations/aws/deactivate-automatic-deployment.png" />
    </Frame>
  </Step>

  <Step title="Review and submit the update">
    * On the **Review** page in CloudFormation, tick the required **Capabilities** box, then click `Submit`.
    * Plerion will automatically detect the updated StackSet resources once the update completes.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/xqwXbDdIvpJS066S/images/integrations/aws/cloudformation-allow-required-capabilities.png?fit=max&auto=format&n=xqwXbDdIvpJS066S&q=85&s=fc64f82a8334057d4f071c1e19408dab" alt="CloudFormation Review page with required Capabilities box ticked" width="897" height="348" data-path="images/integrations/aws/cloudformation-allow-required-capabilities.png" />
    </Frame>
  </Step>
</Steps>
