View a markdown version of this page

Protokollierung AWS Private Certificate Authority API-Aufrufe mit AWS CloudTrail - AWS Private Certificate Authority

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Protokollierung AWS Private Certificate Authority API-Aufrufe mit AWS CloudTrail

AWS Private Certificate Authority ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einem Benutzer, einer Rolle oder einem AWS Dienst in ausgeführt wurden AWS Private CA. CloudTrail erfasst API-Aufrufe und Signiervorgänge für AWS Private CA AS-Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der AWS Private CA Konsole und Codeaufrufen an die AWS Private CA API-Operationen. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übertragung von CloudTrail Ereignissen an einen Amazon S3-Bucket aktivieren, einschließlich Ereignissen für AWS Private CA. Wenn Sie keinen Trail konfigurieren, können Sie trotzdem die neuesten Ereignisse in der CloudTrail Konsole im Event-Verlauf einsehen. Anhand der gesammelten Informationen können Sie ermitteln CloudTrail, an welche Anfrage gestellt wurde AWS Private CA, von welcher IP-Adresse aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde und weitere Details.

Weitere Informationen CloudTrail dazu finden Sie im AWS CloudTrail Benutzerhandbuch.

AWS Private CA Informationen in CloudTrail

CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn eine Aktivität stattfindet AWS Private CA, wird diese Aktivität zusammen mit anderen CloudTrail AWS Serviceereignissen im Veranstaltungsverlauf in einem Ereignis aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem anzeigen, suchen und herunterladen AWS-Konto. Weitere Informationen finden Sie unter Ereignisse mit dem CloudTrail Eventverlauf anzeigen.

Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS-Konto, einschließlich der Ereignisse für AWS Private CA, erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen in der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3-Bucket. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier:

Alle AWS Private CA Aktionen werden von der AWS Private CA API-Referenz protokolliert CloudTrail und in dieser dokumentiert. Beispielsweise generieren Aufrufe von IssueCertificate und CreateAuditReport Aktionen Einträge in den CloudTrail Protokolldateien. ImportCACertificate

Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:

  • Ob die Anfrage mit Root- oder AWS Identity and Access Management (IAM-) Benutzeranmeldeinformationen gestellt wurde.

  • Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.

  • Ob die Anfrage von einem anderen AWS Dienst gestellt wurde.

Weitere Informationen finden Sie unter CloudTrail -Element userIdentity.

Anmerkung

Sie können Ihren CloudTrail Trail so konfigurieren, dass Ereignisse zusätzlich zu Amazon S3 an Amazon CloudWatch Logs übertragen werden. Nach der Konfiguration empfängt CloudWatch Logs dieselben AWS Private CA Ereignisse, die an Ihren S3-Bucket übermittelt werden. AWS Private CA veröffentlicht Ereignisse nicht direkt in CloudWatch Logs. Weitere Informationen finden Sie im AWS CloudTrail Benutzerhandbuch unter Ereignisse an CloudWatch Logs senden.

Informationen darüber, wie Ereignisse CloudTrail übermittelt werden — einschließlich Zeitpunkt, Dauer und Integration mit anderen AWS Diensten — finden Sie unter Abrufen und Anzeigen Ihrer CloudTrail Protokolldateien und im AWS CloudTrail Service Level Agreement.

AWS Private CA Verwaltungsereignisse

AWS Private CA lässt sich in integrieren CloudTrail , um API-Aktionen aufzuzeichnen, die von einem Benutzer, einer Rolle oder einem AWS Dienst in ausgeführt AWS Private CA werden. Sie können CloudTrail es verwenden, um AWS Private CA API-Anfragen in Echtzeit zu überwachen und Protokolle in Amazon Simple Storage Service, Amazon CloudWatch Logs und Amazon CloudWatch Events zu speichern. AWS Private CA unterstützt die Protokollierung der folgenden Aktionen und Operationen als Ereignisse in CloudTrail Protokolldateien:

Anmerkung

CloudTrail bietet einen Echtzeit-Ereignisstrom von API-Aufrufen und Signaturvorgängen. Eine vollständige Bestandsaufnahme aller Zertifikate, die Ihre private CA ausgestellt oder gesperrt hat, einschließlich Gültigkeitsdaten und Sperrstatus, finden Sie unter. Verwenden Sie Auditberichte mit Ihrer privaten Zertifizierungsstelle

Identifizierung des ursprünglichen Anforderers

Wenn ein Zwischendienst IssueCertificate im Namen von Endbenutzern oder Workloads anruft, zeichnet das CloudTrail Ereignis die IAM-Identität des Zwischendienstes vor userIdentity Ort auf — nicht den ursprünglichen Anforderer.

