Surveillance des événements Amazon One Enterprise sur Amazon EventBridge - Amazon One

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Surveillance des événements Amazon One Enterprise sur Amazon EventBridge

Vous pouvez surveiller les événements Amazon One Enterprise dans EventBridge, qui fournit un flux de données en temps réel à partir de vos propres applications, applications software-as-a-service (SaaS) et AWS services. EventBridgeachemine ces données vers des cibles telles qu' AWS Lambda Amazon Simple Notification Service. Ces événements fournissent un flux d'événements système en temps quasi réel qui décrivent les modifications apportées aux AWS ressources.

Abonnez-vous aux événements Amazon One Enterprise

Les événements de modification du statut de l'appareil et du profil utilisateur Amazon One sont publiés à l'aide EventBridge de la EventBridge console et peuvent être activés dans celle-ci en créant une nouvelle règle. Bien que les événements ne soient pas classés, ils ont un horodatage qui vous permet de consommer les données. Les événements sont générés dans la mesure du possible.

Pour vous abonner aux événements Amazon One Enterprise
  1. Connectez-vous à votre console AWS à l'adresse https://console.aws.amazon.com/events/.

  2. Ouvrez la EventBridge console à l'adresse https://console.aws.amazon.com/events/.

  3. Dans le volet de navigation, sous Bus, sélectionnez Rules.

  4. Choisissez Créer une règle.

  5. Sur la page de détail de la règle par défaut, attribuez un nom à la règle.

  6. Sélectionnez Rule with an event pattern (Règle avec un modèle d'événement), puis sélectionnez Next (Suivant).

  7. Sur la page Créer un modèle d'événement, sous Source de l'événement, vérifiez que AWS les événements ou les événements EventBridge partenaires sont sélectionnés.

  8. Sous Exemple de type d'événement, sélectionnez AWS Events.

  9. Pour Méthode de création, choisissez Motif personnalisé.

  10. Dans la section Modèle d'événement, ajoutez un JSON avec la source de l'événement comme aws:one et le type de détail requis :

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

    Vous pouvez choisir le type de détail requis dans la liste ci-dessus et supprimer les informations inutiles.

  11. Choisissez Suivant.

  12. Sur la page Sélectionner une ou plusieurs cibles, sélectionnez une cible de votre choix, qui inclut une fonction Lambda, une file d'attente SQS ou un sujet SNS. Pour plus d'informations sur la configuration des cibles, consultez la section Amazon EventBridge Targets.

    Par exemple, pour savoir quand quelqu'un se connecte, choisissez « Reconnaissance réussie ». Regardez ensuite le détail de l'événement (donné en annexe) pour voir qui s'est inscrit.

    Pour terminer votre flux de travail, vous pouvez exécuter une API externe ou une autre cible.

  13. Vous pouvez éventuellement configurer des balises.

  14. Sur la page Vérifier et créer, choisissez Créer une règle. Pour plus d'informations sur la configuration des règles, consultez EventBridgeles règles du Guide de EventBridge l'utilisateur.

Types d'événements de modification de l'état de l'appareil

Les événements de changement d'état de l'appareil sont générés au format JSON. Pour chaque type d'événement, un blob JSON est envoyé à la cible de votre choix, comme configuré dans la règle. Les types de détails suivants sont disponibles :

Certaines alertes ont été supprimées

L'appareil a passé un ou plusieurs tests de santé.

Nouvelle (s) alerte (s) détectée (s)

L'appareil a échoué à un ou plusieurs tests de santé.

Objets Event
    resources

    Contient la liste des ARN DeviceInstance pour lesquels l'événement Device Status Change a été publié.

    data

    Alertes effacées

    • Représente les tests de santé auxquels l'instance DeviceInstance avait échoué précédemment.

    • Se compose d'un StatusCode pour le type d'alerte et d'un horodatage ReportatAt.

    • Valeurs possibles du StatusCode :, NetworkDisconnected USBDisconnected

    Alertes en cours

    • Représente l'état actuel de l'instance DeviceInstance.

    • Se compose d'un StatusCode pour le type d'alerte et d'un horodatage ReportatAt.

    • Valeurs possibles du StatusCode :, NetworkDisconnected USBDisconnected

    Nouvelles alertes

    • Représente les nouveaux échecs de vérification de l'état de l'instance DeviceInstance.

    • Se compose d'un StatusCode pour le type d'alerte et d'un horodatage ReportatAt.

    • Valeurs possibles du StatusCode :, NetworkDisconnected USBDisconnected

    currentAlertsCount

    • Le nombre de contrôles de santé échouant actuellement avec le DeviceInstance.

    assetTagId

    • Le assetTagId de l'appareil associé à la DeviceInstance.

    deviceInstanceName

    • Nom de l'instance DeviceInstance pour laquelle l'événement Device Status a été publié.

    Nom du site

    • Nom du site sur lequel le DeviceInstance est présent.

    Site Earn

    • Arn pour le site où le DeviceInstance est présent.

    Types d'événements du profil utilisateur

    Les types de détails des événements liés au profil utilisateur sont les suivants :

    Nouvelle inscription réussie

    Lorsqu'un utilisateur s'est inscrit avec succès.

    Nouvelle désinscription réussie

    Lorsqu'un utilisateur s'est désinscrit avec succès.

    Inscription infructueuse

    Lorsqu'un utilisateur ne parvient pas à s'inscrire.

    Désinscription infructueuse

    Lorsqu'un utilisateur ne parvient pas à se désinscrire.

    Reconnaissance réussie

    Lorsqu'un utilisateur scanne Palm pour s'authentifier avec succès.

    Reconnaissance infructueuse

    Lorsque la reconnaissance d'un scan de la paume a échoué.

    Objets Event
      resources

      Contient la liste des ARN de profil utilisateur pour lesquels l'événement de profil utilisateur a été publié.

      data

      accountId

      • Le AWS compte correspondant à l'appareil à l'origine de la demande.

      Source de la demande

      • Il s'agit deviceInstanceId de l'appareil à l'origine de la demande.

      Horodatage créé

      • Heure de création de l'événement.

      État de l'utilisateur

      • État actuel de l'utilisateur.

      • Valeurs possibles : ACTIVE, DELETED

      ID associé

      • L'identifiant associé de l'utilisateur, par exemple l'identifiant du badge.

      raison

      • Cette valeur s'affichera en cas d'échec des événements. Il contient la raison pour laquelle l'événement a échoué.

      Exemples d'événements

      Les exemples suivants présentent des événements pour Amazon One Enterprise.

      L'état de santé de l'appareil est passé à sain

      L'appareil a passé tous les tests de santé.

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

      L'état de santé de l'appareil est passé à critique

      L'appareil a échoué à un ou plusieurs tests de santé.

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

      La connectivité de l'appareil est passée en ligne

      L'appareil est désormais connecté à Internet.

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

      La connectivité de l'appareil est passée en mode hors ligne

      L'appareil n'est plus connecté à Internet.

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