Habilitación de registros de conexión del Equilibrador de carga de aplicación - ELB
Paso 1: Crear un bucket de S3Paso 2: Adjuntar una política al bucket de S3Paso 3: configurar registros de conexiónPaso 4: verificar los permisos del bucketResolución de problemas

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.

Habilitación de registros de conexión del Equilibrador de carga de aplicación

Al habilitar los registros de conexión del equilibrador de carga, debe especificar el nombre del bucket de S3 donde el equilibrador de carga almacenará los registros. El bucket debe tener una política de bucket que otorgue al ELB permiso para escribir en el bucket.

Paso 1: Crear un bucket de S3

Al habilitar los registros de conexión, es preciso especificar un bucket de S3 para estos. Puede utilizar un bucket existente o crear uno específico para los registros de conexión. El bucket debe cumplir los siguientes requisitos.

Requisitos

  • El bucket debe estar ubicado en la misma región que el equilibrador de carga. El bucket y el equilibrador de carga pueden ser propiedad de diferentes cuentas.

  • La única opción de cifrado del lado del servidor que se admite son claves administradas por Amazon S3 (SSE-S3). Para obtener más información, consulte Claves de cifrado administradas por Amazon S3 (SSE-S3).

Para crear un bucket de S3 con la consola de Amazon S3

  1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. Elija Crear bucket.

  3. En la página Crear un bucket, realice las siguientes acciones:

    1. En Nombre del bucket, escriba un nombre para el bucket. Este nombre debe ser único entre todos los nombres de buckets de Amazon S3. En algunas regiones, es posible que haya restricciones adicionales para los nombres de los buckets. Para obtener más información, consulte Restricciones y límites de buckets en la Guía del usuario de Amazon S3.

    2. En Región AWS , seleccione la región donde ha creado el equilibrador de carga.

    3. Para el cifrado predeterminado, elija las claves administradas por Amazon S3 (SSE-S3).

    4. Elija Crear bucket.

Paso 2: Adjuntar una política al bucket de S3

Su bucket de S3 debe tener una política de bucket que otorgue al ELB permiso para escribir los registros de conexión en el bucket. Las políticas de bucket son colecciones de instrucciones JSON escritas en el lenguaje de la política de acceso para definir los permisos de acceso al bucket. Cada instrucción incluye información sobre un único permiso y contiene una serie de elementos.

Si utilizas un bucket existente que ya tiene una política adjunta, puedes añadir a la política la declaración relativa a los registros de conexión de ELB. En este caso, recomendamos evaluar el conjunto de permisos resultante para asegurarse de que sean adecuados para los usuarios que necesitan obtener acceso al bucket en relación con los registros de conexión.

Esta política otorga permisos al servicio de entrega de registros especificado.

