AWS opensearch-service high security documentation change
Summary
Added access policy configuration requirements and sample IAM policy for direct query data sources
Security assessment
Introduces mandatory access control configuration to prevent unauthorized data access. Explicitly warns that without policies, only the owner has access, and provides granular permission examples. This addresses potential data exposure risks from unconfigured access policies.
Diff
diff --git a/opensearch-service/latest/developerguide/direct-query-cloudwatch-logs-creating.md b/opensearch-service/latest/developerguide/direct-query-cloudwatch-logs-creating.md index 0201fed74..89068d4f2 100644 --- a//opensearch-service/latest/developerguide/direct-query-cloudwatch-logs-creating.md +++ b//opensearch-service/latest/developerguide/direct-query-cloudwatch-logs-creating.md @@ -90 +90 @@ When using your own role, you must ensure it has all necessary permissions by at - 8. (Optional) Under **Tags** , add tags to your data source. + 8. (Optional) Under **Access policy** , configure an access policy for the data source. Access policies control whether a request to the OpenSearch Service direct query data source is accepted or rejected. If you don't configure an access policy, only the data source owner has access. You can configure the access policy to enable cross-account access, allowing principals in other AWS accounts to access the data source. @@ -92 +92 @@ When using your own role, you must ensure it has all necessary permissions by at - 9. Choose **Next**. +You can create an access policy using the visual editor or by providing a JSON policy document. With the visual editor, you can allow or deny access by specifying a principal AWS account ID, account ARN, IAM user ARN, IAM role ARN, source IP address, or CIDR block. The visual editor supports up to 10 elements. To define a policy with more than 10 elements, use the JSON editor. @@ -94 +94,7 @@ When using your own role, you must ensure it has all necessary permissions by at - 10. Under **Set up OpenSearch** , choose how to set up OpenSearch. +You can also choose **Import policy** to import an existing access policy from another data source. + + 9. (Optional) Under **Tags** , add tags to your data source. + + 10. Choose **Next**. + + 11. Under **Set up OpenSearch** , choose how to set up OpenSearch. @@ -110 +116 @@ When you use the default settings, a new OpenSearch application and Essentials w - 11. Choose **Next**. + 12. Choose **Next**. @@ -112 +118 @@ When you use the default settings, a new OpenSearch application and Essentials w - 12. Review your choices and choose **Edit** if you need to make any changes. + 13. Review your choices and choose **Edit** if you need to make any changes. @@ -114 +120 @@ When you use the default settings, a new OpenSearch application and Essentials w - 13. Choose **Connect** to set up the data source. Stay on this page while your data source is created. When it’s ready, you’ll be taken to the data source details page. + 14. Choose **Connect** to set up the data source. Stay on this page while your data source is created. When it’s ready, you’ll be taken to the data source details page. @@ -210,0 +217,28 @@ By default, the role has access to direct query data source indexes only. Althou +### Sample access policy for a direct query data source + +Access policies for direct query data sources follow IAM policy syntax. The policy document must be in valid JSON format. The following example policy grants a specific AWS account access to the direct query data source. + +In the following sample policy, replace the `placeholder text` with your own information. + + + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Principal": { + "AWS": "arn:aws:iam::account-id:root" + }, + "Action": [ + "opensearch:StartDirectQuery", + "opensearch:GetDirectQuery", + "opensearch:CancelDirectQuery", + "opensearch:GetDirectQueryResult" + ], + "Resource": "arn:aws:opensearch:region:account-id:datasource/data-source-name" + } + ] + } + +If you don't configure an access policy, only the data source owner has access to the data source. +