Registrar las llamadas a la API de Fleet Hub para la administración de AWS IoT dispositivos con AWS CloudTrail

Fleet Hub for AWS IoT Device Management está integrado con AWS CloudTrail. El CloudTrail servicio proporciona un registro de las acciones que realiza un usuario, un rol o un AWS servicio en Fleet Hub. CloudTrail captura todas las llamadas a la API de Fleet Hub como eventos. Las llamadas capturadas incluyen las realizadas desde la consola Fleet Hub y las llamadas de código a las operaciones de API de Fleet Hub.

Si crea una ruta, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos de Fleet Hub. Si no configuras una ruta, podrás ver los eventos más recientes en la CloudTrail consola, en el historial de eventos.

Con la información CloudTrail recopilada, puedes determinar la solicitud que se realizó a Fleet Hub, la dirección IP desde la que se realizó la solicitud, quién la hizo y cuándo, y más detalles.

Para obtener más información CloudTrail, consulta la Guía AWS CloudTrail del usuario.

La información de Fleet Hub se encuentra en CloudTrail

AWS CloudTrail está habilitada en tu AWS cuenta al crearla. Cuando se produce una actividad en Fleet Hub, esa actividad se registra en un CloudTrail evento junto con otros eventos de AWS servicio en el historial de eventos. Puede ver, buscar y descargar los últimos eventos de la cuenta de AWS . Para obtener más información, consulte Visualización de eventos con el historial de CloudTrail eventos.

Para tener un registro continuo de los eventos de tu AWS cuenta, incluidos los eventos de Fleet Hub, crea una ruta. Un registro permite CloudTrail entregar los archivos de registro a un bucket de Amazon Simple Storage Service (Amazon S3). De manera predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las regiones de AWS . La ruta registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al bucket de Amazon S3 que especifique.

También puede configurar otros AWS servicios para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar en función de ellos. Para más información, consulte los siguientes temas:

• Introducción a la creación de registros de seguimiento

• CloudTrail servicios e integraciones compatibles

• Configuración de las notificaciones de Amazon SNS para CloudTrail

• Recibir archivos de CloudTrail registro de varias regiones

• Recepción de archivos de registro de CloudTrail de varias cuentas

CloudTrail registra todas las acciones de Fleet Hub. Estas acciones se encuentran en la documentación de referencia de las API de AWS IoT. Por ejemplo, las llamadas a las UpdateApplication acciones CreateApplication y las acciones generan entradas en los archivos de CloudTrail registro.

Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente:

• Si la solicitud se realizó con credenciales raíz o AWS Identity and Access Management de usuario

• si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado

• Si la solicitud la realizó otro AWS servicio

Para obtener más información, consulte el elemento userIdentity de CloudTrail .

Descripción de las entradas del archivo de registro de Fleet Hub para la administración de AWS IoT dispositivos

Un registro de seguimiento es una configuración que permite la entrega de eventos como archivos de registros en un bucket de Amazon S3 que especifique.

CloudTrail los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud específica realizada desde un origen cualquiera y contiene información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc.

CloudTrail Los archivos de registro no son un seguimiento ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico.

ejemplo

La siguiente entrada de CloudTrail registro muestra información sobre la CreateApplication acción.

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