Überwachung von Amazon One Enterprise-Ereignissen in Amazon EventBridge - Amazon One
Amazon One Enterprise-Veranstaltungen abonnierenEreignistypen zur Änderung des GerätestatusEreignistypen für BenutzerprofileBeispielereignisseDer Status des Geräts wurde auf „Gesund“ geändertDer Zustand des Geräts wurde auf „Kritisch“ geändertDie Gerätekonnektivität wurde auf „Online“ geändertDie Gerätekonnektivität wurde auf Offline geändert

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.

Überwachung von Amazon One Enterprise-Ereignissen in Amazon EventBridge

Sie können Amazon One Enterprise-Ereignisse überwachen EventBridge, das einen Stream von Echtzeitdaten aus Ihren eigenen Anwendungen, software-as-a-service (SaaS-) Anwendungen und AWS Diensten bereitstellt. EventBridgeleitet diese Daten an Ziele wie AWS Lambda Amazon Simple Notification Service weiter. Diese Ereignisse liefern einen Strom von Systemereignissen, die Änderungen an AWS Ressourcen beschreiben, nahezu in Echtzeit.

Amazon One Enterprise-Veranstaltungen abonnieren

Ereignisse zur Änderung des Geräte- und Benutzerprofilstatus von Amazon One werden mithilfe von Amazon One veröffentlicht und können in der EventBridge Konsole aktiviert werden EventBridge, indem eine neue Regel erstellt wird. Ereignisse werden in keiner bestimmten Reihenfolge angeboten, besitzen jedoch einen Zeitstempel, der Ihnen die Datennutzung ermöglicht. Ereignisse werden auf bestmögliche Weise ausgegeben.

Um Amazon One Enterprise-Veranstaltungen zu abonnieren

  1. Melden Sie sich bei Ihrer AWS-Konsole an unter https://console.aws.amazon.com/events/.

  2. Öffnen Sie die EventBridge Konsole unter https://console.aws.amazon.com/events/.

  3. Wählen Sie im Navigationsbereich unter Busse die Option Regeln aus.

  4. Wählen Sie Regel erstellen aus.

  5. Weisen Sie der Regel auf der Detailseite der Standardregel einen Namen zu.

  6. Wählen Sie Rule with an event pattern 8Regel mit einem Ereignismuster) und dann Next (Weiter) aus.

  7. Vergewissern Sie sich, dass auf der Seite Ereignismuster erstellen unter Ereignisquelle die Option AWS Ereignisse oder EventBridge Partnerereignisse ausgewählt ist.

  8. Wählen Sie unter Beispiel-Ereignistyp die Option AWS-Ereignisse aus.

  9. Wählen Sie als Erstellungsmethode die Option Benutzerdefiniertes Muster aus.

  10. Fügen Sie im Abschnitt Ereignismuster eine JSON-Datei mit der Ereignisquelle aws:one und dem erforderlichen Detailtyp hinzu: 

    
       "
       source": ["aws.one"],
       "detail-type": ["New Successful Enrollment", 
       "New Successful Un-enrollment",
       "Unsuccessful Enrollment", 
       "Unsuccessful Un-enrollment", 
       "Successful Recognition", 
       "Unsuccessful Recognition",
       "New Alert(s) Detected",
       "Some Alert(s) Cleared"]
       }

    Sie können den erforderlichen Detailtyp aus der obigen Liste auswählen und die nicht erforderlichen Daten entfernen.

  11. Wählen Sie Weiter aus.

  12. Wählen Sie auf der Seite Ziel (e) auswählen ein Ziel Ihrer Wahl aus, das eine Lambda-Funktion, eine SQS-Warteschlange oder ein SNS-Thema enthält. Informationen zur Konfiguration von Zielen finden Sie unter EventBridge Amazon-Ziele.

    Um beispielsweise zu sehen, wann sich jemand angemeldet hat, wählen Sie „Erfolgreiche Anerkennung“. Schauen Sie sich dann die Veranstaltungsdetails (im Anhang) an, um zu sehen, wer sich angemeldet hat.

    Um Ihren Workflow abzuschließen, können Sie eine externe API oder ein anderes Ziel ausführen.

  13. Optional können Sie Tags konfigurieren.

  14. Wählen Sie auf der Seite Überprüfen und erstellen die Option Regel erstellen aus. Weitere Informationen zur Konfiguration von Regeln finden Sie unter EventBridgeRegeln im EventBridge Benutzerhandbuch.