{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "logdelivery.elasticloadbalancing.amazonaws.com"
      },
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/AWSLogs/123456789012/*"
    }
  ]
}

En Resource, introduzca el ARN de la ubicación de los registros de acceso con el formato que se muestra en la política de ejemplo. Incluya siempre el ID de la cuenta que contiene el equilibrador de carga en la ruta de recursos del ARN del bucket de S3. Esto garantiza que solo los equilibradores de carga de la cuenta especificada puedan escribir registros de acceso en el bucket de S3.

El ARN que especifique dependerá de si planea incluir un prefijo al habilitar los registros de acceso en el paso 3.

Ejemplo de ARN del bucket de S3 con un prefijo

El nombre del bucket de S3 es amzn-s3-demo-logging-bucket y el prefijo es logging-prefix.

arn:aws:s3:::amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/*

AWS GovCloud (US): en el siguiente ejemplo, se utiliza la sintaxis de ARN para las AWS GovCloud (US) Regions.

arn:aws-us-gov:s3:::amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/*
Ejemplo de ARN del bucket de S3 sin prefijo

El nombre del bucket de S3 es amzn-s3-demo-logging-bucket. No hay ninguna parte de prefijo en el ARN del bucket de S3.

arn:aws:s3:::amzn-s3-demo-logging-bucket/AWSLogs/123456789012/*

AWS GovCloud (US): en el siguiente ejemplo, se utiliza la sintaxis de ARN para las AWS GovCloud (US) Regions.

arn:aws-us-gov:s3:::amzn-s3-demo-logging-bucket/AWSLogs/123456789012/*

Anteriormente, para las regiones disponibles antes de agosto de 2022, exigíamos una política que concediera permisos a una cuenta del ELB específica de la región. Esta política heredada aún es compatible, pero recomendamos que la sustituya por la política más reciente que se ha indicado anteriormente. Si prefiere continuar con el uso de la política heredada, que no se muestra aquí, puede hacerlo.

Como referencia, estas son las cuentas IDs del ELB que debes especificar Principal en la política anterior. Tenga en cuenta que las regiones que no figuran en esta lista no son compatibles con la política heredada.

  • Este de EE. UU. (Norte de Virginia): 127311923021

  • Este de EE. UU. (Ohio): 033677994240

  • Oeste de EE. UU. (Norte de California): 027434742980

  • Oeste de EE. UU. (Oregón): 797873946194

  • África (Ciudad del Cabo): 098369216593

  • Asia-Pacífico (Hong Kong): 754344448648

  • Asia-Pacífico (Yakarta): 589379963580

  • Asia-Pacífico (Bombay): 718504428378

  • Asia-Pacífico (Osaka): 383597477331

  • Asia-Pacífico (Seúl): 600734575887

  • Asia Pacífico (Singapur): 114774131450

  • Asia Pacífico (Sídney): 783225319266

  • Asia Pacífico (Tokio): 582318560864

  • Canadá (Centro): 985666609251

  • Europa (Fráncfort): 054676820928

  • Europa (Irlanda): 156460612806

  • Europa (Londres): 652711504416

  • Europa (Milán): 635631232127

  • Europa (París): 009996457667

  • Europa (Estocolmo): 897822967062

  • Medio Oriente (Baréin): 076674570225

  • América del Sur (São Paulo): 507241528517

  • AWS GovCloud (EEUU-Este) — 190560391635

  • AWS GovCloud (US-Oeste) — 048591011584

La siguiente política otorga permisos al servicio de entrega de registros especificado. Utilice esta política para los equilibradores de carga en las zonas Outposts.

{
    "Effect": "Allow",
    "Principal": {
        "Service": "logdelivery.elb.amazonaws.com"
    },
    "Action": "s3:PutObject",
    "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/AWSLogs/123456789012/*"
    "Condition": {
        "StringEquals": {
            "s3:x-amz-acl": "bucket-owner-full-control"
        }
    }
}

En Resource, introduzca el ARN de la ubicación de los registros de acceso. Incluya siempre el ID de la cuenta que contiene el equilibrador de carga en la ruta de recursos del ARN del bucket de S3. Esto garantiza que solo los equilibradores de carga de la cuenta especificada puedan escribir registros de acceso en el bucket de S3.

El ARN que especifique dependerá de si planea incluir un prefijo al habilitar los registros de acceso en el paso 3.

Ejemplo de ARN del bucket de S3 con un prefijo

El nombre del bucket de S3 es amzn-s3-demo-logging-bucket y el prefijo es logging-prefix.

arn:aws:s3:::amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/*
Ejemplo de ARN del bucket de S3 sin prefijo

El nombre del bucket de S3 es amzn-s3-demo-logging-bucket. No hay ninguna parte de prefijo en el ARN del bucket de S3.

arn:aws:s3:::amzn-s3-demo-logging-bucket/AWSLogs/123456789012/*

Para mejorar la seguridad, utilice un cubo S3 preciso. ARNs

  • Utilice la ruta de recurso completa, no solo el ARN del bucket de S3.

  • Incluya la parte del ID de cuenta del ARN del bucket de S3.

  • No utilice caracteres comodín (*) en la parte del ID de cuenta del ARN del bucket de S3.

Después de crear la política de bucket, utilice una interfaz de Amazon S3, como la consola o los AWS CLI comandos de Amazon S3, para adjuntar la política de bucket a su bucket de S3.

Console
Para asociar la política de bucket al bucket de S3

  1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. Seleccione el nombre del bucket para abrir la página de detalles.

  3. Elija Permisos y, a continuación, seleccione Política de bucket, Editar.

  4. Actualice la política de bucket para conceder los permisos necesarios.

  5. Seleccione Save changes (Guardar cambios).

AWS CLI
Para asociar la política de bucket al bucket de S3

Utilice el comando put-bucket-policy. En este ejemplo, la política del bucket se guardó en el archivo .json especificado.

aws s3api put-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --policy file://access-log-policy.json

Paso 3: configurar registros de conexión

Utilice el siguiente procedimiento para configurar los registros de conexión a fin de capturar y entregar los archivos de registro al bucket de S3.

Requisitos

El bucket debe cumplir los requisitos descritos en el paso 1 y debe adjuntar una política de bucket tal como se describe en el paso 2. Si especificas un prefijo, no debe incluir la cadena "AWSLogs».

Administración del bucket de S3 para los registros de conexión

Asegúrese de deshabilitar los registros de conexión antes de eliminar el bucket que configuró para los registros de conexión. De lo contrario, si hay un nuevo bucket con el mismo nombre y la política de bucket requerida, pero creado en uno del Cuenta de AWS que no eres propietario, ELB podría escribir los registros de conexión de tu balanceador de cargas en este nuevo bucket.

Console
Para habilitar registros de conexión

  1. Abre la EC2 consola de Amazon en https://console.aws.amazon.com/ec2/.

  2. En el panel de navegación, seleccione Equilibradores de carga.

  3. Seleccione el nombre del equilibrador de carga para abrir la página de detalles.

  4. En la pestaña Atributos, seleccione Editar.

  5. En Supervisión, active los registros de conexión.

  6. En URI de S3, ingrese el URI de S3 correspondiente a los archivos de registro. El URI que especifique depende de si utiliza un prefijo.

    • URI con un prefijo: s3://bucket-name/prefix

    • URI sin un prefijo: s3://bucket-name

  7. Seleccione Save changes (Guardar cambios).

AWS CLI
Para habilitar registros de conexión

Utilice el modify-load-balancer-attributescomando con los atributos relacionados.

aws elbv2 modify-load-balancer-attributes \
    --load-balancer-arn load-balancer-arn \
    --attributes \
        Key=connection_logs.s3.enabled,Value=true \
        Key=connection_logs.s3.bucket,Value=amzn-s3-demo-logging-bucket \
        Key=connection_logs.s3.prefix,Value=logging-prefix
CloudFormation
Para habilitar registros de conexión

Actualice el AWS::ElasticLoadBalancingV2::LoadBalancerrecurso para incluir los atributos relacionados.

Resources:
  myLoadBalancer:
    Type: 'AWS::ElasticLoadBalancingV2::LoadBalancer'
    Properties:
      Name: my-alb
      Type: application
      Scheme: internal
      Subnets: 
        - !Ref subnet-AZ1
        - !Ref subnet-AZ2
      SecurityGroups: 
        - !Ref mySecurityGroup
      LoadBalancerAttributes: 
        - Key: "connection_logs.s3.enabled"
          Value: "true"
        - Key: "connection_logs.s3.bucket"
          Value: "amzn-s3-demo-logging-bucket"
        - Key: "connection_logs.s3.prefix"
          Value: "logging-prefix"

Paso 4: verificar los permisos del bucket

Una vez habilitados los registros de conexión para el balanceador de cargas, ELB valida el bucket de S3 y crea un archivo de prueba para garantizar que la política del bucket especifique los permisos necesarios. Puede utilizar la consola de Amazon S3 para comprobar que se ha creado el archivo de prueba. El archivo de prueba no es un archivo de registro de conexión real; no contiene registros de ejemplo.

Para comprobar que ELB creó un archivo de prueba en su bucket de S3

  1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. Seleccione el nombre del bucket que especificó para los registros de conexión.

  3. Vaya al archivo registro de prueba, ELBConnectionLogTestFile. La ubicación depende de si utiliza un prefijo.

    • Ubicación con un prefijo:amzn-s3-demo-logging-bucket///prefix/AWSLogs123456789012ELBConnectionLogTestFile

    • Ubicación sin prefijo:amzn-s3-demo-logging-bucket///AWSLogs123456789012ELBConnectionLogTestFile

Resolución de problemas

Si recibe un error de acceso denegado, estas pueden ser causas posibles:

  • La política del bucket no otorga al ELB permiso para escribir registros de conexión en el bucket. Compruebe que está utilizando la política de bucket correcta para la región. Compruebe que el ARN del recurso utilice el mismo nombre de bucket que especificó al habilitar los registros de conexión. Compruebe que el ARN del recurso no incluya un prefijo si no especificó un prefijo al habilitar los registros de conexión.

  • El bucket usa una opción de cifrado del lado del servidor no compatible. El bucket debe usar claves administradas por Amazon S3 (SSE-S3).