Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Crea un secreto de réplica
Para habilitar la replicación entre cuentas, el propietario de la cuenta de réplica crea un nuevo secreto de réplica en la cuenta de réplica. Secrets Manager crea la réplica sin ningún valor secreto e inicializa sus permisos para que el propietario de la cuenta principal pueda asociarla a un secreto principal. El valor de la réplica permanece vacío hasta que el propietario de la cuenta principal inicie la replicación.
Debe cifrar el secreto de la réplica con una clave de KMS administrada por el cliente. El Clave administrada de AWS aws/secretsmanager no admite el acceso multicuenta.
Tras crear el secreto de la réplica, el propietario de la cuenta principal lo asocia al secreto principal para iniciar la replicación. Para obtener más información, consulte Asociar la réplica a un secreto principal.
Pasos para crear un secreto de réplica
-
Cree la clave gestionada por el cliente. En la cuenta de réplica y AWS Región, cree una clave KMS de cifrado simétrico. Cree una política de claves que otorgue a la cuenta de réplica permisos para crear un nuevo secreto. Para obtener más información, consulte Permisos para la clave KMS. Añada los permisos de cifrado multicuenta a esta clave de KMS una vez que tenga el ARN del secreto de la réplica. Para más información sobre la creación de claves, consulte Creación de claves en la Guía para desarrolladores de AWS Key Management Service .
-
Crea el secreto de la réplica. En la cuenta de réplica, ejecuta
CreateSecret. SetCrossAccountPrimaryARNal ARN del secreto principal yKmsKeyIdal ARN de la clave KMS replicada administrada por el cliente.ejemplo Cree un secreto de réplica
aws secretsmanager create-secret \ --name MyReplicaSecret \ --cross-account-primary-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3 \ --kms-key-id arn:aws:kms:us-east-2:444455556666:key/replica-key-idHasta que el secreto principal replique su primer valor, llama
GetSecretValueen la réplica devuelveResourceNotFoundException. Secrets Manager no admite operaciones de escritura en un secreto de réplica, comoPutSecretValue. Puede consultar la lista completa e No se admiten operaciones con un secreto de réplica.notaAl crear el secreto de la réplica, Secrets Manager adjunta una política de recursos administrada por el sistema denominada
cross-account-replicationa ella. Esta política administrada es de solo lectura y coexiste con cualquier política de recursos que establezca en la réplica.Dado que la creación de la réplica implica una política de recursos administrados, la persona que llama necesita
secretsmanager:PutResourcePolicysobre el nuevo secreto. La persona que llama también necesita el AWS KMS permisos para usar la clave KMS del secreto de la réplica. -
Actualice la política de claves de réplica. Ahora que existe el ARN secreto de la réplica, actualice política clave de la clave KMS de réplica para autorizar la llamada de la cuenta principal
kms:Encrypt. Ajuste el principio y las condiciones para que coincidan con sus requisitos de seguridad.Para restringir aún más el uso de la clave, si lo desea, puede definir el alcance de la declaración con el Contexto de cifrado SecretarN establecido en el ARN secreto de la réplica. Con esta condición, la cuenta principal solo puede usar la clave cuando se replica en este secreto de réplica.
ejemplo Declaración de política de claves de réplica para la replicación entre cuentas
{ "Sid": "AllowCrossAccountReplication", "Effect": "Allow", "Principal": "*", "Action": "kms:Encrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:CallerAccount": "111122223333", "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } }Para obtener más información sobre cómo Secrets Manager usa las claves de KMS y el contexto de cifrado para la replicación entre cuentas, consulte AWS KMS claves para la replicación entre cuentas.
System-managed política de recursos para el secreto de la réplica
Al crear el secreto de la réplica, Secrets Manager crea una política de recursos administrada por el sistema que permite al propietario del secreto principal configurar la replicación a este secreto de réplica. No puede editar esta política directamente. Secrets Manager la elimina cuando llamas StopReplicationToReplica. Puede anular la política y negarla explícitamente secretsmanager:AcceptCrossAccountReplication, pero al hacerlo se evita que la cuenta principal se replique en esta réplica.
ejemplo Ejemplo de política de recursos administrada por el sistema sobre el secreto de la réplica
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CrossAccountReplication", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": "secretsmanager:AcceptCrossAccountReplication", "Resource": "*", "Condition": { "ForAnyValue:StringEquals": { "aws:InvokedBy": "secretsmanager.amazonaws.com" }, "ArnEquals": { "secretsmanager:CrossAccountPrimaryARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } } ] }
No se admiten operaciones con un secreto de réplica
Si bien un secreto es una réplica multicuenta, Secrets Manager no admite las siguientes operaciones en él. Si ejecutas una de las siguientes operaciones en una réplica secreta, la solicitud se devuelve InvalidRequestException:
PutSecretValueUpdateSecretDeleteSecret— Para eliminar una réplica, primero llameStopReplicationToReplicapara convertirlo en un secreto independiente y, a continuación, llamarDeleteSecret.RotateSecretCancelRotateSecretUpdateSecretVersionStageReplicateSecretToRegionsRemoveRegionsFromReplication
Las operaciones que permanecen disponibles en una réplica secreta incluyen GetSecretValue, DescribeSecret, las operaciones de política de recursos (GetResourcePolicy, PutResourcePolicy, y DeleteResourcePolicy), operaciones de etiquetado y StopReplicationToReplica.
AWS SDK
Para crear una réplica secreta, usa el CreateSecret comando con CrossAccountPrimaryARN y KmsKeyId parámetros. Para obtener más información, consulte AWS SDK.