AWS privateca: Add GovCloud ARN partition and multi-Region prerequisites for Connector for AD
Summary
Adds a multi-Region directory support note, a GovCloud (US) note instructing users to replace arn:aws with arn:aws-us-gov in IAM policy ARN patterns, and a GovCloud example of the aws ram create-resource-share command.
Security assessment
The change is region-availability guidance that adjusts IAM policy and resource-share ARN examples for the aws-us-gov partition. It touches IAM/permission ARNs but documents correct configuration rather than addressing any specific vulnerability or incident.
Evidence
In the AWS GovCloud (US) Regions, replace `arn:aws` with `arn:aws-us-gov` in all ARN patterns in the following policy examples. For example, the template ARN becomes `arn:aws-us-gov:acm-pca:::template/BlankEndEntityCertificate_APIPassthrough/V*`.
Diff
diff --git a/privateca/latest/userguide/connector-for-ad-getting-started-prerequisites.md b/privateca/latest/userguide/connector-for-ad-getting-started-prerequisites.md index 27e48c969..38ca6e0b2 100644 --- a//privateca/latest/userguide/connector-for-ad-getting-started-prerequisites.md +++ b//privateca/latest/userguide/connector-for-ad-getting-started-prerequisites.md @@ -12,0 +13,4 @@ The steps in this section are prerequisites to using Connector for AD. It assume +###### Multi-Region directory support + +For multi-Region AWS Managed Microsoft AD directories, you can only create Connector for AD connectors and directory registrations in the directory's primary Region. For information about multi-Region replication, see [Multi-Region replication](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_configure_multi_region_replication.html) in the _AWS Directory Service Administration Guide_. + @@ -66,0 +71,4 @@ To create a connector for AD, you need an IAM policy that allows you to create c +###### Note + +In the AWS GovCloud (US) Regions, replace `arn:aws` with `arn:aws-us-gov` in all ARN patterns in the following policy examples. For example, the template ARN becomes `arn:aws-us-gov:acm-pca:::template/BlankEndEntityCertificate_APIPassthrough/V*`. + @@ -203,0 +212,11 @@ The following command creates a resource share: +For the AWS GovCloud (US) Regions, use the `aws-us-gov` partition and an AWS GovCloud (US) Region: + + + $ aws ram create-resource-share \ + --region us-gov-west-1 \ + --name MyPcaConnectorAdResourceShare \ + --permission-arns arn:aws-us-gov:ram::aws:permission/AWSRAMBlankEndEntityCertificateAPIPassthroughIssuanceCertificateAuthority \ + --resource-arns arn:aws-us-gov:acm-pca:us-gov-west-1:account:certificate-authority/CA_ID \ + --principals pca-connector-ad.amazonaws.com \ + --sources account +