Articles in this section

Initial Setup of AWS GovCloud Integration

AWS GovCloud (US-East and US-West) are isolated regions within AWS for customers to host sensitive data for supporting their regulated workflows. The configuration workflow described below differs from AWS standard regions and is relevant for monitoring only AWS GovCloud environments within the Lacework application.

The initial setup of creating an integration between Lacework and an AWS GovCloud requires running steps in the AWS GovCloud console followed by running a second set of steps in the Lacework Console, as described below.

The steps below configure either an AWS CloudTrail (US GovCloud) or an AWS Config (US GovCloud) integration.

  • Configure an AWS CloudTrail (US GovCloud) integration to analyze CloudTrail activity for monitoring cloud account security.
  • Configure an AWS Config (US GovCloud) integration to analyze AWS configuration compliance.

If you want to analyze AWS configuration compliance and account security (CloudTrail), you must configure AWS CloudTrail (US GovCloud) and AWS Config (US GovCloud) integrations.

Create the Lacework AWS GovCloud CloudFormation Template

You must create an AWS GovCloud CloudFormation template file that creates a new AWS GovCloud CloudFormation stack.

To download and customize the template file:

  1. Open a text editor.

  2. Click the following link: https://raw.githubusercontent.com/lacework/csp-integrations/master/aws-govcloud-template/lacework-aws-gov-cloud-ct-cfg.json
    The Lacework AWS GovCloud CloudFormation template file displays in GitHub.

  3. Select all text in the GitHub window of the browser. (In Chrome, select Edit > Select All.)

  4. Copy the text. (In Chrome, select Edit > Copy.)
  5. Paste the text into the text editor.
  6. In the text editor, replace the %acnt string with the name of your AWS account. 
      "Parameters": {
      "ResourceNamePrefix":
      {
          ...
          "Default": "%acnt",
          ...
      },
  7. Save the file as lacework-aws-gov-cloud-ct-cfg.json in the text editor.

Create a Stack in CloudFormation Using the Customized CloudFormation Template

To create a new stack in the AWS GovCloud:

  1. Log in to an AWS account on the AWS GovCloud with administrative credentials. The AWS account used to create the stack must use a role with the aws:policy/SecurityAudit permission.

  2. Select the CloudFormation service.
    CloudFormation.png
    In the AWS console, select Services > Management Tools > CloudFormation. The Create Stack panel displays.

  3. From the Region drop-down located in the top left of the menu bar, select the appropriate region for your environment.
    AWSRegions.png

  4. Click Create Stack.
    The Select Template panel displays.

  5. Under Choose a template, select Upload a template to Amazon S3. Browse for the Lacework AWS GovCloud template file that you previously created and click Open.

  6. Click Next.
    The Specify Details page displays.

  7. In the Stack name field, enter a unique value.

  8. On the Create stack > Specify Details page, you can either create a new trail and S3 bucket or use an existing trail. Follow the appropriate procedure for your AWS GovCloud environment:
    1. Option 1 - Create a New Trail and S3 Bucket
    2. Option 2 - Use an Existing Trail

Option 1 - Create a New Trail and S3 Bucket

If you plan to separately integrate multiple accounts, the Resource Name Prefix must be different for each account because S3 bucket names are globally unique.

  1. Resource name prefix should be pre-populated with your account name. The value does not need to change unless:
    • you are creating a stack for each account—For this case, the value must be unique for each account because the S3 bucket namespace is global.
    • you are creating multiple stacks—For this case, the value must be unique to avoid a resource collision.
  2. Set Create a new trail? to Yes.
  3. If you want a specific S3 bucket path for your logs, add a Log file prefix.
  4. Leave the values for Bucket name and Topic ARN blank.
  5. Click Next. AWSMultipleTrails.png

Option 2 - Use an Existing Trail

  1. Resource name prefix should be pre-populated with your account name.
  2. Set Create a new trail? to No.
  3. The Log file prefix is not applicable because you are not creating a new trail.
  4. Enter the Bucket name associated with your existing trail.
  5. Add the SNS Topic ARN of your existing trail into Topic ARN. If the trail does not already have an SNS topic, you must create one.
  6. Click Next. AWSExistingTrail.png

NOTE: If you are integrating an existing trail, you may be using server-side encryption. If using Server-Side Encryption with Amazon S3-Managed Keys (SSE-S3), key management is local to S3, and therefore no changes are required. If you are using Server-Side Encryption with AWS KMS-Managed Keys (SSE-KMS), key management requires access to the AWS KMS service, so you must give the Lacework-created role the required permission. See this article for instructions on how to update the inline policy associated with the Lacework-created role. If you are manually integrating Lacework, you will need to grant this same permission.

Continue Stack Creation and Gather Settings

Complete the creation of the stack in the AWS console and gather the required settings as described by the following steps.

  1. In the Create stack > Options page, no changes are required. Click Next.
  2. In the Create Stack > Review page, select the acknowledgment and click Create. After clicking Create, you are redirected back to the CloudFormation page.
  3. If you do not see your new stack in the table, refresh the page. Keep refreshing the page until the status of the stack is CREATE-COMPLETE.
  4. After the stack status is CREATE-COMPLETE, click the stack name link.
  5. Expand Outputs.
  6. Leave the AWS console open to this page so you can copy the following values about the stack: 1) AccountId 2) AccessKeyId 3) SecretAccessKey 4) SQSQueueURL You need these values when you finish creating the integration using the Lacework Console as described in the next procedure.

