Monitorando eventos do Amazon One Enterprise na Amazon EventBridge

Você pode monitorar eventos do Amazon One Enterprise em EventBridge, que fornece um fluxo de dados em tempo real de seus próprios aplicativos, aplicativos software-as-a-service (SaaS) e AWS serviços. EventBridgeencaminha esses dados para destinos como o AWS Lambda Amazon Simple Notification Service. Esses eventos fornecem um fluxo quase em tempo real de eventos do sistema que descrevem mudanças nos AWS recursos.

Inscreva-se nos eventos do Amazon One Enterprise

Os eventos de alteração de status do dispositivo e do perfil do usuário do Amazon One são publicados usando EventBridge e podem ser habilitados no EventBridge console criando uma nova regra. Embora os eventos não sejam ordenados, eles têm um registro de data e hora que permite consumir os dados. Os eventos são emitidos com base no melhor esforço.

Para se inscrever nos eventos do Amazon One Enterprise

1. Faça login no seu console da AWS em https://console.aws.amazon.com/events/.

2. Abra o EventBridge console em https://console.aws.amazon.com/events/.

3. No painel de navegação, em Barramentos, selecione Regras.

4. Escolha Criar regra.

5. Na página de detalhes da regra padrão, atribua um nome à regra.

6. Escolha Rule with an event pattern (Regra com padrão de eventos), depois selecione Next (Próximo).

7. Na página Criar padrão de evento, em Origem do evento, verifique se AWS eventos ou eventos de EventBridge parceiros estão selecionados.

8. Em Tipo de evento de amostra, escolha Eventos da AWS.

9. Em Método de criação, escolha Padrão personalizado.

10. Na seção Padrão de eventos, adicione um JSON com a fonte do evento aws:one e o tipo de detalhe necessário:

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

    Você pode escolher o tipo de detalhe necessário na lista acima e remover o que não é necessário.

11. Escolha Próximo.

12. Na página Selecionar destino (s), selecione um destino de sua escolha, que inclua uma função Lambda, uma fila SQS ou um tópico do SNS. Para obter informações sobre a configuração de alvos, consulte EventBridge Destinos da Amazon.

    Por exemplo, para ver quando alguém entra, escolha “Reconhecimento bem-sucedido”. Em seguida, veja os detalhes do evento (fornecidos no Apêndice) para ver quem compareceu.

    Para concluir seu fluxo de trabalho, você pode executar uma API externa ou outro alvo.

13. Opcionalmente, você pode configurar tags.

14. Na página Revisar e criar, escolha Criar regra. Para obter mais informações sobre a configuração de regras, consulte EventBridgeas regras no Guia do EventBridge usuário.

Tipos de eventos de alteração de status do dispositivo

Os eventos de alteração do status do dispositivo são gerados em JSON. Para cada tipo de evento, um blob JSON é enviado para o destino de sua preferência, conforme configurado na regra. Os seguintes tipos de detalhes estão disponíveis:

Alguns alertas foram apagados

O dispositivo passou por uma ou mais verificações de saúde.

Novos alertas detectados

O dispositivo falhou em uma ou mais verificações de saúde.

recursos

Contém a lista de DeviceInstance arn para os quais o evento Device Status Change foi publicado.

dados

Alertas apagados

• Representa as verificações de saúde em que a DeviceInstance estava falhando anteriormente.

• Consiste em um StatusCode para o tipo de alerta e um timestamp ReportedAt.

• Valores possíveis de StatusCode:, NetworkDisconnected USBDisconnected

Alertas atuais

• Representa o status atual da DeviceInstance.

• Consiste em um StatusCode para o tipo de alerta e um timestamp ReportedAt.

• Valores possíveis de StatusCode:, NetworkDisconnected USBDisconnected

Novos alertas

• Representa verificações de saúde recém-reprovadas da DeviceInstance.

• Consiste em um StatusCode para o tipo de alerta e um timestamp ReportedAt.

• Valores possíveis de StatusCode:, NetworkDisconnected USBDisconnected

currentAlertsCount

• A contagem de verificações de saúde que falham atualmente com a DeviceInstance.

assetTagId

• O assetTagId do dispositivo associado à DeviceInstance.

deviceInstanceName

• O nome da DeviceInstance para a qual o evento de status do dispositivo foi publicado.

siteName

• Nome do site em que a DeviceInstance está presente.

SiteEarn

• Arn para o site em que a DeviceInstance está presente.

Tipos de eventos de perfil de usuário

Os tipos de detalhes do evento relacionados ao perfil do usuário são:

Nova inscrição bem-sucedida

Quando um usuário se inscreveu com sucesso.

Novo cancelamento de inscrição bem-sucedido

Quando um usuário cancelou a inscrição com sucesso.

Inscrição malsucedida

Quando um usuário não conseguiu se inscrever.

Cancelamento de inscrição malsucedido

Quando um usuário não conseguiu cancelar a inscrição.

Reconhecimento bem-sucedido

Quando um usuário digitaliza a palma da mão para autenticação com sucesso.

Reconhecimento malsucedido

Quando o reconhecimento de uma palmeira falhou.

Objetos de evento

recursos

Contém a lista de arn de perfil de usuário para os quais o evento de perfil de usuário foi publicado.

dados

accountId

• A AWS conta relevante para o dispositivo que iniciou a solicitação.

Fonte da solicitação

• Essa é a deviceInstanceId do dispositivo que iniciou a solicitação.

Carimbo de data/hora criado

• A hora em que o evento está sendo criado.

Status do usuário

• O status atual do usuário.

• Valores possíveis: ATIVO, EXCLUÍDO

ID associado

• O ID associado do usuário, por exemplo, o ID do crachá.

reason

• Esse valor será apresentado para eventos malsucedidos. Ele contém o motivo pelo qual o evento não teve sucesso.

Eventos de exemplo

Os exemplos a seguir mostram eventos do Amazon One Enterprise.

Tópicos

• O status de integridade do dispositivo foi alterado para íntegro

• O status de integridade do dispositivo foi alterado para crítico

• A conectividade do dispositivo foi alterada para online

• A conectividade do dispositivo foi alterada para off-line

O status de integridade do dispositivo foi alterado para íntegro

O dispositivo passou por todas as verificações de saúde.

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

O status de integridade do dispositivo foi alterado para crítico

O dispositivo falhou em uma ou mais verificações de saúde.

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

A conectividade do dispositivo foi alterada para online

O dispositivo agora está conectado à 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"
            }
        }
      }

A conectividade do dispositivo foi alterada para off-line

O dispositivo não está mais conectado à 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"
            }
        }
      }