View a markdown version of this page

Registrazione dei log AWS Autorità di certificazione privata Chiamate API utilizzando AWS CloudTrail - AWS Autorità di certificazione privata

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

Registrazione dei log AWS Autorità di certificazione privata Chiamate API utilizzando AWS CloudTrail

AWS Autorità di certificazione privata è integrato con AWS CloudTrail un servizio che fornisce una registrazione delle azioni intraprese da un utente, ruolo o AWS servizio in AWS Private CA. CloudTrail acquisisce le chiamate API e le operazioni di firma per gli eventi AWS Private CA as. Le chiamate acquisite includono chiamate dalla AWS Private CA console e chiamate in codice alle operazioni AWS Private CA API. Se crei un percorso, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per. AWS Private CA Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli eventi. Utilizzando le informazioni raccolte da CloudTrail, puoi determinare la richiesta a cui è stata effettuata AWS Private CA, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e dettagli aggiuntivi.

Per saperne di più CloudTrail, consulta la Guida AWS CloudTrail per l'utente.

AWS Private CA informazioni in CloudTrail

CloudTrail è abilitato sull'utente al Account AWS momento della creazione dell'account. Quando si verifica un'attività in AWS Private CA, tale attività viene registrata in un CloudTrail evento insieme ad altri eventi AWS di servizio nella cronologia degli eventi. Puoi visualizzare, cercare e scaricare gli eventi recenti nel tuo Account AWS. Per ulteriori informazioni, consulta Visualizzazione degli eventi con la cronologia degli CloudTrail eventi.

Per una registrazione continua degli eventi nel tuo account Account AWS, inclusi gli eventi per AWS Private CA, crea un percorso. Un percorso consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un percorso nella console, questo sarà valido in tutte le Regioni AWS. Il percorso registra gli eventi provenienti da tutte le regioni della AWS partizione e invia i file di registro al bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati degli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta gli argomenti seguenti:

Tutte AWS Private CA le azioni vengono registrate CloudTrail e documentate nel riferimento AWS Private CA API. Ad esempio, le chiamate a IssueCertificate e ImportCACertificate le CreateAuditReport azioni generano voci nei file di CloudTrail registro.

Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:

  • Se la richiesta è stata effettuata con credenziali utente root o AWS Identity and Access Management (IAM).

  • Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato.

  • Se la richiesta è stata effettuata da un altro AWS servizio.

Per ulteriori informazioni, consulta Elemento CloudTrail userIdentity.

Nota

Puoi configurare il tuo CloudTrail percorso per inviare eventi ad Amazon CloudWatch Logs oltre che ad Amazon S3. Una volta configurato, CloudWatch Logs riceve gli stessi AWS Private CA eventi che vengono inviati al bucket S3. AWS Private CA non pubblica eventi direttamente in Logs. CloudWatch Per ulteriori informazioni, vedere Invio di eventi ai CloudWatch log nella Guida per l'AWS CloudTrail utente.

Per informazioni sulle modalità CloudTrail di erogazione degli eventi, compresi i tempi di consegna, la durata e l'integrazione con altri AWS servizi, consulta Ottenere e visualizzare i file di CloudTrail registro e il AWS CloudTrail Service Level Agreement.

AWS Private CA eventi di gestione

AWS Private CA si integra CloudTrail per registrare le azioni API eseguite da un utente, un ruolo o un AWS servizio in AWS Private CA. Puoi utilizzarlo CloudTrail per monitorare le richieste AWS Private CA API in tempo reale e archiviare i log in Amazon Simple Storage Service, Amazon CloudWatch Logs e Amazon CloudWatch Events. AWS Private CA supporta la registrazione delle seguenti azioni e operazioni come eventi nei file di CloudTrail registro:

Nota

CloudTrail fornisce un flusso di eventi in tempo reale di chiamate API e operazioni di firma. Per un inventario completo e puntuale di tutti i certificati emessi o revocati dalla tua CA privata, comprese le date di validità e lo stato di revoca, consulta. Utilizza i report di audit con la tua CA privata

Identificazione del richiedente originale

Quando un servizio intermedio chiama per IssueCertificate conto di utenti finali o carichi di lavoro, l' CloudTrail evento registra l'identità IAM del servizio intermedio userIdentity sul campo, non il richiedente originale.

