View a markdown version of this page

Configurar la autenticación por token de portador - Amazon CloudWatch Registros

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.

Configurar la autenticación por token de portador

nota

Esta página trata sobre la autenticación del token del portador para CloudWatch Registros. Para CloudWatch Métricas para la autenticación del portador del token, consulte Configurar la autenticación del token portador para Metrics en el CloudWatch Guía del usuario. Para obtener información sobre la autenticación del token del portador de rastros, consulte Configurar la autenticación del token portador para los rastreos en el X-Ray Guía para desarrolladores. Cada servicio requiere su propia clave de API.

Antes de poder enviar registros mediante la autenticación mediante un token portador a cualquiera de los puntos finales de ingestión HTTP, es necesario:

  • Crea un usuario de IAM con CloudWatch Registra los permisos

  • Genera credenciales específicas del servicio (token de portador)

  • Cree un grupo de registros y una secuencia de registros

  • Habilite la autenticación con el token del portador en el grupo de registros

importante

Siempre que sea posible, recomendamos utilizar la autenticación por SigV4 con credenciales de corta duración para todas las cargas de trabajo. SigV4 proporciona la posición de seguridad más sólida. Restrinja el uso de claves de API (tokens portadores) a los escenarios en los que la autenticación a corto plazo basada en credenciales no sea posible. Cuando esté listo para la incorporación CloudWatch Al iniciar sesión en aplicaciones con mayores requisitos de seguridad, debe cambiar a credenciales de corta duración. Para obtener más información, consulte Alternativas para las claves de acceso a largo plazo en la Guía del usuario de IAM.

Opción 1: Comience rápidamente a usar el AWS consola

El AWS La consola de administración proporciona un flujo de trabajo optimizado para generar claves de API para el acceso a puntos finales HTTP.

Para configurar el acceso HTTP a los puntos finales mediante la consola
  1. Inicie sesión en AWS Consola de administración.

  2. Navegue hasta CloudWatch > Ajustes > Registros.

  3. En la sección Claves de API, elija Generar clave de API.

  4. Para Expiración de la clave de API, realice una de las siguientes acciones:

    • Seleccione una duración de la expiración de la clave de API de 1, 5, 30, 90 o 365 días.

    • Elija Duración personalizada para especificar una fecha de expiración personalizada de la clave de API.

    • Seleccione Nunca caduca (no se recomienda).

  5. Seleccione Generar clave de API.

    La consola automáticamente:

    • Crea un nuevo usuario de IAM con los permisos adecuados

    • Adjunta el CloudWatchLogsAPIKeyAccess política gestionada (incluye logs:PutLogEvents y logs:CallWithBearerToken permisos)

    • Genera credenciales específicas del servicio (clave de API)

  6. Copie y guarde de forma segura las credenciales mostradas:

    • ID de clave de API (Service-specific ID de credencial)

    • Secreto de clave de API (token de portador)

    importante

    Guarde el secreto de clave de API inmediatamente. no la puede recuperar en otro momento. Si la pierdes, tendrás que generar una nueva clave de API.

  7. Crea el grupo de registros y la secuencia de registros en los que se almacenarán tus registros:

    # Create the log group aws logs create-log-group \ --log-group-name /aws/hlc-logs/my-application \ --region us-east-1 # Create the log stream aws logs create-log-stream \ --log-group-name /aws/hlc-logs/my-application \ --log-stream-name application-stream-001 \ --region us-east-1
  8. Habilite la autenticación con el token del portador en el grupo de registros:

    aws logs put-bearer-token-authentication \ --log-group-identifier /aws/hlc-logs/my-application \ --bearer-token-authentication-enabled \ --region us-east-1

    Verifique la configuración:

    aws logs describe-log-groups \ --log-group-name-prefix /aws/hlc-logs/my-application \ --region us-east-1

Los permisos incluyen: El usuario de IAM creado automáticamente tendrá los siguientes permisos:

  • logs:PutLogEvents — Enviar eventos de registro a CloudWatch Registros

  • logs:CallWithBearerToken — Autenticar con el token del portador

  • kms:Describe*, kms:GenerateDataKey*, kms:Decrypt — Acceso KMS-encrypted grupos de registros (con condiciones que restringen el servicio de registros)

