View a markdown version of this page

Crea una replica segreta - AWS Secrets Manager

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea una replica segreta

Per abilitare la replica tra account, il proprietario dell'account di replica crea un nuovo segreto di replica nell'account di replica. Secrets Manager crea la replica senza alcun valore segreto e inizializza le relative autorizzazioni in modo che il proprietario dell'account principale possa associarla a un segreto primario. Il valore della replica rimane vuoto finché il proprietario dell'account principale non avvia la replica.

È necessario crittografare il segreto della replica con una chiave KMS gestita dal cliente. Il Chiave gestita da AWS aws/secretsmanager non supporta l'accesso tra più account.

Dopo aver creato il segreto di replica, il proprietario dell'account principale lo associa al segreto primario per avviare la replica. Per ulteriori informazioni, consulta Associa la replica a un segreto primario.

Procedura per creare un segreto di replica

  1. Crea la chiave gestita dal cliente. Nell'account di replica e AWS Regione, crea una chiave KMS di crittografia simmetrica. Crea una policy chiave che dia all'account di replica le autorizzazioni per creare un nuovo segreto. Per ulteriori informazioni, vedere Autorizzazioni per la chiave KMS. Aggiungi le autorizzazioni di crittografia tra account a questa chiave KMS dopo aver ottenuto l'ARN del segreto di replica. Per ulteriori informazioni sulla creazione di chiavi, consulta Creazione di chiavi nella Guida per gli sviluppatori di AWS Key Management Service .

  2. Crea il segreto della replica. Nell'account di replica, esegui CreateSecret. Impostare CrossAccountPrimaryARN all'ARN del segreto primario e KmsKeyId all'ARN della chiave KMS gestita dal cliente di replica.

    Esempio Crea una replica segreta
    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

    Finché il segreto primario non replica il suo primo valore, chiamando GetSecretValue sulla replica ritorna ResourceNotFoundException. Secrets Manager non supporta le operazioni di scrittura su un segreto di replica, ad esempio PutSecretValue. Per l’elenco completo, consulta Operazioni non supportate su un segreto di replica.

    Nota

    Quando si crea il segreto della replica, Secrets Manager allega una policy sulle risorse gestite dal sistema denominata cross-account-replication ad esso. Questa policy gestita è di sola lettura e coesiste con qualsiasi policy relativa alle risorse impostata sulla replica.

    Poiché la creazione della replica allega una politica relativa alle risorse gestite, il chiamante deve secretsmanager:PutResourcePolicy sul nuovo segreto. Il chiamante ha bisogno anche del AWS KMS autorizzazioni per utilizzare la chiave KMS del segreto della replica.

  3. Aggiorna la politica delle chiavi di replica. Ora che l'ARN segreto della replica esiste, aggiorna il politica chiave della chiave KMS di replica per autorizzare l'account principale a chiamare kms:Encrypt. Adatta il principio e le condizioni in base ai tuoi requisiti di sicurezza.

    Per limitare ulteriormente l'uso della chiave, puoi facoltativamente definire l'ambito della dichiarazione con il Contesto di crittografia SecretARN impostato sull'ARN segreto della replica. Con questa condizione, l'account primario può utilizzare la chiave solo quando si replica su questo segreto di replica.

    Esempio Dichiarazione sulla politica della chiave di replica per la replica su più account
    { "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" } } }

    Per ulteriori informazioni su come Secrets Manager utilizza le chiavi KMS e sul contesto di crittografia per la replica tra account, vedere AWS KMS chiavi per la replica tra account.

System-managed politica delle risorse per il segreto della replica

Quando si crea il segreto di replica, Secrets Manager crea una politica delle risorse gestita dal sistema che consente al proprietario del segreto primario di impostare la replica su questo segreto di replica. Non puoi modificare direttamente questa policy. Secrets Manager la rimuove quando chiami StopReplicationToReplica. Puoi sovrascrivere la politica e negare esplicitamente secretsmanager:AcceptCrossAccountReplication, ma così facendo si impedisce all'account principale di replicarsi su questa replica.

Esempio Esempio di politica delle risorse gestita dal sistema sul segreto della replica
{ "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" } } } ] }

Operazioni non supportate su un segreto di replica

Sebbene un segreto sia una replica su più account, Secrets Manager non supporta le seguenti operazioni su di esso. Se si chiama una delle seguenti operazioni su una replica segreta, la richiesta viene restituita InvalidRequestException:

  • PutSecretValue

  • UpdateSecret

  • DeleteSecret — Per eliminare una replica, prima chiama StopReplicationToReplica per promuoverla come segreta autonoma, quindi chiama DeleteSecret.

  • RotateSecret

  • CancelRotateSecret

  • UpdateSecretVersionStage

  • ReplicateSecretToRegions

  • RemoveRegionsFromReplication

Le operazioni che rimangono disponibili su una replica segreta includono GetSecretValue, DescribeSecret, le operazioni relative alla politica delle risorse (GetResourcePolicy, PutResourcePolicy, e DeleteResourcePolicy), operazioni con i tag e StopReplicationToReplica.

AWS SDK

Per creare una replica segreta, usa CreateSecret comando con CrossAccountPrimaryARN e KmsKeyId parametri. Per ulteriori informazioni, consulta AWS SDK.