View a markdown version of this page

Amazonas EventBridge Unterstützung für ACM - AWS Zertifikatsmanager

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.

Amazonas EventBridge Unterstützung für ACM

In diesem Thema werden die von Amazon unterstützten ACM-bezogenen Ereignisse aufgeführt und beschrieben EventBridge.

Ereignis „ACM-Zertifikat nähert sich dem Ablauf“

ACM sendet tägliche Ablaufereignisse für alle aktiven Zertifikate (öffentlich, privat und importiert), die 45 Tage vor dem Ablauf beginnen für private/imported Zertifikate und 30 Tage vor Ablauf für öffentliche Zertifikate. Dieser Zeitpunkt kann mit Hilfe von geändert werden PutAccountConfiguration Aktion der ACM-API.

ACM leitet automatisch die Verlängerung berechtigter Zertifikate ein, die es ausgestellt hat. Importierte Zertifikate müssen jedoch vor Ablauf erneut ausgestellt und importiert werden, um Ausfälle zu vermeiden. Weitere Informationen finden Sie unter Erneuter Import eines öffentlichen Zertifikats. Sie können Ablaufereignisse verwenden, um einen automatisierten erneuten Import von Zertifikaten in ACM einzurichten. Für ein Beispiel für Automatisierung mit AWS Lambda, siehe Aktionen mit Amazon einleiten EventBridge in ACM.

Ereignisse des Typs ACM-Zertifikat nähert sich dem Ablauf haben die folgende Struktur.

{ "version": "0", "id": "id", "detail-type": "ACM Certificate Approaching Expiration", "source": "aws.acm", "account": "account", "time": "2020-09-30T06:51:08Z", "region": "region", "resources": [ "arn:aws:acm:region:account:certificate/certificate_ID" ], "detail": { "DaysToExpiry": 31, "CommonName": "example.com", "FirstSubjectAlternativeName": "example.com", "ValidityInDays": 90, "CertificateKeyPairOrigin": "AWS_MANAGED" | "ACME" | "CUSTOMER_PROVIDED", "AcmeAccountId": "acme_account_id", "AcmeEndpointArn": "arn:aws:acm:region:account:acme-endpoint/endpoint_ID" } }

Ereignis „ACM-Zertifikat abgelaufen“

Anmerkung

Ereignisse mit abgelaufenem Zertifikat sind nicht verfügbar für importierte Zertifikate.

Kunden können per Listener auf dieses Ereignis achten, um benachrichtigt zu werden, wenn ein von ACM ausgestelltes öffentliches oder privates Zertifikat in ihrem Konto abläuft.

Ereignisse des Typs ACM-Zertifikat abgelaufen haben die folgende Struktur.

{ "version": "0", "id": "id", "detail-type": "ACM Certificate Expired", "source": "aws.acm", "account": "account", "time": "2019-12-22T18:43:48Z", "region": "region", "resources": [ "arn:aws:acm:region:account:certificate/certificate_ID" ], "detail": { "CertificateType" : "AMAZON_ISSUED" | "PRIVATE", "CommonName": "example.com", "FirstSubjectAlternativeName": "example.com", "ValidityInDays": 90, "CertificateKeyPairOrigin": "AWS_MANAGED" | "ACME" | "CUSTOMER_PROVIDED", "AcmeAccountId": "acme_account_id", "AcmeEndpointArn": "arn:aws:acm:region:account:acme-endpoint/endpoint_ID", "DomainValidationMethod" : "EMAIL" | "DNS", "CertificateCreatedDate" : "2018-12-22T18:43:48Z", "CertificateExpirationDate" : "2019-12-22T18:43:48Z", "InUse" : TRUE | FALSE, "Exported" : TRUE | FALSE } }

Ereignis „ACM-Zertifikat verfügbar“