Finish Integration Using the Lacework Console

Finish the integration using the Lacework Console as described by the following steps.

  1. Log in to the Lacework Console.
  2. Select Settings > Integrations > Cloud Accounts.
  3. Click + Create New.
  4. Select AWS and one of the following options:
    • Select CloudTrail (US GovCloud) to analyze CloudTrail activity for monitoring cloud account security.
    • Select Config (US GovCloud) to analyze AWS configuration compliance.
  5. Click Next.
  6. In the Name field, enter a unique name for the integration.
  7. In the Account ID field, enter the AccountId value copied from the AWS console.
  8. In the Access Key ID field, enter the AccessKeyId value copied from the AWS console.
  9. In the Secret Access Key field, enter the SecretAccessKey value copied from the AWS console.
  10. If you are configuring an AWS CloudTrail (US GovCloud) integration, in the SQS Queue URL field enter the SQSQueueURL value copied from the AWS console. (This step is not required for an AWS Config (US GovCloud) integration.
  11. Click Save. A new integration displays in Cloud Accounts.
  12. When the integration is complete and successful, the status changes to Integration Successful.

To analyze CloudTrail activity for monitoring cloud account security and analyze AWS configuration compliance, you must create AWS CloudTrail (US GovCloud) and AWS Config (US GovCloud) integrations.

If you want to create a second integration, repeat the Finish Integration using the Lacework Console procedure. You can reuse the same set of stack values for the second integration.

Create a Lacework AWS GovCloud Integration Using Terraform

For organizations using Terraform to manage their environments, Lacework maintains the Terraform Provider for Lacework, which enables configuration of Lacework integrations using automation.

If you are new to the Lacework Terraform Provider or Lacework Terraform Modules, read the Terraform for Lacework Overview to learn the basics on how to configure the provider and more.

# Configure AWS GovCloud Config integration in Lacework

resource "lacework_integration_aws_govcloud_cfg" "example" {
    name = "AWS gov cloud config integration example"
    account_id = "553453453"
    credentials {
        access_key_id     = "AWS123abcAccessKeyID"
        secret_access_key = "AWS123abc123abcSecretAccessKey0000000000"
    }
}

# Configure AWS GovCloud CloudTrail integration in Lacework

resource "lacework_integration_aws_govcloud_ct" "example" {
    name       = "AWS gov cloud cloudtrail integration example"
    account_id = "553453453"
    queue_url  = "https://sqs.us-gov-west-1.amazonaws.com/123456789012/my_queue"
    credentials {
        access_key_id     = "AWS123abcAccessKeyID"
        secret_access_key = "AWS123abc123abcSecretAccessKey0000000000"
    }
}

You can find additional information on the lacework_integration_aws_govcloud_cfg and lacework_integration_aws_govcloud_ct resources in the Terraform Registry.