Todos los productos
Search
Centro de documentos

API Gateway:Habilitar HTTPS

Última actualización: Sep 03, 2026

HTTPS agrega una capa de seguridad al protocolo HTTP estándar mediante Secure Sockets Layer (SSL) para cifrar datos. Esto garantiza la seguridad de los datos durante la transmisión.

API Gateway le permite proteger las solicitudes de API con HTTPS. Configure cada API para que admita solo HTTP, solo HTTPS o ambos protocolos. Para habilitar HTTPS en su API, siga estos pasos.

Paso 1: Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

  • Un nombre de dominio independiente de su propiedad y bajo su control.

  • Un certificado SSL para el nombre de dominio.

  • Un certificado SSL y su clave privada. Ambos deben estar en formato PEM. Nota: API Gateway utiliza Tengine, un servicio basado en Nginx. Por lo tanto, requiere certificados compatibles con Nginx en formato PEM.

Por lo general, un certificado SSL y su clave privada se proporcionan en dos archivos, como XXXXX.pem y XXXXX.key. Abra ambos con un editor de texto.

CLAVE:

-----BEGIN RSA PRIVATE KEY-----
MIIEpAIBAAKCAQEA8GjIleJ7rlo86mtbwcDnUfqzTQAm4b3zZEo1aKsfAuwcvCud
....
-----END RSA PRIVATE KEY-----

PEM:

-----BEGIN CERTIFICATE-----
MIIFtDCCBJygAwIBAgIQRgWF1j00cozRl1pZ+ultKTANBgkqhkiG9w0BAQsFADBP
...
-----END CERTIFICATE-----	

Paso 2: Vincular el certificado SSL

Inicie sesión en la consola de API Gateway. En el panel de navegación izquierdo, vaya a API Management > API Groups. Haga clic en el nombre del grupo de API al que desea vincular el certificado SSL. Antes de vincular un certificado SSL, debe vincular un independent domain name al grupo de API.

En la fila correspondiente al nombre de dominio, haga clic en Select Certificate en la columna SSL Certificate.

Agregue un certificado SSL para el Independent Domain Name.

El nombre del certificado puede contener caracteres chinos, letras, dígitos, guiones bajos (_) y guiones (-). Debe comenzar con una letra o un carácter chino y tener entre 4 y 50 caracteres. El contenido del certificado y la clave privada deben estar codificados en PEM y no superar los 20 KB. Haga clic en Upload para importar los archivos. Para la autenticación mutua HTTPS, haga clic en Click to add CA certificate para agregar un certificado de CA.

  • Certificate Name: Nombre personalizado para identificar el certificado.

  • Certificate Content: Contenido completo del archivo de certificado XXXXX.pem.

  • Private Key: Contenido del archivo de clave privada XXXXX.key. Haga clic en OK para vincular el certificado.

Paso 3: Ajustar la configuración de la API

Tras vincular el certificado SSL, controle el protocolo de acceso de cada API. Los protocolos compatibles son HTTP, HTTPS o ambos. Por motivos de seguridad, se recomienda configurar todas las API para usar HTTPS.

  1. En la consola de API Gateway, vaya a API Management > APIs y localice la API objetivo.

  2. Haga clic en el nombre de la API objetivo y luego en Edit en la esquina superior derecha.

  3. En el paso Basic Information, haga clic en Next para continuar al paso Define API Request. En la sección Protocol, seleccione los protocolos deseados.

    Seleccione tanto HTTP como HTTPS.

Los valores válidos para Protocol son:

  • HTTP: Permite el acceso a la API solo mediante HTTP y deniega el acceso mediante HTTPS.

  • HTTPS: Permite el acceso a la API solo mediante HTTPS y deniega el acceso mediante HTTP.

  • HTTP y HTTPS: Permite el acceso a la API mediante ambos protocolos. Esta opción habilita el acceso HTTPS para su API.