View a markdown version of this page

Monitora la replica su più account - 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à.

Monitora la replica su più account

Cross-account la replica è asincrona. Per monitorare i progressi, chiama DescribeSecret periodicamente da uno dei due account e controlla ReplicationStatus campo.

Campi relativi allo stato della replica

I campi che DescribeSecret I rendimenti dipendono dal fatto che tu descriva la replica o il segreto primario:

  • Quando descrivi il replica segreto, Secrets Manager ritorna CrossAccountPrimary, che contiene PrimarySecretARN, ReplicationStatus, e StatusMessage.

  • Quando descrivi il di base segreto, Secrets Manager ritorna CrossAccountReplicas, un elenco in cui ogni voce contiene ReplicaSecretARN, ReplicationRoleARN, ReplicationStatus, e StatusMessage.

Il StatusMessage il campo fornisce dettagli in caso di errore o blocco della replica, ad esempio quando un AWS KMS manca l'autorizzazione chiave.

Valori dello stato della replica

I ReplicationStatus il campo riporta uno dei seguenti valori:

Pending (In attesa)

Secrets Manager ha registrato la relazione di replica ma non ha ancora iniziato a copiare il valore segreto. Solo il segreto della replica mostra questo stato.

InProgress

Secrets Manager sta copiando il valore segreto dal primario alla replica.

InSync

La replica contiene lo stesso valore segreto della replica primaria.

Non riuscito

Secrets Manager non è riuscito a completare la replica. Consulta Determinare la causa di una replica non riuscita.

Distaccato

Uno dei due account ha interrotto la replica, quindi i segreti primari e di replica non sono più collegati. Per ulteriori informazioni, consulta Interrompi la replica tra account.

Determinare la causa di una replica non riuscita

A Failed lo stato indica che Secrets Manager non è stato in grado di completare la replica. Rivedi il StatusMessage per determinare il motivo per cui la replica non è riuscita; contiene informazioni aggiuntive sulla causa. I motivi più comuni per cui la replica fallisce sono legati all'autorizzazione. Questi errori sono in genere uno dei seguenti:

  • Secrets Manager non è autorizzato a chiamare kms:Decrypt sulla chiave KMS principale o kms:Encrypt sulla chiave KMS di replica.

  • Secrets Manager non è in grado di assumere il ruolo di replica.

Per AWS KMS guasti, rivedi il StatusMessage per identificare l'origine del guasto. Se utilizzi una sessione di accesso diretto (FAS) anziché un ruolo di replica, verifica che l'identità del chiamante abbia i requisiti richiesti kms:Decrypt e kms:Encrypt autorizzazioni. Per ulteriori informazioni sulle autorizzazioni richieste dalla replica, vedere In che modo Secrets Manager autorizza la replica tra account.

Esempio StatusMessage valori

Gli esempi seguenti mostrano i comuni StatusMessage valori per le repliche non riuscite.

Esempio KMS:Decrypt negato sulla chiave segreta primaria
Replication failed: User: arn:aws:sts::111122223333:assumed-role/CrossAccountReplicationRole-1234567890123456789/SecretsManagerCrossAccountReplication-444455556666 is not authorized to perform: kms:Decrypt on resource: arn:aws:kms:us-west-2:111122223333:key/a8c8999a-a026-4df3-a42a-d0972222fe36 because no resource-based policy allows the kms:Decrypt action (Service: AWSKMS; Status Code: 400; Error Code: AccessDeniedException; Request ID: 12345678-1234-1234-1234-123456781234; Proxy: null)
Esempio KMS:Encrypt negato sulla chiave segreta della replica
Replication failed: User: arn:aws:sts::111122223333:assumed-role/CrossAccountReplicationRole-9876543210987654321/SecretsManagerCrossAccountReplication-444455556666 is not authorized to perform: kms:Encrypt on this resource because the resource does not exist in this Region, no resource-based policies allow access, or a resource-based policy explicitly denies access (Service: AWSKMS; Status Code: 400; Error Code: AccessDeniedException; Request ID: 87654321-4321-4321-4321-aaaabbbbcccc; Proxy: null)
Esempio Impossibile assumere il ruolo di replica
Replication failed: Secrets Manager failed to assume role arn:aws:iam::111122223333:role/CrossAccountReplicationRole

Ripristino da una replica fallita

Dopo aver corretto le autorizzazioni, il proprietario dell'account principale chiama AssociateCrossAccountReplica nuovamente per la stessa replica per riprovare a replicare. Questa chiamata non corregge le autorizzazioni; riattiva solo il tentativo di replica. Se i problemi di autorizzazione persistono, Secrets Manager aggiornerà il StatusMessage. Una volta risolti tutti i problemi di autorizzazione, la replica viene completata e lo stato cambia in InSync.

Esempio Riprovare una replica non riuscita
aws secretsmanager associate-cross-account-replica \ --secret-id MyPrimarySecret \ --cross-account-replica-arn arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3 \ --replication-role-arn arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole