Skip to main content
With the AWS service account integration, you can update existing Permission and Region Stacks to ensure your Plerion CWPP appliances continue to operate securely and efficiently across regions. A service account stack may require updates over time due to changes in permissions, AWS regional support, or infrastructure improvements.
There are two types of stacks that may need updates:
  • Permission Stack: Grants Plerion access to the service account through IAM roles and policies.
  • Region Stacks: Provisions the infrastructure required to run Plerion Service Account Appliances, including VPCs, subnets, security groups, and auto-scaling resources.

Steps to update a service account stack

1

On the Plerion dashboard, go to Settings > Integrations

Sidebar navigation with Settings expanded and Integrations highlighted
2

Find AWS workload service account and click the + button

Integrations page with AWS service account account option and plus button to add integration
3

Choose the service account to update

4

Select the stack to update

  • For Permission Stack, go to the Settings tab.
  • For Region Stacks, go to the Regions tab.
5

Click Launch Stack or follow CLI commands

Click Launch Stack to update the stack using the AWS Console, or follow the CLI instructions provided on-screen to perform the update manually.

Moving a region stack off the NAT gateway

From template version v1.5.0, a Region Stack can run appliances in a public subnet with no NAT gateway. To switch, update the stack and set ApplianceNetwork to PublicSubnet. An update from the AWS console keeps the value the stack already has. The CLI update command sets every parameter it does not name back to its default, so for a stack on PublicSubnet add ParameterKey=ApplianceNetwork,UsePreviousValue=true to it. Make the switch when no scan is running in that region. An appliance that is scanning during the update stays in the private subnet with no internet access. The asset it was scanning is retried later, after about 30 minutes for a Lambda function and about 6 hours for an EC2 instance, and the appliance shuts itself down within 24 hours. To clear it sooner, terminate any Plerion appliance left in the private subnet after the update. See Appliance network.

Updating a stack created before the registration change

Stacks created before Plerion removed the AuthToken parameter registered through a Lambda function in your account that called the Plerion API. The current templates register through a custom resource that reports to Plerion’s registration topic instead, so no token is needed. Updating an older stack to the current template is a normal stack update, with two things to know:
  • The Region Stack asks for TenantId once, on that first update. Copy it from the region’s update guide in Plerion.
  • The Permission Stack needs no new input. TenantId is optional on this stack, so it can stay blank.
The update removes the Lambda function and its role from your account and replaces them with the PlerionRegistration resource. Updating from the AWS console drops the removed AuthToken parameter automatically. If you update with a script that still passes ParameterKey=AuthToken,UsePreviousValue=true, the update fails with Parameters: [AuthToken] do not exist in the template. Remove that line from the command.
Service account stacks are not updated automatically. An older stack keeps working until you update it.

Why an update can roll back

Older stacks reported success to CloudFormation even when Plerion rejected the registration, so a failed update left a stale record behind. The current templates fail the update instead, and CloudFormation rolls the stack back. An update rolls back when:
  • The ExternalId parameter no longer matches the one Plerion holds for your tenant.
  • The stack was changed so that the role or network it reports is no longer part of that stack.
  • Another stack in the same account registered the service account or region. Only that stack can change it until it is deleted.
  • For a Region Stack update, the service account no longer exists in Plerion. Update the Permission Stack first to register the service account again.