Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Comment Secrets Manager autorise la réplication entre comptes
Chaque fois que Secrets Manager réplique une valeur secrète, il déchiffre la valeur à l'aide de la clé KMS du secret principal et la rechiffre à l'aide de la clé KMS du secret de réplique. Secrets Manager a besoin d'une identité autorisée pour les deux opérations. Vous choisissez l'identité : un rôle de réplication assumé par Secrets Manager, ou la propre identité de l'appelant via une session d'accès direct (FAS). Cette rubrique explique les deux approches.
Comment la réplication est déclenchée
Secrets Manager synchronise la réplique en répliquant chaque modification sur la valeur secrète principale. Par exemple, lorsque vous appelez PutSecretValue sur le secret principal, Secrets Manager crée la nouvelle version, déplace le AWSCURRENT étiquette de transfert sur celle-ci, puis réplique la version sur la réplique. La réplication étant asynchrone et finalement cohérente, la réplication peut ne pas refléter immédiatement la dernière valeur. Pour suivre les progrès, voir Surveillez la réplication entre comptes.
La réplication effectue deux AWS KMS opérations
Pour déplacer une valeur secrète de la source principale vers la réplique, Secrets Manager effectue les deux opérations suivantes AWS KMS opérations dans l'ordre :
-
Décrypter — Les appels de Secrets Manager
kms:Decryptavec la clé KMS du secret principal pour déchiffrer la clé de données qui protège la valeur secrète. -
Chiffrer — Les appels de Secrets Manager
kms:Encryptà l'aide de la clé KMS du secret de réplication pour rechiffrer la clé de données à stocker dans la réplique.
Étant donné que les deux clés KMS se trouvent dans des comptes différents, la politique de clé de la clé de réplication doit autoriser le compte du secret principal à appeler kms:Encrypt. Vous pouvez définir cette politique à l'aide du contexte de chiffrement SecretArn pour limiter l'utilisation au secret de réplication. Pour la déclaration de politique clé, voir Créer un secret de réplique. Pour plus d'informations sur la manière dont Secrets Manager utilise les clés KMS et le contexte de chiffrement lors de la réplication, consultez AWS KMS clés pour la réplication entre comptes.
Une politique de contrôle des ressources (RCP) au niveau de l'organisation ou une politique de contrôle des services (SCP) peut les bloquer AWS KMS opérations, même si l'identité et les politiques clés le permettent.
Choisissez la manière dont Secrets Manager obtient les autorisations
La différence entre les deux approches réside dans l'identité que Secrets Manager utilise pour créer les deux AWS KMS appels.
Rôle de réplication (recommandé)
Lorsque vous fournissez un rôle de réplication, Secrets Manager assume ce rôle IAM et l'utilise comme identité pour les deux AWS KMS appels. Secrets Manager utilise ce rôle pour appeler kms:Decrypt sur la clé KMS du secret principal et kms:Encrypt sur la clé KMS de la réplique secrète. Étant donné que le rôle comporte les autorisations intercomptes, les appelants individuels de PutSecretValue n'ont pas tous besoin d'un compte croisé AWS KMS autorisations. Avec cette approche, le secret principal doit utiliser une clé KMS gérée par le client.
Pour savoir comment configurer le rôle, sa politique de confiance et sa politique d'autorisation, voir Configurer le rôle du service de réplication.
Transfert des sessions d’accès
UNE session d'accès direct (FAS) permet à Secrets Manager d'effectuer des appels d'API en aval en utilisant les autorisations de l'identité qui a déclenché l'opération. Lorsque vous ne fournissez pas de rôle de réplication, Secrets Manager utilise une session d'accès direct : il crée les deux AWS KMS appels sous l'identité qui a appelé l'opération de déclenchement, par exemple PutSecretValue.
Dans le cas d'une session d'accès direct, la réplication initiale est effectuée à l'aide de l'identité appelée AssociateCrossAccountReplica.
Avec cette approche, l'identité de déclenchement doit détenir les deux autorisations suivantes :
-
kms:Decryptsur la clé KMS du secret principal. Cette clé se trouve sur le même compte que l'appelant. L'appelant possède donc généralement déjà cette autorisation. -
kms:Encryptsur la clé KMS de la réplique secrète. Cette clé se trouve dans le compte de réplication. L'appelant doit donc disposer d'une autorisation multicompte pour y accéder. C'est l'exigence que le FAS rend plus difficile à satisfaire.
Si l'identité de déclenchement est absente : AWS KMS autorisation, la réplication ne peut pas être terminée et l'état de la réplication devient Failed. Pour savoir comment lire l'état et récupérer, voir Surveillez la réplication entre comptes.
La politique d'identité suivante permet PutSecretValue appelant pour utiliser le compte croisé kms:Encrypt autorisation dont il a besoin sur la clé KMS du secret de réplique. L'instruction est limitée par le contexte de chiffrement SecretArn afin que l'identité puisse utiliser la clé KMS du secret de réplique uniquement pour le secret de réplique. Attachez une politique comme celle-ci à l'identité qui appelle PutSecretValue sur le secret principal.
Exemple Politique d'identité à chiffrer par un appelant à l'aide de la clé KMS du secret de réplication
{ "Version": "2012-10-17", "Statement": [ { "Sid": "EncryptReplicaSecretKey", "Effect": "Allow", "Action": "kms:Encrypt", "Resource": "arn:aws:kms:us-east-2:444455556666:key/replica-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } } ] }
Recommendation
Dans la plupart des cas d'utilisation, le rôle de réplication est l'approche recommandée. Secrets Manager assume le rôle et l'utilise comme identité unique pour les deux AWS KMS appels, vous n'avez donc pas à donner à chaque identité d'auteur l'autorisation d'accéder à la clé KMS du secret de réplication sur plusieurs comptes. Les sessions d'accès direct peuvent convenir aux cas où les identités qui modifient le secret principal détiennent déjà le compte croisé kms:Encrypt autorisation sur la clé KMS du secret de réplication, et vous préférez ne pas gérer de rôle de réplication.
Configurer le rôle du service de réplication
Le rôle de service doit faire confiance secretsmanager.amazonaws.com, et peut être conditionné sur aws:SourceAccount et aws:SourceArn pour éviter le problème de confusion entre les sous-ministres. Sa politique d'autorisation doit permettre kms:Decrypt sur la clé KMS du secret principal (éventuellement avec le contexte de chiffrement SecretARN défini sur l'ARN secret principal) et kms:Encrypt sur la clé KMS de la réplique secrète (éventuellement avec le contexte de chiffrement SecretARN défini sur l'ARN secret de la réplique).
Exemple Politique de confiance pour le rôle de service de réplication (exemple représentatif)
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "secretsmanager.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnEquals": { "aws:SourceArn": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } } ] }
Exemple Politique d'autorisation pour le rôle de service de réplication (exemple représentatif)
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DecryptPrimarySecretKey", "Effect": "Allow", "Action": "kms:Decrypt", "Resource": "arn:aws:kms:us-east-2:111122223333:key/primary-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } }, { "Sid": "EncryptReplicaSecretKey", "Effect": "Allow", "Action": "kms:Encrypt", "Resource": "arn:aws:kms:us-east-2:444455556666:key/replica-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } } ] }
Le Clé gérée par AWS (aws/secretsmanager) ne prend pas en charge kms:Decrypt appels provenant d'un rôle de service. Vous devez utiliser une clé gérée par le client pour le secret principal lorsque vous utilisez un rôle de réplication. Ajoutez une instruction comme celle-ci à la politique de clé de votre clé primaire pour permettre au rôle de réplication de déchiffrer la clé de données de la clé secrète primaire.
Exemple Déclaration de politique de clé primaire qui autorise le déchiffrement du rôle de réplication (exemple représentatif)
{ "Sid": "AllowReplicationRoleDecrypt", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole" }, "Action": "kms:Decrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } }