View a markdown version of this page

Créer un secret de réplique - AWS Secrets Manager

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.

Créer un secret de réplique

Pour activer la réplication entre comptes, le propriétaire du compte de réplication crée un nouveau secret de réplication dans le compte de réplication. Secrets Manager crée la réplique sans valeur secrète et initialise ses autorisations afin que le propriétaire du compte principal puisse l'associer à un secret principal. La valeur de la réplique reste vide jusqu'à ce que le propriétaire principal du compte commence la réplication.

Vous devez chiffrer le secret de réplication à l'aide d'une clé KMS gérée par le client. Le Clé gérée par AWS aws/secretsmanager ne prend pas en charge l'accès entre comptes.

Une fois que vous avez créé le secret de réplication, le propriétaire du compte principal l'associe au secret principal pour démarrer la réplication. Pour plus d’informations, consultez Associez la réplique à un secret principal.

Étapes pour créer un secret de réplique

  1. Créez la clé gérée par le client. Dans le compte de réplique et AWS Région, créez une clé KMS de chiffrement symétrique. Créez une politique clé qui autorise le compte de réplication à créer un nouveau secret. Pour plus d'informations, voir Autorisations pour la clé KMS. Vous ajoutez les autorisations de chiffrement entre comptes à cette clé KMS après avoir obtenu l'ARN du secret de réplication. Pour plus d'informations sur la création de clés, consultez Création de clés dans le Guide du développeur AWS Key Management Service .

  2. Créez le secret de la réplique. Dans le compte de réplication, exécutez CreateSecret. Set CrossAccountPrimaryARN à l'ARN du secret principal et KmsKeyId à l'ARN de la réplique de la clé KMS gérée par le client.

    Exemple Créer un secret de réplique
    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

    Jusqu'à ce que le secret principal réplique sa première valeur, en appelant GetSecretValue sur les retours de répliques ResourceNotFoundException. Secrets Manager ne prend pas en charge les opérations d'écriture sur un secret de réplication, telles que PutSecretValue. Pour obtenir la liste complète, consultez Opérations non prises en charge sur un secret de réplique.

    Note

    Lorsque vous créez le secret de réplication, Secrets Manager associe une politique de ressources gérée par le système nommée cross-account-replication à elle. Cette politique gérée est en lecture seule et coexiste avec toutes les politiques de ressources que vous définissez sur le réplica.

    Étant donné que la création de la réplique est associée à une politique de ressources gérées, l'appelant doit secretsmanager:PutResourcePolicy sur le nouveau secret. L'appelant a également besoin du AWS KMS autorisations d'utilisation de la clé KMS du secret de réplication.

  3. Mettez à jour la politique relative aux clés de réplication. Maintenant que l'ARN secret de la réplique existe, mettez à jour le politique clé de la clé KMS répliquée pour autoriser le compte principal à appeler kms:Encrypt. Ajustez le principal et les conditions en fonction de vos exigences de sécurité.

    Pour restreindre davantage l'utilisation de la clé, vous pouvez éventuellement définir la portée de l'instruction avec Contexte de chiffrement SecretArn défini sur l'ARN secret de la réplique. Dans cette condition, le compte principal ne peut utiliser la clé que lorsqu'il effectue une réplication vers ce secret de réplication.

    Exemple Déclaration de politique clé en matière de réplication pour la réplication entre comptes
    { "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" } } }

    Pour plus d'informations sur la manière dont Secrets Manager utilise les clés KMS et sur le contexte de chiffrement pour la réplication entre comptes, consultez AWS KMS clés pour la réplication entre comptes.

System-managed politique en matière de ressources pour le secret de réplication

Lorsque vous créez le secret de réplication, Secrets Manager crée une politique de ressources gérée par le système qui permet au propriétaire du secret principal de configurer la réplication vers ce secret de réplication. Vous ne pouvez pas modifier cette politique directement. Secrets Manager le supprime lorsque vous appelez StopReplicationToReplica. Vous pouvez annuler la politique et refuser explicitement secretsmanager:AcceptCrossAccountReplication, mais cela empêche le compte principal de se répliquer sur cette réplique.

Exemple Exemple de politique de ressources gérée par le système sur le secret de réplication
{ "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" } } } ] }

Opérations non prises en charge sur un secret de réplique

Bien qu'un secret soit une réplique entre comptes, Secrets Manager ne prend pas en charge les opérations suivantes. Si vous appelez l'une des opérations suivantes sur un secret de réplication, la demande renvoie InvalidRequestException:

  • PutSecretValue

  • UpdateSecret

  • DeleteSecret — Pour supprimer une réplique, appelez d'abord StopReplicationToReplica pour le transformer en secret autonome, puis appelez DeleteSecret.

  • RotateSecret

  • CancelRotateSecret

  • UpdateSecretVersionStage

  • ReplicateSecretToRegions

  • RemoveRegionsFromReplication

Les opérations qui restent disponibles sur une réplique secrète incluent GetSecretValue, DescribeSecret, les opérations relatives à la politique des ressources (GetResourcePolicy, PutResourcePolicy, et DeleteResourcePolicy), les opérations de balisage et StopReplicationToReplica.

AWS Kit SDK

Pour créer un secret de réplique, utilisez CreateSecret commande avec CrossAccountPrimaryARN et KmsKeyId paramètres. Pour plus d'informations, consultez AWS Kits SDK.