Saltar al contenido

¿Cómo soluciono los errores «HTTP 403 Forbidden» al utilizar un autorizador de Lambda con una API de REST de API Gateway?

9 minutos de lectura
0

Tras crear un autorizador de AWS Lambda para mi API de REST de Amazon API Gateway, he recibido el error «403 Forbidden» en las llamadas a la API.

Descripción corta

Nota: La siguiente resolución corrige 403 errores relacionados con los autorizadores de Lambda configurados únicamente para las API REST. Para obtener información sobre cómo solucionar otros tipos de errores 403, consulta ¿Cómo puedo solucionar los errores HTTP 403 desde API Gateway?

Podrías recibir el error «403 prohibido» por los siguientes motivos:

  • El documento de política de AWS Identity and Access Management (IAM) devuelto por la función de autorizador de Lambda deniega explícitamente el acceso a la persona que llama.
  • El documento de política de IAM devuelto por la función de autorizador de Lambda no permite o deniega implícitamente el acceso a la persona que llama. La política de recursos adjunta a la API tampoco permite o deniega implícitamente el acceso a la persona que llama.
  • La API tiene una política de recursos adjunta que deniega explícitamente el acceso a la persona que llama.

Si la llamada a la API contiene un token u orígenes de identidad que faltan, son nulos o no están validados, aparece un error «401 Unauthorized». Para obtener más información, consulta ¿Por qué aparecen los errores «401 Unauthorized» de API Gateway después de crear un autorizador de Lambda?

Resolución

Confirmación de la causa del error

Si aún no lo has hecho, activa Registros de Amazon CloudWatch para tu API de REST de API Gateway. Si cambias la configuración del autorizador, vuelve a desplegar la API.

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de problemas de AWS CLI. Además, asegúrate de utilizar la versión más reciente de la AWS CLI.

Consultar el mensaje del registro de errores

En los registros de la API Gateway, busca un mensaje de error similar al de los siguientes ejemplos:

Ejemplo de mensaje de error para las funciones de autorizador de Lambda que devuelven un documento de política de IAM con una denegación explícita:

{    "message": "User is not authorized to access this resource with an explicit deny in an identity-based policy"}

Ejemplo de mensaje de error para las API de REST que tienen una política de recursos adjunta que deniega implícitamente el acceso a la persona que llama:

{    "message": "User: anonymous is not authorized to perform: execute-api:Invoke on resource: API_RESOURCE_ARN because no resource-based policy allows the execute-api:Invoke action"}

Nota: Una denegación implícita de una política de recursos solo produce un error 403 cuando ningún otro mecanismo de autorización permite explícitamente la solicitud. Si un autorizador de Lambda devuelve una sentencia Permitir, anula la denegación implícita de la política de recursos y la solicitud se realiza correctamente.

Ejemplo de mensaje de registro de error para las API de REST que tienen una política de recursos adjunta que deniega explícitamente el acceso a la persona que llama:

{    "message": "User: anonymous is not authorized to perform: execute-api:Invoke on resource: API_RESOURCE_ARN with an explicit deny in a resource-based policy"}

Nota: Para obtener más información sobre las API de API Gateway que controla una política de IAM, consulta las Tablas de resultados de la evaluación de políticas.

Consultar los registros de API Gateway

Para revisar el flujo de trabajo de autorización, consulta los registros de API Gateway en Registros de CloudWatch. Ten en cuenta el resultado del autorizador de Lambda y el resultado de la evaluación de la política de recursos de API Gateway. Busca un mensaje de error de registro similar a los siguientes ejemplos:

Ejemplo de mensaje de registro de errores si falta un token obligatorio o no coincide con la validación del token:

Extended Request Id: EXAMPLEabcIdGxzR=
Unauthorized request: REQUEST_ID
Gateway response type: UNAUTHORIZED with status code: 401

Nota: El valor del ID de solicitud extendido en tus registros es diferente porque se genera de forma aleatoria.

Ejemplo de mensaje de registro de errores si un autorizador de Lambda devuelve una política que deniega el acceso:

Starting authorizer: AUTHORIZER_ID for request: REQUEST_ID
Incoming identity: {IDENTITY_SOURCE=MASKED_VALUE}
Using valid authorizer policy for principal: PRINCIPAL
Successfully completed authorizer execution
The client is not authorized to perform this operation.
Gateway response type: ACCESS_DENIED with status code: 403

Nota: La política devuelta depende de tu autorizador de Lambda. Si el resource-arn de la política devuelta no incluye el recurso solicitante, la política deniega implícitamente las solicitudes.

Ejemplo de mensaje de registro de errores si la política de recursos de API Gateway deniega la solicitud:

Extended Request Id: EXAMPLE1ABdGeZB=
ExplicitDenyException User: anonymous is not authorized to perform: execute-api:Invoke on resource: API_RESOURCE_ARN with an explicit deny in a resource-based policy: REQUEST_ID
Gateway response type: DEFAULT_4XX with status code: 403

Resolver 403 errores causados por una falta de coincidencia en el ARN de un recurso en la respuesta del autorizador