Opción 2: configuración manual

Si prefiere tener más control sobre la configuración de IAM o necesita personalizar los permisos, puede configurar el acceso a los puntos finales HTTP manualmente.

Paso 1: Crear un usuario de IAM

Cree un usuario de IAM que se utilizará para la ingesta de registros:

  1. Inicie sesión en AWS Consola de administración y navegue hasta IAM.

  2. En el panel de navegación izquierdo, elija Usuarios.

  3. Seleccione la opción Crear un usuario.

  4. Escriba un nombre de usuario (por ejemplo, cloudwatch-logs-hlc-user).

  5. Elija Siguiente.

  6. Adjunte una de las siguientes políticas de IAM:

    Opción A: uso de la política administrada (recomendada)

    Adjunte el CloudWatchLogsAPIKeyAccess política gestionada.

    Opción B: creación de una política personalizada

    Cree y adjunte la siguiente política de IAM:

    { "Version": "2012-10-17", "Statement": [ { "Sid": "LogsAPIs", "Effect": "Allow", "Action": [ "logs:CallWithBearerToken", "logs:PutLogEvents" ], "Resource": "*" }, { "Sid": "KMSAPIs", "Effect": "Allow", "Action": [ "kms:Describe*", "kms:GenerateDataKey*", "kms:Decrypt" ], "Condition": { "StringEquals": { "kms:ViaService": [ "logs.*.amazonaws.com" ] } }, "Resource": "arn:aws:kms:*:*:key/*" } ] }
  7. Elige Siguiente y luego Crear usuario.

nota

Los permisos de KMS son necesarios si planeas enviar registros a KMS-encrypted grupos de registros. La condición restringe el acceso a KMS solo a las claves utilizadas mediante CloudWatch Servicio de registros.

Paso 2: generación de credenciales específicas del servicio (clave de API)

Genere el CloudWatch Registra la clave de API mediante el CreateServiceSpecificCredential API. También puedes usar el crear una credencial específica para un servicio comando CLI. Para la antigüedad de la credencial, puede especificar un valor entre 1 y 36 600 días. Si no especifica una antigüedad de la credencial, la clave de API no caducará.

Para generar una clave de API con una caducidad de 30 días:

aws iam create-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com \ --credential-age-days 30

La respuesta es un ServiceSpecificCredential objeto. El ServiceCredentialSecret el valor es tu CloudWatch Registra la clave de API (token portador).

importante

Guarde el valor ServiceCredentialSecret de forma segura, ya que no podrá recuperarlo más tarde. Si la pierdes, tendrás que generar una nueva clave de API.

Paso 3: Crea un grupo de registros y una secuencia de registros

Cree el grupo de registros y la secuencia de registros en los que se almacenarán sus registros:

# Create the log group aws logs create-log-group \ --log-group-name /aws/hlc-logs/my-application \ --region us-east-1 # Create the log stream aws logs create-log-stream \ --log-group-name /aws/hlc-logs/my-application \ --log-stream-name application-stream-001 \ --region us-east-1

Paso 4: Habilita la autenticación del token del portador

Habilite la autenticación con el token portador en el grupo de registros:

aws logs put-bearer-token-authentication \ --log-group-identifier /aws/hlc-logs/my-application \ --bearer-token-authentication-enabled \ --region us-east-1

Verifique la configuración:

aws logs describe-log-groups \ --log-group-name-prefix /aws/hlc-logs/my-application \ --region us-east-1

Controle los permisos de generación y uso CloudWatch Registra las claves de API

La generación y el uso de CloudWatch Las claves de la API de registros se controlan mediante claves de acción y condición tanto en CloudWatch Registros y servicios de IAM.

Controlar la generación de CloudWatch Registra las claves de API

El Objetivo:CreateServiceSpecificCredential action controla la generación de una clave específica de un servicio (como un CloudWatch Registra la clave de API). Puede limitar esta acción a los usuarios de IAM como una forma de restringir el número de usuarios para los que se puede generar una clave.

