Supervisión de los eventos de Amazon One Enterprise en Amazon EventBridge - Amazon Uno
Suscríbete a los eventos de Amazon One EnterpriseTipos de eventos de cambio de estado del dispositivoTipos de eventos de perfil de usuarioEjemplos de eventosEl estado de salud del dispositivo ha cambiado a saludableEl estado de salud del dispositivo cambió a críticoLa conectividad del dispositivo pasó a estar en líneaLa conectividad del dispositivo ha cambiado a fuera de línea

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Supervisión de los eventos de Amazon One Enterprise en Amazon EventBridge

Puede monitorear los eventos de Amazon One Enterprise en EventBridge, que ofrece un flujo de datos en tiempo real desde sus propias aplicaciones, aplicaciones software-as-a-service (SaaS) y AWS servicios. EventBridgedirige esos datos a objetivos como AWS Lambda Amazon Simple Notification Service. Estos eventos proporcionan un flujo casi en tiempo real de los eventos del sistema que describen los cambios en AWS los recursos.

Suscríbete a los eventos de Amazon One Enterprise

Los eventos de cambio de estado del dispositivo y del perfil de usuario de Amazon One se publican mediante EventBridge una nueva regla y se pueden activar en la EventBridge consola. Aunque los eventos no están ordenados, tienen una marca temporal que le permite consumir los datos. Los eventos se emiten en la medida de lo posible.

Para suscribirse a los eventos de Amazon One Enterprise

  1. Inicie sesión en la consola de AWS en https://console.aws.amazon.com/events/.

  2. Abra la EventBridge consola en https://console.aws.amazon.com/events/.

  3. En el panel de navegación, en Buses, elija Reglas.

  4. Seleccione Creación de regla.

  5. En la página de detalles de la regla predeterminada, asigne un nombre a la regla.

  6. Elija Rule with an event pattern (Regla con un patrón de evento) y, a continuación, elija Next (Siguiente).

  7. En la página Crear un patrón de eventos, en Origen del evento, compruebe que esté seleccionada la opción AWS Eventos o eventos EventBridge asociados.

  8. En Ejemplo de tipo de evento, elija AWS Events.

  9. En Método de creación, elija Patrón personalizado.

  10. En la sección Patrón de eventos, añade un JSON con la fuente del evento como fuente aws:one y el tipo de detalle requerido: 

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

    Puedes elegir el tipo de detalle necesario de la lista anterior y eliminar lo que no sea obligatorio.

  11. Elija Siguiente.

  12. En la página Seleccione los destinos, seleccione el destino que desee, que incluya una función Lambda, una cola de SQS o un tema de SNS. Para obtener información sobre la configuración de los objetivos, consulta Amazon EventBridge targets.

    Por ejemplo, para ver cuándo alguien se acerca, selecciona «Reconocimiento exitoso». A continuación, consulta los detalles del evento (que figuran en el apéndice) para ver quién ha registrado el evento.

    Para completar tu flujo de trabajo, puedes ejecutar una API externa u otro objetivo.

  13. Si lo desea, puede configurar las etiquetas.

  14. En la página Revisar y crear, elija Crear regla. Para obtener más información sobre la configuración de reglas, consulte EventBridgelas reglas en la Guía del EventBridge usuario.

Tipos de eventos de cambio de estado del dispositivo

Los eventos de cambio de estado del dispositivo se generan en JSON. Para cada tipo de evento, se envía un blob JSON al destino que elija, según lo configurado en la regla. Están disponibles los siguientes tipos de detalles:

Se han borrado algunas alertas

El dispositivo ha pasado uno o más controles de estado.

Se detectaron nuevas alertas

El dispositivo no pasó una o más comprobaciones de estado.

Objetos de eventos
    recursos

    Contiene la lista de los arn de DeviceInstance para los que se publicó el evento de cambio de estado del dispositivo.

    data

    Alertas borradas

    • Representa las comprobaciones de estado en las que DeviceInstance fallaba anteriormente.

    • Consta de un StatusCode para el tipo de alerta y una marca de tiempo ReportedAt.

    • Valores posibles de StatusCode:, NetworkDisconnected USBDisconnected

    Alertas actuales

    • Representa el estado actual de DeviceInstance.

    • Consta de un StatusCode para el tipo de alerta y una marca de tiempo ReportedAt.

    • Valores posibles de StatusCode:, NetworkDisconnected USBDisconnected

    Nuevas alertas

    • Representa las comprobaciones de estado de DeviceInstance que acaban de fallar.

    • Consta de un StatusCode para el tipo de alerta y una marca de tiempo ReportedAt.

    • Valores posibles de StatusCode:, NetworkDisconnected USBDisconnected

    currentAlertsCount

    • El recuento de comprobaciones de estado que fallan actualmente en DeviceInstance.

    assetTagId

    • El assetTagId del dispositivo asociado a la DeviceInstance.

    deviceInstanceName

    • El nombre de la instancia de dispositivo para la que se publicó el evento de estado del dispositivo.

    siteName

    • Nombre del sitio en el que está presente la DeviceInstance.

    SiteArn

    • Arn para el sitio en el que está presente DeviceInstance.

    Tipos de eventos de perfil de usuario

    Los tipos de detalles de eventos relacionados con el perfil de usuario son:

    Nueva inscripción exitosa

    Cuando un usuario se inscribió correctamente.

    Nueva anulación exitosa de la inscripción

    Cuando un usuario se dio de baja correctamente.

    Inscripción fallida

    Cuando un usuario no se pudo inscribir.

    Anulación de la inscripción fallida

    Cuando un usuario no pudo anular la inscripción.

    Reconocimiento exitoso

    Cuando un usuario escanea la palma de la mano para comprobar si se ha autenticado correctamente.

    Reconocimiento fallido

    Cuando falló el reconocimiento de una gammagrafía de la palma de la mano.

    Objetos de eventos
      recursos

      Contiene la lista de los campos de perfil de usuario para los que se publicó el evento del perfil de usuario.

      data

      accountId

      • La AWS cuenta correspondiente al dispositivo que inició la solicitud.

      Fuente de la solicitud

      • Es el deviceInstanceId dispositivo que inició la solicitud.

      Marca de tiempo creada

      • Hora en la que se está creando el evento.

      Estado del usuario

      • El estado actual del usuario.

      • Valores posibles: ACTIVO, ELIMINADO

      ID ASOCIADO

      • El identificador asociado del usuario, por ejemplo, el identificador de la insignia.

      razón

      • Este valor se presentará en los eventos fallidos. Contiene el motivo por el que el evento no tuvo éxito.

      Ejemplos de eventos

      En los siguientes ejemplos se muestran los eventos de Amazon One Enterprise.

      El estado de salud del dispositivo ha cambiado a saludable

      El dispositivo pasó todos los controles de estado.

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

      El estado de salud del dispositivo cambió a crítico

      El dispositivo no pasó una o más comprobaciones de estado.

      {
        "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 conectividad del dispositivo pasó a estar en línea

      El dispositivo ahora está conectado a 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 conectividad del dispositivo ha cambiado a fuera de línea

      El dispositivo ya no está conectado a 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"
            }
        }
      }