

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLP-MetricsBearerTokenAuth.html) 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](https://docs.aws.amazon.com/xray/latest/devguide/xray-opentelemetry-bearer-token.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-workloads-use-roles) en la *Guía del usuario de IAM*.

## Opción 1: Comience rápidamente a usar el AWS consola
<a name="CWL_HTTP_Endpoints_Console_Setup"></a>

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.

1. Navegue hasta **CloudWatch** > **Ajustes** > **Registros**.

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

1. 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).

1. Seleccione **Generar clave de API**.

   La consola automáticamente:
   + Crea un nuevo usuario de IAM con los permisos adecuados
   + Adjunta el [CloudWatchLogsAPIKeyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsAPIKeyAccess.html) política gestionada (incluye `logs:PutLogEvents` y `logs:CallWithBearerToken` permisos)
   + Genera credenciales específicas del servicio (clave de API)

1. 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.

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

   ```bash
   # 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
   ```

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

   ```bash
   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:

   ```bash
   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
<a name="CWL_HTTP_Endpoints_Manual_Setup"></a>

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
<a name="CWL_HTTP_Endpoints_Manual_Step1"></a>

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.

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

1. Seleccione la opción **Crear un usuario**.

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

1. Elija **Siguiente**.

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

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

   Adjunte el [CloudWatchLogsAPIKeyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsAPIKeyAccess.html) política gestionada.

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

   Cree y adjunte la siguiente política de IAM:

   ```JSON
   {
       "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/*"
           }
       ]
   }
   ```

1. 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)
<a name="CWL_HTTP_Endpoints_Manual_Step2"></a>

Genere el CloudWatch Registra la clave de API mediante el [CreateServiceSpecificCredential](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateServiceSpecificCredential.html) API. También puedes usar el [crear una credencial específica para un servicio](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-service-specific-credential.html) 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:

```bash
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](https://docs.aws.amazon.com/IAM/latest/APIReference/API_ServiceSpecificCredential.html) 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
<a name="CWL_HTTP_Endpoints_Manual_Step3"></a>

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

```bash
# 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
<a name="CWL_HTTP_Endpoints_Manual_Step4"></a>

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

```bash
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:

```bash
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
<a name="CWL_HTTP_Endpoints_API_Key_Permissions"></a>

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
<a name="CWL_HTTP_Endpoints_Control_Generation"></a>

El [Objetivo:CreateServiceSpecificCredential](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsidentityandaccessmanagementiam.html#awsidentityandaccessmanagementiam-actions-as-permissions) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_iam-condition-keys.html#ck_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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_iam-condition-keys.html#ck_ServiceSpecificCredentialAgeDays) — 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
<a name="CWL_HTTP_Endpoints_Control_Usage"></a>

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
<a name="CWL_HTTP_Endpoints_Permission_Examples"></a>

#### Impedir que se genere y utilice una identidad CloudWatch Registra las claves de API
<a name="CWL_HTTP_Endpoints_Deny_Generation_And_Use"></a>

```JSON
{
    "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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_service-specific-creds.html).

#### Impedir que una identidad utilice CloudWatch Registra las claves de API
<a name="CWL_HTTP_Endpoints_Deny_Use"></a>

```JSON
{
    "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
<a name="CWL_HTTP_Endpoints_Allow_Expire_90"></a>

```JSON
{
    "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
<a name="CWL_HTTP_Endpoints_Rotating_Keys"></a>

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
<a name="CWL_HTTP_Endpoints_Rotation_Process"></a>

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:

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

1. (Opcional) Guarde la nueva credencial en AWS Secrets Manager para una recuperación segura y una rotación automatizada.

1. 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.

1. Establezca la credencial original como inactiva:

   ```bash
   aws iam update-service-specific-credential \
       --user-name cloudwatch-logs-hlc-user \
       --service-specific-credential-id ACCA1234EXAMPLE1234 \
       --status Inactive
   ```

1. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Monitoring-CloudWatch-Metrics.html).

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

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

### Supervisión de la caducidad de claves
<a name="CWL_HTTP_Endpoints_Monitor_Expiration"></a>

Para comprobar la fecha de creación y el estado de las claves de API existentes, use el comando [list-service-specific-credentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/list-service-specific-credentials.html):

```bash
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
<a name="CWL_HTTP_Endpoints_Compromised_Keys"></a>

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:

   ```bash
   aws iam update-service-specific-credential \
       --user-name cloudwatch-logs-hlc-user \
       --service-specific-credential-id ACCA1234EXAMPLE1234 \
       --status Inactive
   ```

1. **Revisión CloudTrail registros** para determinar el alcance del acceso no autorizado. Consulte [Registrando el uso de las claves de API con CloudTrail](#CWL_HTTP_Endpoints_CloudTrail_Logging) para obtener información sobre cómo habilitar la auditoría del uso de claves de API.

1. **Cree una clave de reemplazo** según el proceso de rotación descrito en [Proceso de rotación](#CWL_HTTP_Endpoints_Rotation_Process).

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

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

1. **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:

   ```JSON
   {
       "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](https://docs.aws.amazon.com/IAM/latest/APIReference/API_ResetServiceSpecificCredential.html) — 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
<a name="CWL_HTTP_Endpoints_Security_Best_Practices"></a>

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](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) 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](#CWL_HTTP_Endpoints_Allow_Expire_90).
+ **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](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsAPIKeyAccess.html) 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](#CWL_HTTP_Endpoints_CloudTrail_Logging).
+ **Supervise con el Analizador de acceso de IAM.** Utilice el [Analizador de acceso de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html) 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](#CWL_HTTP_Endpoints_Rotating_Keys).

## Registrando el uso de las claves de API con CloudTrail
<a name="CWL_HTTP_Endpoints_CloudTrail_Logging"></a>

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](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/create-s3-bucket-policy-for-cloudtrail.html).

1. Cree un registro de seguimiento:

   ```bash
   aws cloudtrail create-trail \
       --name cloudwatch-logs-api-key-audit \
       --s3-bucket-name my-cloudtrail-bucket \
       --region us-east-1
   ```

1. Configure los selectores de eventos avanzados para capturar CloudWatch Registra los eventos de autorización de grupos:

   ```bash
   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"] }
           ]
       }]'
   ```

1. Inicie el registro de seguimiento:

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