Puede utilizar las siguientes claves de condición para imponer condiciones al permiso de la acción iam:CreateServiceSpecificCredential:

  • Objetivo:ServiceSpecificCredentialAgeDays — Permite especificar, en la condición, el tiempo de caducidad de la clave en días. Por ejemplo, puede utilizar esta clave de condición para permitir únicamente la creación de claves de API que caduquen en 90 días.

  • Objetivo:ServiceSpecificCredentialServiceName — Permite especificar, en la condición, el nombre de un servicio. Por ejemplo, puedes usar esta clave de condición para permitir únicamente la creación de claves de API para CloudWatch Registros y no otros servicios.

Controlar el uso de CloudWatch Registra las claves de API

El logs:CallWithBearerToken la acción controla el uso de un CloudWatch Registra la clave de API. Para evitar que se utilice una identidad CloudWatch Registra las claves de la API y adjunta una política que niegue la logs:CallWithBearerToken acción dirigida al usuario de IAM asociada a la clave.

Ejemplos de políticas

Impedir que se genere y utilice una identidad CloudWatch Registra las claves de API

{ "Version": "2012-10-17", "Statement": [ { "Sid": "DenyCWLAPIKeys", "Effect": "Deny", "Action": [ "iam:CreateServiceSpecificCredential", "logs:CallWithBearerToken" ], "Resource": "*" } ] }
aviso

Esta política impedirá la creación de credenciales para todos AWS servicios que permiten la creación de credenciales específicas para un servicio. Para obtener más información, consulte Service-specific credenciales para los usuarios de IAM.

Impedir que una identidad utilice CloudWatch Registra las claves de API

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "logs:CallWithBearerToken", "Resource": "*" } ] }

Permite la creación de CloudWatch Registra las claves solo si caducan en 90 días

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceSpecificCredential", "Resource": "arn:aws:iam::123456789012:user/username", "Condition": { "StringEquals": { "iam:ServiceSpecificCredentialServiceName": "logs.amazonaws.com" }, "NumericLessThanEquals": { "iam:ServiceSpecificCredentialAgeDays": "90" } } } ] }

Rotación de las claves de API

Rotar las claves de API reduce el riesgo de acceso no autorizado. Recomendamos establecer un programa de rotación que se ajuste a las políticas de seguridad de la organización.

Proceso de rotación

Para rotar una clave de API sin interrumpir la entrega del registro, sigue este procedimiento:

  1. Cree una nueva credencial (secundaria) para el usuario de IAM:

    aws iam create-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com \ --credential-age-days 90
  2. (Opcional) Guarde la nueva credencial en AWS Secrets Manager para una recuperación segura y una rotación automatizada.

  3. Importe la nueva credencial al portal de su proveedor o actualice la configuración de su aplicación para usar la nueva clave de API.

  4. Establezca la credencial original como inactiva:

    aws iam update-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-specific-credential-id ACCA1234EXAMPLE1234 \ --status Inactive
  5. Verifique que la entrega de registros no se vea afectada mediante la supervisión de IncomingBytes métrica para su grupo de registros en CloudWatch. Para obtener más información, consulte Monitorización con CloudWatch métricas.

  6. Después de confirmar que la entrega se ha efectuado correctamente con la nueva clave, elimine la credencial anterior:

    aws iam delete-service-specific-credential \ --service-specific-credential-id ACCA1234EXAMPLE1234

Supervisión de la caducidad de claves

Para comprobar la fecha de creación y el estado de las claves de API existentes, use el comando list-service-specific-credentials:

aws iam list-service-specific-credentials \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com

La respuesta incluye CreateDate y Status para cada credencial. Use esta información para identificar las claves que están a punto de caducar o que han estado activas durante más tiempo del que permite la política de rotación.

Respuesta a una clave de API comprometida

Si sospecha que una clave de API se ha visto comprometida, siga estos pasos de inmediato:

  1. Desactive la clave inmediatamente para evitar un uso no autorizado posterior:

    aws iam update-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-specific-credential-id ACCA1234EXAMPLE1234 \ --status Inactive
  2. Revisión CloudTrail registros para determinar el alcance del acceso no autorizado. Consulte Registrando el uso de las claves de API con CloudTrail para obtener información sobre cómo habilitar la auditoría del uso de claves de API.

  3. Cree una clave de reemplazo según el proceso de rotación descrito en Proceso de rotación.

  4. Elimine la clave comprometida una vez que se haya hecho la sustitución:

    aws iam delete-service-specific-credential \ --service-specific-credential-id ACCA1234EXAMPLE1234
  5. Adjunte una política de denegación si necesita bloquear inmediatamente todo acceso al token de portador para el usuario de IAM mientras lo investiga:

    { "Version": "2012-10-17", "Statement": { "Effect": "Deny", "Action": "logs:CallWithBearerToken", "Resource": "*" } }