Un autorizador de Lambda puede devolver una política Permitir válida. Si el nombre de recurso de Amazon (ARN) Recurso no coincide con el ARN del método API Gateway invocado, recibirás la respuesta «403 Forbidden». No hay detalles adicionales sobre el error en la respuesta de API Gateway ni en los registros de CloudWatch.

Esta situación se produce cuando el autorizador construye el ARN Recurso de forma dinámica e introduce una discordancia en alguno de los siguientes componentes:

  • El nombre de la fase de la API, por ejemplo, prod en lugar de dev
  • El método HTTP, por ejemplo, GET en lugar de POST
  • La ruta del recurso, por ejemplo, /users en lugar de /users/*

Para resolver este problema, sigue estos pasos:

  1. Revisa el resultado del autorizador de Lambda en Registros de CloudWatch. Busca el campo Recurso en el documento de política de IAM que devuelve el autorizador.
  2. Compara el ARN Rrecurso de la política con el ARN del método API Gateway que invocas. El ARN debe usar el siguiente formato:
    arn:aws:execute-api:{region}:{account-id}:{api-id}/{stage}/{HTTP-METHOD}/{resource-path}
  3. Confirma que la fase, el método HTTP y la ruta del recurso de la respuesta del autorizador coinciden exactamente con el método al que llamas. Por ejemplo, si invocas GET /prod/users, el ARN Recurso debe incluir prod/GET/users, no dev/GET/users ni prod/POST/users.
  4. Si el autorizador usa un comodín (*) en el campo Recurso, confirma que el patrón del comodín cubre el método invocado. Por ejemplo, arn:aws:execute-api:{region}:{account-id}:{api-id}/prod/GET/* permite todas las solicitudes GET en fase de producción.
  5. Actualiza el código de autorización de Lambda para que devuelva el ARN Recurso correcto que coincida con el método de API invocado y, a continuación vuelve a implementar la API.

Nota: Como este tipo de error 403 no produce un mensaje de error distinto en los registros de CloudWatch, puede resultar difícil distinguirlo de otros errores de autorización. Si confirmaste que el autorizador devuelve una política Permitir y sigues recibiendo el error 403, comprueba primero que el ARN Recurso no coincide.

Resolución de los errores «not authorized to access this resource» del autorizador de Lambda

Puedes recibir los errores «not authorized to access this resource» de forma intermitente debido al almacenamiento en caché de políticas. Para confirmar que el almacenamiento en caché de autorización está activado, revisa la configuración del autorizador de Lambda en la consola de API Gateway. A continuación, realiza una de las siguientes acciones:

  • Para realizar una prueba única, ejecuta el comando de AWS CLI flush-stage-authorizers-cache. Después de vaciar las entradas de la caché del autorizador, vuelve a llamar a la API.
    Nota: La limpieza de la caché puede tardar varios segundos en propagarse por completo en todos los puntos de enlace de API Gateway.
  • Desactiva el almacenamiento en caché de autorizaciones, vuelve a desplegar tu API para confirmar los cambios y, a continuación, vuelve a llamar a la API.
    Nota: Usa la opción Almacenamiento en caché de autorizaciones en la consola de API Gateway para desactivar el almacenamiento en caché de autorizaciones. El campo TTL solo acepta valores entre 1 y 3600 segundos. No puedes establecer el valor TTL en 0.
  • Para cambiar la clave de caché del autorizador, actualiza el nombre del encabezado especificado en Origen del token para autorizadores basados en token u Orígenes de identidad para autorizadores basados en parámetros de solicitud. Vuelve a desplegar la API para confirmar los cambios. A continuación, vuelve a llamar a la API con el encabezado del token o los orígenes de identidad recién configurados.

Para determinar por qué el autorizador deniega explícitamente el acceso a la persona que llama, revisa el código de la función de autorizador de Lambda. Si determinas que el problema se debe al almacenamiento en caché, actualiza el código para permitir el acceso a la persona que llama.

Para obtener instrucciones, consulta ¿Por qué mi recurso de proxy de API Gateway con un autorizador de Lambda que tiene activado el almacenamiento en caché devuelve errores HTTP 403 «User is not authorized to access this resource»?

Resolución de los errores «not authorized to perform: execute-api:Invoke»

Recibes este error cuando la política de recursos niega explícitamente el acceso a la persona que llama. El mensaje de error incluye «with an explicit deny in a resource-based policy».

También recibes este error cuando la política de recursos deniega implícitamente el acceso porque ninguna instrucción permite la solicitud. El mensaje de error incluye «porque ninguna política basada en recursos permite la acción execute-api:Invoke».

Para determinar si la política de recursos de la API no es válida o si deniega explícitamente o implícitamente el acceso a las llamadas, consulta la política de recursos de la API. A continuación, consulta los registros de la API para obtener el resultado de la respuesta de la política de recursos. Para obtener más información, consulta Descripción general del lenguaje de la política de acceso de Amazon API Gateway y Política de autorizadores y recursos de Lambda.

Información relacionada

Control y administración del acceso a las API de REST en API Gateway

OFICIAL DE AWSActualizada hace 3 meses
1 comentario

This article was reviewed and updated on 2026-08-24.

EXPERTO

respondido hace 2 meses

Contenido relevante