AWS inspector high security documentation change
Summary
Updated IAM policy documentation to replace inline JSON policy examples with links to AWS Managed Policy Reference Guide, added explicit recommendation for AmazonInspector2FullAccess_v2 for enhanced security, and expanded descriptions of organizational policy permissions.
Security assessment
The change explicitly recommends using AmazonInspector2FullAccess_v2 for 'enhanced security and restrictive permissions,' indicating a security improvement over previous policies. This suggests the previous policy may have had overly permissive settings, and the update addresses this by tightening service principal access. The added permissions for viewing organizational policies (e.g., ListPolicies, DescribeEffectivePolicy) improve security visibility without granting modification rights, aligning with least privilege principles.
Diff
diff --git a/inspector/latest/user/security-iam-awsmanpol.md b/inspector/latest/user/security-iam-awsmanpol.md index 9d7786699..3bd1fce20 100644 --- a//inspector/latest/user/security-iam-awsmanpol.md +++ b//inspector/latest/user/security-iam-awsmanpol.md @@ -33 +33 @@ This policy includes the following permissions. - * `organizations` – `AllowServicePrincipalBasedAccessToOrganizationApis` allows only service principals to create service-linked roles for AWS accounts, register an AWS account as a delegated administrator for an organization, and list delegated administrators in an organization. `AllowOrganizationalBasedAccessToOrganizationApis` allows the policy holder to retrieve information, specifically resource-level ARNs, about an organizational unit. `AllowAccountsBasedAccessToOrganizationApis` allows the policy holder to retrieve information, specifically resource-level ARNs, about an AWS account. `AllowAccessToOrganizationApis` allows the policy holder to view AWS services integrated with an organization and organization information. + * `organizations` – `AllowServicePrincipalBasedAccessToOrganizationApis` allows only service principals to create service-linked roles for AWS accounts, register an AWS account as a delegated administrator for an organization, and list delegated administrators in an organization. `AllowOrganizationalBasedAccessToOrganizationApis` allows the policy holder to retrieve information, specifically resource-level ARNs, about an organizational unit. `AllowAccountsBasedAccessToOrganizationApis` allows the policy holder to retrieve information, specifically resource-level ARNs, about an AWS account. `AllowAccessToOrganizationApis` allows the policy holder to view AWS services integrated with an organization and organization information. The policy allows listing Inspector organizational policies with filtering by Inspector policy types, viewing delegation resource policies established by management accounts, and viewing the effective Inspector policies applied to accounts. @@ -42,85 +42 @@ Amazon Inspector no longer uses CodeGuru to perform Lambda scans. AWS will disco -JSON - - -**** - - - - { - "Version":"2012-10-17", - "Statement" : [ - { - "Sid" : "AllowFullAccessToInspectorApis", - "Effect" : "Allow", - "Action" : "inspector2:*", - "Resource" : "*" - }, - { - "Sid" : "AllowAccessToCodeGuruApis", - "Effect" : "Allow", - "Action" : [ - "codeguru-security:BatchGetFindings", - "codeguru-security:GetAccountConfiguration" - ], - "Resource" : "*" - }, - { - "Sid" : "AllowAccessToCreateSlr", - "Effect" : "Allow", - "Action" : "iam:CreateServiceLinkedRole", - "Resource" : "*", - "Condition" : { - "StringEquals" : { - "iam:AWSServiceName" : [ - "agentless.inspector2.amazonaws.com", - "inspector2.amazonaws.com" - ] - } - } - }, - { - "Sid" : "AllowServicePrincipalBasedAccessToOrganizationApis", - "Effect" : "Allow", - "Action" : [ - "organizations:EnableAWSServiceAccess", - "organizations:RegisterDelegatedAdministrator", - "organizations:ListDelegatedAdministrators" - ], - "Resource" : "*", - "Condition": { - "StringEquals": { - "organizations:ServicePrincipal": [ - "inspector2.amazonaws.com", - "agentless.inspector2.amazonaws.com" - ] - } - } - }, - { - "Sid" : "AllowOrganizationalBasedAccessToOrganizationApis", - "Effect" : "Allow", - "Action" : [ - "organizations:DescribeOrganizationalUnit" - ], - "Resource" : "arn:*:organizations::*:ou/o-*/ou-*" - }, - { - "Sid" : "AllowAccountsBasedAccessToOrganizationApis", - "Effect" : "Allow", - "Action" : [ - "organizations:DescribeAccount" - ], - "Resource" : "arn:*:organizations::*:account/o-*/*" - }, - { - "Sid" : "AllowAccessToOrganizationApis", - "Effect" : "Allow", - "Action" : [ - "organizations:ListAWSServiceAccessForOrganization", - "organizations:DescribeOrganization" - ], - "Resource" : "*" - } - ] - } - +To review the permissions for this policy, see [AmazonInspector2FullAccess_v2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonInspector2FullAccess_v2.html) in the _AWS Managed Policy Reference Guide_. @@ -133,0 +50,4 @@ This policy grants administrative permissions that allow full access to Amazon I +###### Important + +For enhanced security and restrictive permissions to Inspector 2 service principals, we recommend that you use [AmazonInspector2FullAccess_v2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonInspector2FullAccess_v2.html). + @@ -149,56 +69 @@ This policy includes the following permissions. -JSON - - -**** - - - - { - "Version":"2012-10-17", - "Statement": [ - { - "Sid": "AllowFullAccessToInspectorApis", - "Effect": "Allow", - "Action": "inspector2:*", - "Resource": "*" - }, - { - "Sid": "AllowAccessToCodeGuruApis", - "Effect": "Allow", - "Action": [ - "codeguru-security:BatchGetFindings", - "codeguru-security:GetAccountConfiguration" - ], - "Resource": "*" - }, - { - "Sid": "AllowAccessToCreateSlr", - "Effect": "Allow", - "Action": "iam:CreateServiceLinkedRole", - "Resource": "*", - "Condition": { - "StringEquals": { - "iam:AWSServiceName": [ - "agentless.inspector2.amazonaws.com", - "inspector2.amazonaws.com" - ] - } - } - }, - { - "Sid": "AllowAccessToOrganizationApis", - "Effect": "Allow", - "Action": [ - "organizations:EnableAWSServiceAccess", - "organizations:RegisterDelegatedAdministrator", - "organizations:ListDelegatedAdministrators", - "organizations:ListAWSServiceAccessForOrganization", - "organizations:DescribeOrganizationalUnit", - "organizations:DescribeAccount", - "organizations:DescribeOrganization" - ], - "Resource": "*" - } - ] - } - +To review the permissions for this policy, see [AmazonInspector2FullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonInspector2FullAccess.html) in the _AWS Managed Policy Reference Guide_. @@ -218 +83 @@ This policy includes the following permissions. - * `organizations` – Allows details about Amazon Inspector coverage for an organization in AWS Organizations to be viewed. + * `organizations` – Allows details about Amazon Inspector coverage for an organization in AWS Organizations to be viewed. Additionally allows viewing of Inspector organizational policies through `ListPolicies` with filtering by Inspector policy types, viewing delegation resource policies through `DescribeResourcePolicy`, and viewing effective Inspector policies applied to accounts through `DescribeEffectivePolicy`. This allows users to understand centralized inspector enablement established through organizational policies without the ability to modify them. @@ -225,31 +90 @@ This policy includes the following permissions. -JSON - - -**** - - - - { - "Version":"2012-10-17", - "Statement": [ - { - "Effect": "Allow", - "Action": [ - "organizations:ListDelegatedAdministrators", - "organizations:ListAWSServiceAccessForOrganization", - "organizations:DescribeOrganizationalUnit", - "organizations:DescribeAccount", - "organizations:DescribeOrganization", - "inspector2:BatchGet*", - "inspector2:List*", - "inspector2:Describe*", - "inspector2:Get*", - "inspector2:Search*", - "codeguru-security:BatchGetFindings", - "codeguru-security:GetAccountConfiguration" - ], - "Resource": "*" - } - ] - } - +To review the permissions for this policy, see [AmazonInspector2ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonInspector2ReadOnlyAccess.html) in the _AWS Managed Policy Reference Guide_. @@ -270,23 +105 @@ This policy includes the following permissions. -JSON - - -**** - -