Registrando o Fleet Hub para chamadas da API de gerenciamento de AWS IoT dispositivos com AWS CloudTrail

O Fleet Hub for AWS IoT Device Management está integrado ao AWS CloudTrail. O CloudTrail serviço fornece um registro das ações que um usuário, função ou AWS serviço realiza no Fleet Hub. CloudTrail captura todas as chamadas de API para o Fleet Hub como eventos. As chamadas capturadas incluem as do console do Fleet Hub e as chamadas de código para as operações da API do Fleet Hub.

Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para o Fleet Hub. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no Histórico de eventos.

Usando as informações CloudTrail coletadas, você pode determinar a solicitação que foi feita ao Fleet Hub, o endereço IP a partir do qual a solicitação foi feita, quem fez a solicitação e quando, além de mais detalhes.

Para saber mais sobre isso CloudTrail, consulte o Guia AWS CloudTrail do usuário.

Informações do Fleet Hub em CloudTrail

AWS CloudTrail é ativado em sua AWS conta quando você cria a conta. Quando a atividade ocorre no Fleet Hub, essa atividade é registrada em um CloudTrail evento com outros eventos AWS de serviço no histórico de eventos. É possível visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte Visualização de eventos com histórico de CloudTrail eventos.

Para um registro contínuo dos eventos em sua AWS conta, incluindo eventos do Fleet Hub, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon Simple Storage Service (Amazon S3). Por padrão, quando uma trilha é criada no console, a mesma é aplicada a todas as regiões da AWS . A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do Amazon S3 que você especificar.

Você também pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros. Para obter mais informações, consulte:

• Visão geral da criação de uma trilha

• CloudTrail serviços e integrações suportados

• Configurando notificações do Amazon SNS para CloudTrail

• Recebendo arquivos de CloudTrail log de várias regiões

• Receber arquivos de log do CloudTrail de várias contas

CloudTrail registra todas as ações do Fleet Hub. Eles estão documentados na Referência da API AWS IoT. Por exemplo, chamadas para as UpdateApplication ações CreateApplication e geram entradas nos arquivos de CloudTrail log.

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte:

• Se a solicitação foi feita com credenciais raiz ou de AWS Identity and Access Management usuário

• Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado

• Se a solicitação foi feita por outro AWS serviço

Para obter mais informações, consulte Elemento userIdentity do CloudTrail .

Compreendendo as entradas do arquivo de log do Fleet Hub para gerenciamento de AWS IoT dispositivos

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log a um bucket do Amazon S3 especificado.

CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte, e inclui informações sobre a ação solicitada, data e hora da ação, parâmetros da solicitação e assim por diante.

CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica.

exemplo

A entrada de CloudTrail registro a seguir mostra informações sobre a CreateApplication ação.

    {
        "eventVersion": "1.08",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "principal-id",
            "arn": "arn:aws:sts::123456789012:assumed-role/Admin/test-user-name",
            "accountId": "123456789012",
            "accessKeyId": "access-key",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "principal-id",
                    "arn": "arn:aws:iam::123456789012:role/Admin",
                    "accountId": "123456789012",
                    "userName": "Admin"
                },
                "webIdFederationData": {},
                "attributes": {
                    "mfaAuthenticated": "false",
                    "creationDate": "2020-12-04T19:59:53Z"
                }
            }
        },
        "eventTime": "2020-12-04T20:02:38Z",
        "eventSource": "iotfleethub.amazonaws.com",
        "eventName": "CreateApplication",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "72.22.186.61",
        "userAgent": "console.amazonaws.com",
        "requestParameters": {
            "applicationDescription": "Test application description",
            "applicationName": "Test application name",
            "clientToken": "c9bc7f45-3737-4ee9-9b0f-5de1aab169b2"
        },
        "responseElements": {
            "applicationUrl": "https://application-id.app.iotfleethub.aws",
            "applicationArn": "arn:aws:iotfleethub:us-east-1:123456789012:application/application-id",
            "applicationId": "application-id"
        },
        "requestID": "5456304e-31c5-4336-9bbe-a375e3728eee",
        "eventID": "9ffb5d72-9267-4f4e-88e6-d26051133c8c",
        "readOnly": false,
        "eventType": "AwsApiCall",
        "recipientAccountId": "123456789012"
    }