View a markdown version of this page

Crea un secreto de réplica - AWS Secrets Manager

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

  1. 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 .

  2. Crea el secreto de la réplica. En la cuenta de réplica, ejecuta CreateSecret. Set CrossAccountPrimaryARN al ARN del secreto principal y KmsKeyId al 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-id

    Hasta que el secreto principal replique su primer valor, llama GetSecretValue en la réplica devuelve ResourceNotFoundException. Secrets Manager no admite operaciones de escritura en un secreto de réplica, como PutSecretValue. Puede consultar la lista completa e No se admiten operaciones con un secreto de réplica.

    nota

    Al crear el secreto de la réplica, Secrets Manager adjunta una política de recursos administrada por el sistema denominada cross-account-replication a 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:PutResourcePolicy sobre 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.

  3. 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:

  • PutSecretValue

  • UpdateSecret

  • DeleteSecret — Para eliminar una réplica, primero llame StopReplicationToReplica para convertirlo en un secreto independiente y, a continuación, llamar DeleteSecret.

  • RotateSecret

  • CancelRotateSecret

  • UpdateSecretVersionStage

  • ReplicateSecretToRegions

  • RemoveRegionsFromReplication

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.