Saltar al contenido

¿Cómo soluciono los errores HTTP 403 Forbidden de un nombre de dominio personalizado de API Gateway que requiere TLS mutua?

8 minutos de lectura
0

Mi nombre de dominio personalizado de Amazon API Gateway que tiene activada la seguridad de la capa de transporte (TLS) mutua devuelve errores HTTP 403 Forbidden. No sé por qué sucede esto.

Descripción corta

Nota: API Gateway devuelve errores 403 Forbidden por diversos motivos. Este artículo aborda los errores 403 Forbidden relacionados únicamente con la TLS mutua. Para obtener información sobre cómo solucionar otros tipos de errores 403 Forbidden, consulta ¿Cómo puedo solucionar los errores HTTP 403 desde API Gateway?

Para invocar una API de API Gateway con un nombre de dominio personalizado que requiera una TLS mutua, los clientes deben presentar un certificado de confianza en la solicitud de API. Cuando un cliente invoca la API, API Gateway busca al emisor del certificado del cliente en tu almacén de confianza.

Las siguientes condiciones hacen que API Gateway falle en la conexión TLS y devuelva un código de estado 403:

  • API Gateway can't find the issuer of the client certificate in your truststore.
  • The client certificate uses an insecure signature algorithm.
  • The client certificate is self signed.

Si se activa el registro de Amazon CloudWatch para tu API, se muestra un mensaje de error que indica la causa del error en los registros de ejecución.

Importante: Si la solicitud de API no produce ningún registro de CloudWatch después de activar el registro, el error 403 Forbidden no está relacionado con la TLS mutua.

En el caso de las API de REST

Si configuras el registro de Amazon CloudWatch para tu API de REST, se mostrará uno de los siguientes mensajes de error en los registros de ejecución:

  • Access denied. Reason: Could not find issuer for certificate
  • Access denied. Reason: Client cert using an insecure Signature Algorithm
  • Access denied. Reason: self signed certificate

En el caso de las API HTTP

Las API HTTP no admiten el registro de ejecución. Para solucionar los errores 403 Forbidden devueltos por un nombre de dominio personalizado que requiere TLS mutua y que invoca una API HTTP, sigue estos pasos:

  1. Crea una nueva asignación de API para tu nombre de dominio personalizado que invoque una API de REST solo para realizar pruebas.
    Nota: Si no tienes una API de REST con la que realizar pruebas, usa la API de REST de PetStore de ejemplo. A continuación, despliega la API de ejemplo en una nueva etapa y crea una nueva asignación de API que utilice tu nombre de dominio personalizado.
  2. Sigue las instrucciones de la sección Resolución de este artículo con la nueva asignación de API que creaste para tu API de REST.
  3. Redirige la asignación de API para tu nombre de dominio personalizado a tu API HTTP.

Resolución

Confirmación de la causa del error

  1. Activa el registro de CloudWatch para tu API de REST.

  2. Configura el registro de ejecución y acceso. Nota: Al configurar el registro de acceso para este caso de uso, utiliza las siguientes variables $context:

    { "accountId":"$context.accountId", "apiId":"$context.apiId", "domainName":"$context.domainName", "domainPrefix":"$context.domainPrefix", "error.message":"$context.error.message", "error.responseType":"$context.error.responseType", "extendedRequestId":"$context.extendedRequestId", "httpMethod":"$context.httpMethod", "identity.sourceIp":"$context.identity.sourceIp", "identity.clientCert.clientCertPem":"$context.identity.clientCert.clientCertPem", "identity.clientCert.subjectDN":"$context.identity.clientCert.subjectDN", "identity.clientCert.issuerDN":"$context.identity.clientCert.issuerDN", "identity.clientCert.serialNumber":"$context.identity.clientCert.serialNumber", "identity.clientCert.validity.notBefore":"$context.identity.clientCert.validity.notBefore", "identity.clientCert.validity.notAfter":"$context.identity.clientCert.validity.notAfter", "identity.userAgent":"$context.identity.userAgent", "path":"$context.path", "protocol":"$context.protocol", "requestId":"$context.requestId", "requestTime":"$context.requestTime", "requestTimeEpoch":"$context.requestTimeEpoch", "resourceId":"$context.resourceId", "resourcePath":"$context.resourcePath", "stage":"$context.stage", "responseLatency":"$context.responseLatency", "responseLength":"$context.responseLength", "status":"$context.status" }

    Esta plantilla de registro de acceso registra la información del certificado del cliente cuando la TLS mutua provoca errores 403. También facilita la identificación de la persona que llama y que intentó invocar la API.

  3. Consulta los registros de ejecución de la API de REST en CloudWatch para identificar la causa del problema. Si se registra un error 403 Forbidden relacionado con la TLS mutua, se mostrará un mensaje de error similar al siguiente:

    Extended Request Id: {extendedRequestId} Access denied. Reason: {reason}
    ForbiddenException Forbidden: {requestId}

Solución de errores "Access denied. Reason: Could not find issuer for certificate"

Verifica que el emisor del certificado de cliente en la solicitud de API esté incluido en el almacén de confianza del nombre de dominio personalizado

La cadena completa del certificado de cliente (client.pem) de la solicitud de API debe estar incluido en el almacén de confianza del nombre de dominio personalizado. El almacén de confianza (bundle.pem) es un archivo almacenado en Amazon Simple Storage Service (Amazon S3). Para comprobar si el emisor del certificado de cliente está incluido en el almacén de confianza requerido, ejecuta el siguiente comando de OpenSSL:

openssl verify -CAfile bundle.pem client.pem

Si el paquete de certificados contiene autoridades de certificación intermedias, ejecuta el siguiente comando de OpenSSL:

openssl verify -CAfile rootCA.pem -untrusted intCA.pem client.pem

Si el emisor del certificado de cliente de la solicitud de API está incluido en el almacén de confianza requerido, el comando devuelve la respuesta OK.

Si el emisor del certificado de cliente no está incluido en el almacén de confianza requerido, el comando devuelve el siguiente error:

error X at Y depth lookup: unable to get local issuer certificate

Para solucionar este error, carga un nuevo almacén de confianza a Amazon S3 que incluya la cadena de certificados completa para el certificado del cliente.

Comprueba que todos los certificados de cliente del almacén de confianza del nombre de dominio personalizado sean válidos

Si uno de los certificados de cliente del almacén de confianza del nombre de dominio personalizado no es válido, es posible que algunos clientes no puedan acceder a la API. Para confirmar que los certificados de cliente del almacén de confianza son válidos, sigue estos pasos:

  1. Abre la consola de Amazon API Gateway.

  2. En el panel de navegación izquierdo, selecciona Custom domain names (Nombres de dominio personalizado). Luego, elige el nombre de dominio personalizado que requiera TLS mutua.

  3. En la sección Domain details (Detalles del dominio), comprueba si hay una advertencia como la siguiente: Your truststore bundle has 1 invalid certificates.

  4. Si ves la advertencia, descodifica los certificados del almacén de confianza para identificar qué certificado ha generado la advertencia. El siguiente comando de OpenSSL muestra el asunto y el contenido de un certificado:

    openssl x509 -in certificate.crt -text -noout
  5. Actualiza o elimina los certificados que han generado la advertencia. A continuación, carga un nuevo almacén de confianza a Amazon S3.

Para obtener más información, consulta Solución de problemas de advertencias de certificados.

Nota: Si se conserva su cadena de certificados, API Gateway acepta los certificados de cliente firmados directamente por la autoridad de certificación raíz o cualquier otra autoridad de certificación intermedia. Para validar los certificados de cliente firmados únicamente por la última autoridad certificadora intermedia, utiliza un Autorizador de AWS Lambda basado en parámetros de solicitud. Puedes crear un algoritmo de validación personalizado en el autorizador de Lambda basado en solicitudes. El certificado de cliente se encuentra en la entrada de la solicitud de API en requestContext.identity.clienCert.

Solución de errores "Access denied. Reason: Client cert using an insecure Signature Algorithm"

Comprueba que tu archivo de texto del almacén de confianza utilice un algoritmo de hash compatible. API Gateway admite los siguientes algoritmos de hash en el almacén de confianza:

  • SHA-256 o más fuerte
  • RSA-2048 o más fuerte
  • ECDSA-256 o más fuerte

Para confirmar que tu archivo de texto del almacén de confianza utiliza un algoritmo de hash compatible, ejecuta el siguiente comando de OpenSSL:

openssl x509 -in client.crt -text -noout | grep 'Signature Algorithm'

La respuesta del comando devuelve el algoritmo de firma del almacén de confianza. Si el algoritmo no es compatible, actualiza tu certificado de cliente para usar un algoritmo compatible. A continuación, carga un nuevo almacén de confianza a Amazon S3.

Para obtener más información, consulta Configuración de tu almacén de confianza.

Solución de errores "Access denied. Reason: self signed certificate"

Comprueba que el certificado de cliente autofirmado de la solicitud de API no esté alterado ni dañado. La solicitud de firma de certificado de cliente (my_client.csr), la clave privada del certificado de cliente (my_client.key) y la clave pública del certificado de cliente (my_client.pem) deben coincidir.

Para comparar los módulos, ejecuta los siguientes comandos de OpenSSL:

openssl req -noout -modulus -in my_client.csr
openssl rsa -noout -modulus -in my_client.key
openssl x509 -noout -modulus -in my_client.pem

Nota: Para producir un valor hash más corto y facilitar la comparación, utiliza una canalización en el módulo de salida. Observa el siguiente ejemplo de openssl sha1:

$ openssl [operation] -noout -modulus -in [data] | openssl sha1

Un ejemplo de salida válido es similar al siguiente:

2143831a73a8bb28467860df18550c696c03fbcb
2143831a73a8bb28467860df18550c696c03fbcb
2143831a73a8bb28467860df18550c696c03fbcb

Para confirmar la integridad de los datos, comprueba que no haya ninguna modificación de los datos a nivel de contenido. Ejecuta el siguiente comando diff:

diff client.crt bundle.crt

Si los módulos no coinciden o el comando diff devuelve diferencias, vuelve a generar el certificado de cliente y actualiza tu almacén de confianza. A continuación, carga un nuevo almacén de confianza a Amazon S3.

Para obtener más información, consulta Configuración de tu almacén de confianza.

Información relacionada

Cómo activar la autenticación TLS mutua para las API de REST en API Gateway

OFICIAL DE AWSActualizada hace 8 meses
1 comentario

This article was reviewed and updated on 2026-02-27.

EXPERTO

respondido hace 3 meses