Configure AWS Full Permission Deployment
Alert Logic recommends full permission deployment, which requires the use of the recommended policy available within the Alert Logic console. This set of permissions allows Alert Logic to discover your AWS environment and automate the setup of the required AWS services.
To use full permission deployment, you must grant Alert Logic permissions to make changes to your environment (enable/modify AWS CloudTrail settings, create an Amazon SQS queue and an Amazon SNS topic, and modify permissions).
Full permission deployment allows you to set up CloudTrail in either the AWS account you want Alert Logic to protect, or in a separate account in which CloudTrail is configured for centralized log collection.
You can also employ a minimal permission deployment, which provides limited privileges that still allow Alert Logic to work properly in AWS. To learn more about minimal permission deployment, see Configure AWS Minimal Permission Deployment.
If you deploy using the minimum-permissions policy, Alert Logic will not be able to facilitate the discovery of your AWS environment or automate required AWS services, which can affect your experience. Alert Logic recommends deploying with the full-permissions deployment policy.
Configure full permission deployment
To configure full permission deployment, you must log into your AWS account and create a policy and IAM role, and then log into the Alert Logic console and provide your role information. AWS role creation requires that you provide an AWS policy, a document that specifies the permissions assigned to the AWS role you create for Alert Logic to access to your AWS account.
Create an IAM policy and role for full permission deployment with a CloudFormation template
Alert Logic recommends you use its CloudFormation template for quick, convenient IAM policy and role creation.
To use the CloudFormation template to create a deployment:
- Log into the Alert Logic console.
- From the Deployments page, click the add icon ().
- Select Amazon Web Services (AWS).
- Type a name for your deployment, and then click SAVE AND CONTINUE.
- Under Cloud Defender, click SELECT, and then click CONTINUE.
- Click CLOUDFORMATION SETUP to use the Alert Logic CloudFormation template to create the AWS role needed for deployment creation.
- Follow the on-screen procedure to access the AWS CloudFormation Create Stack page and generate the role ARN you need to create your deployment.
- When prompted, paste the role ARN you copied from the AWS CloudFormation Create Stack page.
- Click CONTINUE.
Complete full permission deployment configuration
To complete configuration of a full permission deployment, you must log into the Alert Logic console, and then enter the AWS role information created above.
To configure this deployment in the Alert Logic console:
- Browse to the Deployments page.
- Click the tile for the AWS deployment you want to configure.
- Enter the Role ARN and External ID you created above.
- Click CREATE.
Configure full permission deployment with centralized log collection
Create a cross-account access role
To configure full permission deployment with centralized log collection, you must log into your AWS account and create a policy and IAM role for the account you want to protect and for the account you want to use for centralized log collection.
The policy document for the protected account grants only the permissions required to monitor your environments. The policy document for the receiving account grants only read-only access.
To create a policy and IAM role:
- Download and open this policy document for the protected account. Keep the document open so you can copy and paste the information during IAM role creation.
- Download and open this policy document for the receiving account. Keep the document open so you can copy and paste the information during IAM role creation for centralized log collection.
- To create a cross-account access role, see Create a cross-account access role.
- Then you must log into the Alert Logic console and provide the role information for both accounts:
- Protected account—The account protected by Alert Logic.
- Receiving account—The account that owns the S3 bucket where CloudTrail is configured to store its log files.
Complete configuration of full permission deployment with centralized log collection
To complete configuration of a full permission deployment with centralized log collection, you must log into the Alert Logic console, and then enter the AWS role information created above. To learn more about AWS deployments, see AWS Deployments.
To configure this deployment in the Alert Logic console:
- Browse to the Deployments page.
- Click the tile for the AWS deployment you want to configure.
- Enter the Role ARN and External ID for the protected account.
- Select I want this environment to use cross-account CloudTrail to centralize CloudTrail log collection.
- Enter the Role ARN and External ID for the receiving account.
- Click CREATE.