Per far risalire l'emissione del certificato al richiedente originale, il servizio intermedio può propagare le informazioni sull'identità utilizzando meccanismi IAM standard:

  • Tag di sessione: il servizio intermedio trasmette le informazioni identificative (come l'ID del richiedente originale) come tag di sessione quando assume il ruolo IAM tramite. AWS STS Questi tag vengono visualizzati nel blocco dell' CloudTrail evento in basso. userIdentity sessionContext Per ulteriori informazioni, consulta Passare i tag di sessione in AWS STS.

  • Identità di origine: il servizio intermedio imposta un'identità di origine quando ne assume il ruolo. L'identità di origine è immutabile in tutte le catene di ruoli e viene visualizzata come. CloudTrail sourceIdentity Per ulteriori informazioni, consulta Monitoraggio e controllo delle azioni intraprese con ruoli presunti.

  • IAM Roles Anywhere: se il carico di lavoro chiamante si autentica con un X.509 certificato tramite IAM Roles Anywhere, i campi Subject, Issuer e Subject Alternative Name (SAN) del certificato vengono automaticamente mappati ai tag principali della sessione. Ad esempio, un ID SPIFFE nella SAN appare come. aws:PrincipalTag/x509SAN/URI Per ulteriori informazioni, consulta il modello di fiducia IAM Roles Anywhere.

Questi attributi di identità vengono registrati negli CloudTrail eventi per tutte le chiamate AWS di servizio, incluse le operazioni AWS Private CA API.

AWS Private CA eventi di servizio

Oltre agli eventi di gestione registrati dalle chiamate API, AWS Private CA genera eventi di servizio che forniscono visibilità sulle operazioni interne eseguite per conto dell'utente. Questi eventi sono eventType disattivati AwsServiceEvent e vengono registrati automaticamente nel tuo CloudTrail percorso.

Evento IssueCertificateDetails.

AWS Private CA genera un IssueCertificateDetails evento quando viene completato un tentativo di emissione del certificato. L'evento registra l'esito, indipendentemente dal fatto che il certificato sia stato emesso correttamente o che l'emissione non sia riuscita, e descrive il processo di emissione del certificato, inclusi dettagli come:

  • La struttura del certificato TBS (da firmare) (DER con codifica base64)

  • Il nome, l'identificatore della chiave di autorità e il numero di serie della CA emittente

  • Il numero di serie, l'oggetto e il periodo di validità del certificato emesso

  • L'algoritmo di firma e il modello utilizzati

  • Stato dell'emissione con un motivo del mancato rilascio, se applicabile

Quando un certificato viene emesso da una CA condivisa, l'evento viene inviato sia all'account del proprietario della CA che a quello del richiedente. Per i tentativi di emissione falliti, l'evento può includere il statusReason campo che spiega la causa dell'errore.

Nota

L'IssueCertificateDetailsevento integra l'SignCertificateevento esistente fornendo metadati aggiuntivi sull'emissione, inclusi i dettagli dell'errore e il contenuto completo del certificato TBS.

Esempio: emissione del certificato avvenuta con successo

L'esempio seguente mostra un IssueCertificateDetails evento relativo a un certificato rilasciato con successo.

{ "eventVersion": "1.11", "userIdentity": { "accountId": "111122223333", "invokedBy": "acm-pca.amazonaws.com" }, "eventTime": "2026-08-10T15:27:20Z", "eventSource": "acm-pca.amazonaws.com", "eventName": "IssueCertificateDetails", "awsRegion": "us-west-2", "sourceIPAddress": "acm-pca.amazonaws.com", "userAgent": "acm-pca.amazonaws.com", "requestParameters": null, "responseElements": null, "eventID": "83fecbfe-7e3a-4a14-8968-c99ad2d30d39", "readOnly": false, "resources": [ { "accountId": "111122223333", "type": "AWS::ACMPCA::CertificateAuthority", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01" }, { "accountId": "111122223333", "type": "AWS::ACMPCA::Certificate", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01/certificate/1a98eb0323009660dff81ac79ab4539e" } ], "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "serviceEventDetails": { "tbsCertificate": "MIIBZaADAgECAhAamOsDIwCWYN...", "issuerAuthorityKeyIdentifier": "16:E9:CC:B3:8A:DE:98:0F:10:BB:48:53:A4:1D:FD:A5:F2:EC:FE:5D", "issuerSerialNumber": "01", "issuerName": "CN=Example Intermediate CA", "subject": "CN=www.example.com", "serialNumber": "1A:98:EB:03:23:00:96:60:DF:F8:1A:C7:9A:B4:53:9E", "notBefore": "2026-08-10T14:27:20Z", "notAfter": "2026-08-17T15:27:20Z", "issuedAt": "2026-08-10T15:27:20Z", "templateArn": "arn:aws:acm-pca:::template/EndEntityCertificate/V1", "signingAlgorithm": "ECDSAWITHSHA256", "status": "ISSUED" }, "eventCategory": "Management" }
Esempio: emissione del certificato non riuscita

L'esempio seguente mostra un IssueCertificateDetails evento relativo all'emissione di un certificato non riuscita. Quando l'emissione non riesce, il status campo è FAILED e il statusReason campo descrive la causa. I campi di validità (notBefore,notAfter) e issuedAt vengono omessi perché non è stato emesso alcun certificato. I campi derivati dal certificato TBS (tbsCertificate,, subject issuerNameserialNumber, eissuerAuthorityKeyIdentifier) sono presenti solo quando l'errore si è verificato dopo la AWS Private CA generazione del certificato TBS.

{ "eventVersion": "1.11", "userIdentity": { "accountId": "111122223333", "invokedBy": "acm-pca.amazonaws.com" }, "eventTime": "2026-08-10T15:27:20Z", "eventSource": "acm-pca.amazonaws.com", "eventName": "IssueCertificateDetails", "awsRegion": "us-west-2", "sourceIPAddress": "acm-pca.amazonaws.com", "userAgent": "acm-pca.amazonaws.com", "requestParameters": null, "responseElements": null, "eventID": "fedcba98-7654-3210-fedc-ba9876543210", "readOnly": false, "resources": [ { "accountId": "111122223333", "type": "AWS::ACMPCA::CertificateAuthority", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01" }, { "accountId": "111122223333", "type": "AWS::ACMPCA::Certificate", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01/certificate/d6b81f1bf0563e97c29584a55c3ea553" } ], "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "serviceEventDetails": { "tbsCertificate": "MIIBZaADAgECAhAamOsDIwCWYN...", "issuerAuthorityKeyIdentifier": "16:E9:CC:B3:8A:DE:98:0F:10:BB:48:53:A4:1D:FD:A5:F2:EC:FE:5D", "issuerSerialNumber": "01", "issuerName": "CN=Example Intermediate CA", "subject": "CN=www.example.com", "serialNumber": "D6:B8:1F:1B:F0:56:3E:97:C2:95:84:A5:5C:3E:A5:53", "templateArn": "arn:aws:acm-pca:::template/EndEntityCertificate/V1", "signingAlgorithm": "ECDSAWITHSHA256", "status": "FAILED", "statusReason": "Name Constraints violation: DNS name not found in a permitted subtree." }, "eventCategory": "Management" }

La tabella seguente descrive i campi dell'oggetto. serviceEventDetails

Campo Description
tbsCertificate La rappresentazione DER con codifica in base64 della struttura del certificato TBS (da firmare). Contiene le stesse informazioni che appaiono nel certificato emesso. In caso di emissione non riuscita, presente solo se l'errore si è verificato dopo la generazione del certificato TBS.
issuerAuthorityKeyIdentifier L'identificatore della chiave di autorità della CA emittente, estratto dalle estensioni del certificato TBS e formattato come byte esadecimali separati da due punti. Omesso quando il certificato non include l'estensione dell'identificatore della chiave di autorità (ad esempio, certificati CA radice autofirmati) e in caso di emissione non riuscita se l'errore si è verificato prima della generazione del certificato TBS.
issuerSerialNumber Il numero di serie del certificato CA emittente, formattato come byte esadecimali separati da due punti. Omesso quando il certificato CA non è disponibile.
issuerName Il nome distinto (DN) della CA emittente, tratto dal certificato TBS. In caso di emissione non riuscita, presente solo se l'errore si è verificato dopo la generazione del certificato TBS.
subject Il nome distinto (DN) del soggetto del certificato, tratto dal certificato TBS. In caso di emissione non riuscita, presente solo se l'errore si è verificato dopo la generazione del certificato TBS.
serialNumber Il numero di serie del certificato, formattato come byte esadecimali separati da due punti. In caso di emissione non riuscita, è presente solo se l'errore si è verificato dopo la generazione del certificato TBS.
notBefore L'inizio del periodo di validità del certificato in formato ISO 8601. Omesso se l'emissione non è riuscita.
notAfter La fine del periodo di validità del certificato in formato ISO 8601. Omesso se l'emissione non è riuscita.
issuedAt Il timestamp in cui il certificato è stato emesso in formato ISO 8601. Omesso se l'emissione non è riuscita.
templateArn L'ARN del modello di certificato utilizzato per l'emissione.
signingAlgorithm L'algoritmo di firma utilizzato (ad esempio, ECDSAWITHSHA256 oSHA256WITHRSA).
status L'esito del tentativo di emissione: ISSUED oFAILED. AWS Private CA registra un IssueCertificateDetails evento solo dopo che l'emissione ha raggiunto uno di questi stati terminali, quindi questo campo non lo è mai. PENDING Un certificato ancora in fase di elaborazione non genera un evento finché l'emissione non ha esito positivo o negativo; viene utilizzato GetCertificate per verificare lo stato di un certificato il cui evento non è ancora apparso.
statusReason Il motivo del mancato rilascio. Presente solo quando è disponibile un motivo dell'errore; alcuni eventi di emissione non riuscita non includono questo campo.
requesterAccountId L' Account AWS ID che ha richiesto il certificato. Presente solo quando la richiesta non è stata effettuata da un AWS servizio per tuo conto.
requesterArn L'ARN del mandante che ha richiesto il certificato. Presente solo quando la richiesta non è stata effettuata da un AWS servizio per tuo conto.
requesterServicePrincipal Il responsabile del AWS servizio (ad esempioacm.amazonaws.com) che ha richiesto il certificato per tuo conto. Presente solo quando un AWS servizio ha effettuato la richiesta.
Nota

Alcune emissioni di certificati sono attribuite a un AWS processo interno anziché al committente principale. In questi casi, l'evento non include nessuno dei requesterServicePrincipal campirequesterAccountId,requesterArn, o. Non date per scontato che uno di questi tre campi sia sempre presente.

Esempio AWS Private CA eventi

Un trail è una configurazione che consente l'invio di eventi come file di log a un bucket Amazon S3 specificato. CloudTrail i file di log contengono una o più voci di registro. Un evento rappresenta una singola richiesta da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di log non sono una traccia ordinata dello stack delle chiamate API pubbliche, quindi non vengono visualizzati in un ordine specifico.

Di seguito sono riportati alcuni esempi di AWS Private CA CloudTrail eventi.

Esempio 1: evento di gestione, IssueCertificate

L'esempio seguente mostra una voce di CloudTrail registro che illustra l'IssueCertificateazione.

{ "version":"0", "id":"event_ID", "detail-type":"ACM Private CA Certificate Issuance", "source":"aws.acm-pca", "account":"account", "time":"2019-11-04T19:57:46Z", "region":"region", "resources":[ "arn:aws:acm-pca:us-east-1:111122223333:certificate-authority/11223344-1234-1122-2233-112233445566", "arn:aws:acm-pca:region:account:certificate-authority/CA_ID/certificate/certificate_ID" ], "detail":{ "result":"success" } }
Esempio 2: evento di gestione, ImportCertificateAuthorityCertificate

L'esempio seguente mostra una voce di CloudTrail registro che illustra l'ImportCertificateAuthorityCertificateazione.

{ "eventVersion":"1.05", "userIdentity":{ "type":"IAMUser", "principalId":"account", "arn":"arn:aws:iam::account:user/name", "accountId":"account", "accessKeyId":"key_ID" }, "eventTime":"2018-01-26T21:53:28Z", "eventSource":"acm-pca.amazonaws.com", "eventName":"ImportCertificateAuthorityCertificate", "awsRegion":"region", "sourceIPAddress":"IP_address", "userAgent":"agent", "requestParameters":{ "certificateAuthorityArn":"arn:aws:acm-pca:us-east-1:111122223333:certificate-authority/11223344-1234-1122-2233-112233445566", "certificate":{ "hb":[ 45, 45, ...10 ], "offset":0, "isReadOnly":false, "bigEndian":true, "nativeByteOrder":false, "mark":-1, "position":1257, "limit":1257, "capacity":1257, "address":0 }, "certificateChain":{ "hb":[ 45, 45, ...10 ], "offset":0, "isReadOnly":false, "bigEndian":true, "nativeByteOrder":false, "mark":-1, "position":1139, "limit":1139, "capacity":1139, "address":0 } }, "responseElements":null, "requestID":"request_ID", "eventID":"event_ID", "eventType":"AwsApiCall", "recipientAccountId":"account" }