Kunden können per Listener auf dieses Ereignis achten, um benachrichtigt zu werden, wenn ein verwaltetes öffentliches oder privates Zertifikat einsatzbereit ist. Das Ereignis wird bei Ausgabe, Verlängerung und Import veröffentlicht. Bei einem privaten Zertifikat muss der Kunde, sobald es verfügbar ist, immer noch Maßnahmen ergreifen, um es für Hosts bereitzustellen.

Ereignisse des Typs ACM-Zertifikat verfügbar haben die folgende Struktur.

{ "version": "0", "id": "id", "detail-type": "ACM Certificate Available", "source": "aws.acm", "account": "account", "time": "2019-12-22T18:43:48Z", "region": "region", "resources": [ "arn:aws:acm:region:account:certificate/certificate_ID" ], "detail": { “Action” : "ISSUANCE" | "RENEWAL" | "IMPORT" | "REIMPORT", "CertificateType" : "AMAZON_ISSUED" | "PRIVATE" | "IMPORTED", "CommonName": "example.com", "FirstSubjectAlternativeName": "example.com", "ValidityInDays": 90, "CertificateKeyPairOrigin": "AWS_MANAGED" | "ACME" | "CUSTOMER_PROVIDED", "AcmeAccountId": "acme_account_id", "AcmeEndpointArn": "arn:aws:acm:region:account:acme-endpoint/endpoint_ID", "DomainValidationMethod" : "EMAIL" | "DNS", "CertificateCreatedDate" : "2019-12-22T18:43:48Z", "CertificateExpirationDate" : "2019-12-22T18:43:48Z", "DaysToExpiry" : 198, "InUse" : TRUE | FALSE, "Exported" : TRUE | FALSE } }

Ereignis „Aktion zur Verlängerung des ACM-Zertifikats erforderlich“

Anmerkung

Die Ereignisse „Aktion zur Zertifikatsverlängerung erforderlich“ sind nicht verfügbar für importierte Zertifikate.

Kunden können per Listener auf dieses Ereignis achten, um benachrichtigt zu werden, wenn eine Kundenaktion erforderlich ist, bevor ein Zertifikat erneuert werden kann. Wenn beispielsweise ein Kunde CAA-Einträge hinzufügt, die ACM daran hindern, ein Zertifikat zu verlängern, veröffentlicht ACM dieses Ereignis, wenn die automatische Verlängerung 45 Tage vor Ablauf bei privaten Zertifikaten und 30 Tage vor Ablauf bei öffentlichen Zertifikaten fehlschlägt. Wenn der Kunde nichts unternimmt, unternimmt ACM weitere Verlängerungsversuche nach 30 Tagen (nur für private Zwecke), 15 Tagen, 3 Tagen und 1 Tag oder bis der Kunde Maßnahmen ergreift, das Zertifikat abläuft oder das Zertifikat nicht mehr verlängert werden kann. Für jeden dieser Verlängerungsversuche wird ein Ereignis veröffentlicht.

Ereignisse des Typs Aktion zur Verlängerung des ACM-Zertifikats erforderlich haben die folgende Struktur.

{ "version": "0", "id": "id", "detail-type": "ACM Certificate Renewal Action Required", "source": "aws.acm", "account": "account", "time": "2019-12-22T18:43:48Z", "region": "region", "resources": [ "arn:aws:acm:region:account:certificate/certificate_ID" ], "detail": { "CertificateType" : "AMAZON_ISSUED" | "PRIVATE", "CommonName": "example.com", "FirstSubjectAlternativeName": "example.com", "ValidityInDays": 90, "CertificateKeyPairOrigin": "AWS_MANAGED", "DomainValidationMethod" : "EMAIL" | "DNS", "RenewalStatusReason" : "CAA_ERROR" | "PENDING_DOMAIN_VALIDATION" | "NO_AVAILABLE_CONTACTS" | "ADDITIONAL_VERIFICATION_REQUIRED" | "DOMAIN_NOT_ALLOWED" | "INVALID_PUBLIC_DOMAIN" | "DOMAIN_VALIDATION_DENIED" | "PCA_LIMIT_EXCEEDED" | "PCA_INVALID_ARN" | "PCA_INVALID_STATE" | "PCA_REQUEST_FAILED" | "PCA_NAME_CONSTRAINTS_VALIDATION" | "PCA_RESOURCE_NOT_FOUND" | "PCA_INVALID_ARGS" | "PCA_INVALID_DURATION" | "PCA_ACCESS_DENIED" | "SLR_NOT_FOUND" | "OTHER", "DaysToExpiry": 30, "CertificateExpirationDate" : "2019-12-22T18:43:48Z", "InUse" : TRUE | FALSE, "Exported" : TRUE | FALSE } }