Um die Ausstellung des Zertifikats bis zum ursprünglichen Anforderer zurückzuverfolgen, kann der Zwischendienst Identitätsinformationen mithilfe von Standard-IAM-Mechanismen weitergeben:

  • Sitzungs-Tags — Der Zwischendienst übergibt identifizierende Informationen (wie die ID des ursprünglichen Anforderers) als Sitzungs-Tags, wenn er seine IAM-Rolle über übernimmt. AWS STS Diese Tags werden im userIdentity Block des CloudTrail Ereignisses unter angezeigt. sessionContext Weitere Informationen finden Sie unter Übergeben von Sitzungs-Tags in AWS STS.

  • Quellidentität — Der Zwischendienst legt eine Quellidentität fest, wenn er seine Rolle übernimmt. Die Quellidentität ist über Rollenketten hinweg unveränderlich und erscheint in CloudTrail alssourceIdentity. Weitere Informationen finden Sie unter Überwachung und Steuerung von Maßnahmen, die im Zusammenhang mit übernommenen Rollen ergriffen wurden.

  • IAM Roles Anywhere — Wenn sich der aufrufende Workload über IAM Roles Anywhere mit einem X.509 Zertifikat authentifiziert, werden die Felder Subject, Issuer und Subject Alternative Name (SAN) des Zertifikats automatisch den Sitzungsprinzipal-Tags zugeordnet. Eine SPIFFE-ID im SAN wird beispielsweise als angezeigt. aws:PrincipalTag/x509SAN/URI Weitere Informationen finden Sie unter Das IAM Roles Anywhere-Vertrauensmodell.

Diese Identitätsattribute werden bei allen AWS Serviceaufrufen, einschließlich AWS Private CA API-Vorgängen, in CloudTrail Ereignissen aufgezeichnet.

AWS Private CA Service-Ereignisse

AWS Private CA Generiert zusätzlich zu den bei API-Aufrufen aufgezeichneten Verwaltungsereignissen auch Serviceereignisse, die einen Einblick in interne Abläufe bieten, die in Ihrem Namen ausgeführt werden. Diese Ereignisse haben ein eventType Aus AwsServiceEvent und werden automatisch in Ihrem CloudTrail Trail protokolliert.

IssueCertificateDetails event

AWS Private CA generiert ein IssueCertificateDetails Ereignis, wenn ein Versuch, ein Zertifikat auszustellen, abgeschlossen wird. Das Ereignis zeichnet das Ergebnis auf — ob das Zertifikat erfolgreich ausgestellt wurde oder ob die Ausstellung fehlgeschlagen ist — und beschreibt den Prozess der Zertifikatsausstellung, einschließlich Details wie:

  • Die TBS-Zertifikatsstruktur (zu signieren) (base64-kodierter DER)

  • Name, Autoritätsschlüssel-ID und Seriennummer der ausstellenden Zertifizierungsstelle

  • Seriennummer, Betreff und Gültigkeitsdauer des ausgestellten Zertifikats

  • Der verwendete Signaturalgorithmus und die verwendete Vorlage

  • Ausstellungsstatus mit Angabe einer Fehlerursache, falls zutreffend

Wenn ein Zertifikat von einer gemeinsam genutzten Zertifizierungsstelle ausgestellt wird, wird das Ereignis sowohl dem Konto des CA-Besitzers als auch dem Konto des Antragstellers zugestellt. Bei fehlgeschlagenen Ausstellungsversuchen kann das Ereignis ein statusReason Feld mit einer Erläuterung der Fehlerursache enthalten.

Anmerkung

Die IssueCertificateDetails Veranstaltung ergänzt die bestehende SignCertificate Veranstaltung durch zusätzliche Metadaten zur Ausstellung, einschließlich Fehlerdetails und des vollständigen TBS-Zertifikatsinhalts.

Beispiel: Erfolgreiche Ausstellung des Zertifikats

Das folgende Beispiel zeigt ein IssueCertificateDetails Ereignis für ein erfolgreich ausgestelltes Zertifikat.

{ "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" }
Beispiel: Fehlgeschlagene Zertifikatsausstellung

Das folgende Beispiel zeigt ein IssueCertificateDetails Ereignis für eine fehlgeschlagene Zertifikatsausstellung. Wenn die Ausstellung fehlschlägt, ist das status Feld FAILED und das statusReason Feld beschreibt die Ursache. Die Gültigkeitsfelder (notBefore,notAfter) und issuedAt werden weggelassen, da kein Zertifikat ausgestellt wurde. Aus dem TBS-Zertifikat abgeleitete Felder (tbsCertificate,, subject issuerNameserialNumber, undissuerAuthorityKeyIdentifier) sind nur vorhanden, wenn der Fehler nach der AWS Private CA Generierung des TBS-Zertifikats aufgetreten ist.

{ "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" }

In der folgenden Tabelle werden die Felder im serviceEventDetails Objekt beschrieben.

