Creación de una integración con un socio de CloudTrail con la consola - AWS CloudTrail

Creación de una integración con un socio de CloudTrail con la consola

Cuando crea una integración con un origen de eventos externo a AWS, puede elegir uno de estos socios como origen de eventos. Cuando crea una integración en CloudTrail con una aplicación asociada, el socio necesita el nombre de recurso de Amazon (ARN) del canal que usted crea en este flujo de trabajo para enviar eventos a CloudTrail. Después de que crea la integración, termina de configurarla según las instrucciones del socio para proporcionarle el ARN del canal requerido. La integración comienza a ingerir eventos de socios en CloudTrail después de que el socio llama a PutAuditEvents en el canal de la integración.

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudTrail en https://console.aws.amazon.com/cloudtrail/.

  2. En el panel de navegación, en Lago, elija Integraciones.

  3. En la página Agregar integración, ingrese un nombre para el canal. El nombre puede tener entre 3 y 128 caracteres. Solo se permiten letras, números, puntos, guiones medios y guiones bajos.

  4. Elija el origen de la aplicación asociada del que desea obtener los eventos. Si realiza la integración con eventos de sus aplicaciones alojadas en las instalaciones o en la nube, elija My custom integration (Mi integración personalizada).

  5. En Event delivery location (Ubicación de entrega de eventos), elija registrar los mismos eventos de actividad en los almacenes de datos de eventos existentes o cree un almacén de datos de eventos nuevo.

    Si elige crear un almacén de datos de eventos nuevo, ingrese un nombre para el almacén de datos de eventos, elija una opción de precios y especifique el periodo de retención en días. El almacén de datos de eventos retiene los datos de eventos durante el número especificado de días.

    Si decide registrar los eventos de actividad en uno o más almacenes de datos de eventos existentes, elija los almacenes de datos de eventos de la lista. Los almacenes de datos de eventos solo pueden incluir eventos de actividad. El tipo de evento en la consola debe ser Events from integrations (Eventos de integraciones). En la API, el valor eventCategory debe ser ActivityAuditLog.

  6. En Resource policy (Política de recursos), configure la política de recursos para el canal de la integración. Las políticas de recursos son documentos de política JSON que especifican qué acciones puede realizar una entidad principal especificada en el recurso y bajo qué condiciones. Las cuentas definidas como entidades principales en la política de recursos pueden llamar a la API PutAuditEvents para enviar eventos al canal. El propietario del recurso tiene acceso implícito al recurso si la política de IAM permite la acción cloudtrail-data:PutAuditEvents.

    La información necesaria para la política está determinada por el tipo de integración. Para una integración directa, CloudTrail agrega de forma automática los ID de la cuenta de AWS del socio y requiere que usted ingrese el ID externo único proporcionado por el socio. Para la integración de una solución, debe especificar al menos un ID de cuenta de AWS como entidad principal y, si lo desea, puede ingresar un ID externo para evitar un suplente confuso.

    nota

    Si no se crea una política de recursos para el canal, solo el propietario del canal puede llamar a la API PutAuditEvents del canal.

    1. Para una integración directa, ingrese el ID externo proporcionado por el socio. El socio de integración proporciona un ID externo único, como un ID de cuenta o una cadena generada de forma aleatoria, que se utiliza en la integración para evitar un suplente confuso. Es responsabilidad del socio crear y proporcionar un ID externo único.

      Puede elegir How to find this? (¿Cómo encontrar esto?) para ver la documentación del socio que describe cómo encontrar el ID externo.

      Documentación de socios para ID externos
      nota

      Si la política de recursos incluye un ID externo, todas las llamadas a la API PutAuditEvents deben incluir el ID externo. Sin embargo, si la política no define un ID externo, el socio aún puede llamar a la API PutAuditEvents y especificar un parámetro externalId.

    2. Para una integración de solución, elija Agregar cuenta de AWS para especificar el ID de una cuenta de AWS que se agregará como entidad principal en la política.

  7. (Opcional) En el área Tags (Etiquetas), puede agregar hasta 50 pares de claves y valores de etiquetas para que lo ayuden a identificar, ordenar y controlar el acceso al almacén de datos de eventos y al canal. Para obtener más información sobre cómo utilizar las políticas de IAM para autorizar el acceso a un almacén de datos de eventos en función de etiquetas, consulte Ejemplos: Denegación de acceso para crear o eliminar almacenes de datos de eventos en función de etiquetas. Para obtener más información sobre cómo puede utilizar las etiquetas en AWS, consulte Etiquetado de los recursos de AWS en la Referencia general de AWS.

  8. Cuando esté listo para crear la integración nueva, elija Add integration (Agregar integración). No hay página de revisión. CloudTrail crea la integración, pero usted debe proporcionar el nombre de recurso de Amazon (ARN) del canal a la aplicación asociada. Las instrucciones para proporcionar el ARN del canal a la aplicación asociada se encuentran en el sitio web de documentación de socios. Para obtener más información, elija el enlace Learn more (Más información) del socio en la pestaña Available sources (Orígenes disponibles) de la página Integrations (Integraciones) para abrir la página del socio en AWS Marketplace.

Para finalizar la configuración de la integración, proporcione el ARN del canal a la aplicación asociada o de origen. En función del tipo de integración, usted, el socio o la aplicación ejecutarán la API PutAuditEvents para enviar eventos de actividad al almacén de datos de eventos de su cuenta de AWS. Una vez que se envían los eventos de actividad, puede utilizar CloudTrail Lake para buscar, consultar y analizar los datos que se registran de las aplicaciones. Los datos de eventos incluyen campos que coinciden con la carga útil de eventos de CloudTrail, como eventVersion, eventSource y userIdentity.