Ereignis „ACM-Zertifikat widerrufen“

Kunden können sich dieses Ereignis anhören, um sie zu benachrichtigen, wenn ein von ACM ausgestelltes öffentliches oder privates Zertifikat in ihrem Konto gesperrt wird.

Anmerkung

Nur exportierte Zertifikate können gesperrt werden. Importierte Zertifikate können nicht per Revoke-Certificate widerrufen werden.

ACM-Zertifikat widerrufen Ereignisse haben die folgende Struktur.

{ "version": "0", "id": "id", "detail-type": "ACM Certificate Revoked", "source": "aws.acm", "account": "account", "time": "2019-12-22T18:43:48Z", "region": "region", "resources": [ "arn:aws:acm:region:account:certificate/certificate_ID" ], "detail": { "CertificateType" : "AMAZON_ISSUED" | "PRIVATE", "CommonName": "example.com", "FirstSubjectAlternativeName": "example.com", "ValidityInDays": 90, "CertificateKeyPairOrigin": "AWS_MANAGED" | "ACME" | "CUSTOMER_PROVIDED", "AcmeAccountId": "acme_account_id", "AcmeEndpointArn": "arn:aws:acm:region:account:acme-endpoint/endpoint_ID", "CertificateExpirationDate" : "2019-12-22T18:43:48Z", "Exportable": TRUE | FALSE } }

AWS Ereignisse im Gesundheitsbereich

AWS Gesundheitsereignisse werden für ACM-Zertifikate generiert, die für eine Verlängerung in Frage kommen. Weitere Informationen zur Erneuerungsberechtigung finden Sie unter Verwaltete Zertifikatsverlängerung in AWS Certificate Manager.

Zustandsereignisse werden in zwei Szenarien generiert:

  • Bei erfolgreicher Erneuerung eines öffentlichen oder privaten Zertifikats.

  • Wenn ein Kunde Maßnahmen ergreifen muss, damit eine Erneuerung stattfindet. Dies kann bedeuten, dass Sie einen Link in einer E-Mail-Nachricht auswählen (für per E-Mail validierte Zertifikate) oder einen Fehler beheben müssen. Einer der folgenden Ereigniscodes ist in jedem Ereignis enthalten. Die Codes werden als Variablen angezeigt, die Sie zum Filtern verwenden können.

    • AWS_ACM_RENEWAL_STATE_CHANGE(das Zertifikat wurde erneuert, ist abgelaufen oder läuft ab)

    • CAA_CHECK_FAILURE(CAA-Prüfung fehlgeschlagen)

    • AWS_ACM_RENEWAL_FAILURE(für von einer privaten Zertifizierungsstelle signierte externe Zertifikate)

Health Ereignisse haben die folgende Struktur. In diesem Beispiel wird für eineAWS_ACM_RENEWAL_STATE_CHANGE-Ereignis generiert wurde.

{ "source":[ "aws.health" ], "detail-type":[ "AWS Health Event" ], "detail":{ "service":[ "ACM" ], "eventTypeCategory":[ "scheduledChange" ], "eventTypeCode":[ "AWS_ACM_RENEWAL_STATE_CHANGE" ] } }