nota

Para llevar a cabo estas acciones a través de la API, debes autenticarte con AWS credenciales y no con un CloudWatch Registra la clave de API.

También puede usar las siguientes operaciones de la API de IAM para administrar las claves comprometidas:

  • ResetServiceSpecificCredential — Restablece la clave para generar una nueva contraseña sin eliminar la credencial. La clave no debe haber caducado.

Prácticas recomendadas de seguridad para claves de API

Siga estas prácticas recomendadas para proteger su CloudWatch Registra las claves de la API:

  • Nunca inserte claves de API en el código fuente. No codifique las claves de API en el código de la aplicación ni las guarde en los sistemas de control de versiones. Si una clave se guarda accidentalmente en un repositorio público, AWS el escaneo automático puede detectarla y deberías rotar la clave inmediatamente.

  • Use un administrador de secretos. Almacene las claves de API en AWS Secrets Manager o una solución de administración de secretos equivalente. Esto permite el control de acceso centralizado, el registro de auditorías y la rotación automática.

  • Establezca una caducidad para todas las claves. Especifique siempre un valor de --credential-age-days al crear las claves de API. Para garantizar una vida útil máxima de las claves en toda la organización, utilice la clave de condición de iam:ServiceSpecificCredentialAgeDays IAM. Para ver un ejemplo, consulta Permite la creación de CloudWatch Registra las claves solo si caducan en 90 días.

  • Aplique permisos de privilegio mínimo. Limite los permisos del usuario de IAM únicamente a los grupos de registro y las acciones necesarios. Utilice el gestionado CloudWatchLogsAPIKeyAccess la política como punto de partida y restrinja aún más según sea necesario.

  • Habilitar CloudTrail registro. Audite el uso de las claves de API habilitando CloudTrail eventos de datos para AWS::Logs::LogGroupAuthorization. Consulte Registrando el uso de las claves de API con CloudTrail.

  • Supervise con el Analizador de acceso de IAM. Utilice el Analizador de acceso de IAM para identificar las credenciales no utilizadas y las políticas excesivamente permisivas asociadas a los usuarios de IAM de la clave de API.

  • Rote las claves con regularidad. Establezca una planificación de rotación y siga el proceso descrito en Rotación de las claves de API.

Registrando el uso de las claves de API con CloudTrail

Puede usar AWS CloudTrail para registrar eventos de datos para CloudWatch Registra el uso de las claves de API. CloudWatch Registra las emisiones AWS::Logs::LogGroupAuthorization eventos de datos para CallWithBearerToken llamadas, lo que le permite auditar cuándo y cómo se utilizan las claves de API para enviar registros.

Para habilitar CloudTrail iniciar sesión para CloudWatch Registra el uso de la clave de API:

nota

El bucket de S3 que especifiques para la ruta debe tener una política de bucket que permita CloudTrail para escribir archivos de registro en él. Para obtener más información, consulte Política de cubos de Amazon S3 para CloudTrail.

  1. Cree un registro de seguimiento:

    aws cloudtrail create-trail \ --name cloudwatch-logs-api-key-audit \ --s3-bucket-name my-cloudtrail-bucket \ --region us-east-1
  2. Configure los selectores de eventos avanzados para capturar CloudWatch Registra los eventos de autorización de grupos:

    aws cloudtrail put-event-selectors \ --region us-east-1 \ --trail-name cloudwatch-logs-api-key-audit \ --advanced-event-selectors '[{ "Name": "CloudWatch Logs API key authorization events", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::Logs::LogGroupAuthorization"] } ] }]'
  3. Inicie el registro de seguimiento:

    aws cloudtrail start-logging \ --name cloudwatch-logs-api-key-audit \ --region us-east-1