Feld Description
tbsCertificate Die Base64-kodierte DER-Darstellung der TBS-Zertifikatsstruktur (zum Signieren). Enthält dieselben Informationen, die im ausgestellten Zertifikat enthalten sind. Bei fehlgeschlagener Ausstellung nur vorhanden, wenn der Fehler nach der Generierung des TBS-Zertifikats aufgetreten ist.
issuerAuthorityKeyIdentifier Die Autoritätsschlüssel-ID der ausstellenden CA, die aus den TBS-Zertifikatserweiterungen extrahiert und als durch Doppelpunkte getrennte Hexadezimal-Bytes formatiert wurde. Wird weggelassen, wenn das Zertifikat die Erweiterung für die Autoritätsschlüssel-ID nicht enthält (z. B. selbstsignierte Stammzertifikate der Zertifizierungsstelle) und bei fehlgeschlagener Ausstellung, wenn der Fehler vor der Generierung des TBS-Zertifikats aufgetreten ist.
issuerSerialNumber Die Seriennummer des ausstellenden CA-Zertifikats, formatiert als durch Doppelpunkte getrennte Hexadezimal-Bytes. Wird weggelassen, wenn das CA-Zertifikat nicht verfügbar ist.
issuerName Der eindeutige Name (DN) der ausstellenden CA aus dem TBS-Zertifikat. Bei fehlgeschlagener Ausstellung nur vorhanden, wenn der Fehler nach der Generierung des TBS-Zertifikats aufgetreten ist.
subject Der eindeutige Name (DN) des Zertifikatsantragstellers aus dem TBS-Zertifikat. Bei fehlgeschlagener Ausstellung nur vorhanden, wenn der Fehler nach der Generierung des TBS-Zertifikats aufgetreten ist.
serialNumber Die Seriennummer des Zertifikats, formatiert als durch Doppelpunkte getrennte Hexadezimal-Bytes. Bei fehlgeschlagener Ausstellung nur vorhanden, wenn der Fehler nach der Generierung des TBS-Zertifikats aufgetreten ist.
notBefore Der Beginn der Gültigkeitsdauer des Zertifikats im ISO 8601-Format. Wird weggelassen, wenn die Ausstellung fehlgeschlagen ist.
notAfter Das Ende der Gültigkeitsdauer des Zertifikats im ISO 8601-Format. Wird weggelassen, wenn die Ausstellung fehlgeschlagen ist.
issuedAt Der Zeitstempel, zu dem das Zertifikat im ISO 8601-Format ausgestellt wurde. Wird weggelassen, wenn die Ausstellung fehlgeschlagen ist.
templateArn Der ARN der für die Ausstellung verwendeten Zertifikatsvorlage.
signingAlgorithm Der verwendete Signaturalgorithmus (z. B. ECDSAWITHSHA256 oderSHA256WITHRSA).
status Das Ergebnis des Emissionsversuchs: ISSUED oderFAILED. AWS Private CA zeichnet ein IssueCertificateDetails Ereignis erst auf, wenn die Emission einen dieser Endstatus erreicht hat. Dieses Feld ist also nie der Fall. PENDING Ein Zertifikat, das noch verarbeitet wird, generiert erst dann ein Ereignis, wenn die Ausstellung erfolgreich ist oder fehlschlägt. Verwenden Sie diese Option, GetCertificate um den Status eines Zertifikats zu überprüfen, dessen Ereignis noch nicht eingetreten ist.
statusReason Der Grund für das Scheitern der Ausstellung. Nur vorhanden, wenn ein Grund für den Ausfall verfügbar ist. Bei einigen Ereignissen, bei denen eine Ausstellung fehlgeschlagen ist, ist dieses Feld nicht enthalten.
requesterAccountId Die AWS-Konto ID, die das Zertifikat angefordert hat. Nur vorhanden, wenn die Anfrage nicht von einem AWS Dienst in Ihrem Namen gestellt wurde.
requesterArn Die ARN des Prinzipals, der das Zertifikat angefordert hat. Nur vorhanden, wenn die Anfrage nicht von einem AWS Dienst in Ihrem Namen gestellt wurde.
requesterServicePrincipal Der AWS Service Principal (z. B.acm.amazonaws.com), der das Zertifikat in Ihrem Namen angefordert hat. Nur vorhanden, wenn ein AWS Dienst die Anfrage gestellt hat.
Anmerkung

Einige Zertifikatsausstellungen werden einem internen AWS Prozess und nicht einem Auftraggeber des Kunden zugeschrieben. In diesen Fällen umfasst das Ereignis keines der requesterServicePrincipal FelderrequesterAccountId,requesterArn, oder. Gehen Sie nicht davon aus, dass eines dieser drei Felder immer vorhanden ist.

Beispiel AWS Private CA Veranstaltungen

Ein Trail ist eine Konfiguration, die die Übermittlung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Logdateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, daher erscheinen sie in keiner bestimmten Reihenfolge.

Im Folgenden finden Sie Beispiele für AWS Private CA CloudTrail Ereignisse.

Beispiel 1: Management-Event, IssueCertificate

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die IssueCertificate Aktion veranschaulicht.

{ "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" } }
Beispiel 2: Management-Ereignis, ImportCertificateAuthorityCertificate

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die ImportCertificateAuthorityCertificate Aktion veranschaulicht.

{ "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" }