Ereignistypen zur Änderung des Gerätestatus

Ereignisse zur Änderung des Gerätestatus werden in JSON generiert. Für jeden Ereignistyp wird ein JSON-Blob entsprechend Ihrer Regelkonfigurierung an das Ziel Ihrer Wahl gesendet. Die folgenden Detailtypen sind verfügbar:

Einige Warnmeldungen wurden gelöscht

Das Gerät hat eine oder mehrere Integritätsprüfungen bestanden.

Neue Warnung (en) erkannt

Das Gerät hat eine oder mehrere Integritätsprüfungen nicht bestanden.

Ereignisobjekte
    Ressourcen

    Enthält die Liste der DeviceInstance-Arn, für die das Ereignis „Gerätestatusänderung“ veröffentlicht wurde.

    data

    Warnmeldungen gelöscht

    • Stellt die Integritätsprüfungen dar, bei denen die DeviceInstance zuvor nicht erfolgreich war.

    • Besteht aus einem statusCode für den Warnungstyp und einem ReporteDat-Zeitstempel.

    • Mögliche StatusCode-Werte:, NetworkDisconnected USBDisconnected

    Aktuelle Benachrichtigungen

    • Stellt den aktuellen Status der DeviceInstance dar.

    • Besteht aus einem statusCode für den Warnungstyp und einem ReporteDat-Zeitstempel.

    • Mögliche StatusCode-Werte:, NetworkDisconnected USBDisconnected

    Neue Alerts

    • Stellt neu fehlgeschlagene Integritätsprüfungen der DeviceInstance dar.

    • Besteht aus einem statusCode für den Warnungstyp und einem ReporteDat-Zeitstempel.

    • Mögliche StatusCode-Werte:, NetworkDisconnected USBDisconnected

    currentAlertsCount

    • Die Anzahl der Integritätsprüfungen, die derzeit bei DeviceInstance fehlschlagen.

    assetTagId

    • Die Nummer assetTagId des Geräts, das der DeviceInstance zugeordnet ist.

    deviceInstanceName

    • Der Name der DeviceInstance, für die das Gerätestatus-Ereignis veröffentlicht wurde.

    siteName

    • Name der Site, auf der die DeviceInstance vorhanden ist.

    SiteN

    • Arn für die Site, auf der die DeviceInstance vorhanden ist.

    Ereignistypen für Benutzerprofile

    Es gibt folgende Typen von Ereignisdetails im Zusammenhang mit Benutzerprofilen:

    Neue erfolgreiche Registrierung

    Wenn sich ein Benutzer erfolgreich registriert hat.

    Neue erfolgreiche Abmeldung

    Wenn sich ein Benutzer erfolgreich abgemeldet hat.

    Erfolglose Registrierung

    Wenn sich ein Benutzer nicht registrieren konnte.

    Abmeldung erfolglos

    Wenn ein Benutzer die Registrierung nicht abmelden konnte.

    Erfolgreiche Anerkennung

    Wenn ein Benutzer Palm erfolgreich zur Authentifizierung scannt.

    Erfolglose Anerkennung

    Wenn die Erkennung eines Handflächenscans fehlschlug.

    Ereignisobjekte
      Ressourcen

      Enthält die Liste der Benutzerprofil-ARN, für die das Benutzerprofilereignis veröffentlicht wurde.

      data

      accountId

      • Das relevante AWS Konto für das Gerät, das die Anfrage initiiert hat.

      Quelle der Anfrage

      • Dies ist das deviceInstanceId des Geräts, das die Anfrage initiiert hat.

      Zeitstempel erstellt

      • Die Uhrzeit der Erstellung des Ereignisses.

      Benutzerstatus

      • Der aktuelle Status des Benutzers.

      • Mögliche Werte: ACTIVE, DELETED

      Assoziierte ID

      • Die zugehörige ID des Benutzers, zum Beispiel die Badge-ID.

      Grund

      • Dieser Wert wird für erfolglose Ereignisse angezeigt. Er enthält den Grund, warum das Ereignis nicht erfolgreich war.

      Beispielereignisse

      Die folgenden Beispiele zeigen Ereignisse für Amazon One Enterprise.

      Der Status des Geräts wurde auf „Gesund“ geändert

      Das Gerät hat alle Zustandsprüfungen bestanden.

      {
        "version": "0",
        "id": "51e022b4-7ce6-34e0-264b-370948fc1123",
        "detail-type": "Some Alert(s) Cleared",
        "source": "aws.one",
        "account": "123456789012",
        "time": "2025-07-17T19:32:42Z",
        "region": "us-east-1",
        "resources":
        [
            "arn:aws:one:us-east-1:123456789012:deviceInstance/F5JRte5Jz21Tqx"
        ],
        "detail":
        {
            "version": "1.0.0",
            "data":
            {
                "clearedAlerts":
                [
                    {
                        "statusCode": "USBDisconnected",
                        "reportedAt": "Thu Jul 17 19:32:42 UTC 2025"
                    }
                ],
                "currentAlerts":
                [],
                "currentAlertsCount": 0,
                "assetTagId": "0000123456",
                "deviceInstanceName": "device_name",
                "siteName": "site_name",
                "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
            }
        }
      }

      Der Zustand des Geräts wurde auf „Kritisch“ geändert

      Das Gerät hat eine oder mehrere Zustandsprüfungen nicht bestanden.

      {
        "version": "0",
        "id": "07af4893-ef9f-965a-d245-3f0c8bd3c123",
        "detail-type": "New Alert(s) Detected",
        "source": "aws.one",
        "account": "123456789012",
        "time": "2025-07-17T19:26:58Z",
        "region": "us-east-1",
        "resources":
        [
            "arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234"
        ],
        "detail":
        {
            "version": "1.0.0",
            "data":
            {
                "newAlerts":
                [
                    {
                        "statusCode": "USBDisconnected",
                        "reportedAt": "Thu Jul 17 19:26:58 UTC 2025"
                    }
                ],
                "currentAlerts":
                [
                    {
                        "statusCode": "USBDisconnected",
                        "reportedAt": "Thu Jul 17 19:26:58 UTC 2025"
                    }
                ],
                "currentAlertsCount": 1,
                "assetTagId": "0000123456",
                "deviceInstanceName": "device_name",
                "siteName": "site_name",
                "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
            }
        }
      }

      Die Gerätekonnektivität wurde auf „Online“ geändert

      Das Gerät ist jetzt mit dem Internet verbunden.

      {
        "version": "0",
        "id": "e6ecea28-dd60-5061-29f8-dfbc902f4123",
        "detail-type": "Some Alert(s) Cleared",
        "source": "aws.one",
        "account": "123456789012",
        "time": "2025-07-17T18:28:23Z",
        "region": "us-east-1",
        "resources":
        [
            "arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234"
        ],
        "detail":
        {
            "version": "1.0.0",
            "data":
            {
                "clearedAlerts":
                [
                    {
                        "statusCode": "NetworkDisconnected",
                        "reportedAt": "Thu Jul 17 18:28:23 UTC 2025"
                    }
                ],
                "currentAlerts":
                [],
                "currentAlertsCount": 0,
                "assetTagId": "0000123456",
                "deviceInstanceName": "device_name",
                "siteName": "site_name",
                "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
            }
        }
      }

      Die Gerätekonnektivität wurde auf Offline geändert

      Das Gerät ist nicht mehr mit dem Internet verbunden.

      {
        "version": "0",
        "id": "e6ecea28-dd60-5061-29f8-dfbc902f4123",
        "detail-type": "New Alert(s) Detected",
        "source": "aws.one",
        "account": "123456789012",
        "time": "2025-07-17T18:28:23Z",
        "region": "us-east-1",
        "resources":
        [
            "arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234"
        ],
        "detail":
        {
            "version": "1.0.0",
            "data":
            {
                "newAlerts":
                [
                    {
                        "statusCode": "NetworkDisconnected",
                        "reportedAt": "Thu Jul 17 18:28:23 UTC 2025"
                    }
                ],
                "currentAlerts":
                [
                    {
                        "statusCode": "NetworkDisconnected",
                        "reportedAt": "Thu Jul 17 18:28:23 UTC 2025"
                    }
                ],
                "currentAlertsCount": 1,
                "assetTagId": "0000123456",
                "deviceInstanceName": "device_name",
                "siteName": "site_name",
                "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
            }
        }
      }