manage consumers API gateway authentication - API Gateway - Centro de documentación de Alibaba Cloud

Cloud-native API Gateway utiliza consumidores para habilitar la autenticación en rutas y API. Desde la consola se pueden crear, desactivar y eliminar consumidores.

Crear un consumidor

Cloud-native API Gateway ofrece tres métodos de autenticación.

Método	Descripción	Cuándo utilizarlo
Clave de API	El cliente añade una credencial a la solicitud. La puerta de enlace valida su legitimidad y permisos. Es menos seguro que JWT o AK/SK, por lo que debe proteger sus credenciales con cuidado.	Escenarios ligeros y de integración rápida con requisitos de seguridad bajos.
JWT	JWT es un estándar para transmitir información de forma segura entre un cliente y un servidor mediante firmas HMAC, RSA o ECDSA. Utilice JWT para la verificación de identidad y el control de acceso en la puerta de enlace.	Recomendado para sistemas distribuidos y escenarios de SSO.
HMAC	El cliente usa un par AK/SK para firmar el contenido de la solicitud con el algoritmo HMAC. Después envía la firma a la puerta de enlace para su validación.	Más indicado cuando se requiere alta integridad de datos y protección contra manipulaciones.

Crear un consumidor con autenticación por clave de API

Vaya a la página Consumers en la consola de Cloud-native API Gateway y seleccione una región.
Haga clic en Create a consumer. En el panel Create Consumer, establezca Consumer Name, seleccione API Key como método de autenticación y complete la siguiente configuración:
- Generation Method:
  - System Generated: el sistema genera automáticamente una clave de API.
  - Custom: especifique una clave de API personalizada y su origen.
- Credential: la clave de API personalizada.
- Credential Source:
  
  Ubicación de la solicitud desde donde la puerta de enlace obtiene la clave de API:
  - Authorization: Bearer <token> (formato de token estándar)
  - Custom HTTP Header (por ejemplo, X-API-Key: your-key)
  - Custom Query Parameter (por ejemplo, ?apikey=your-key)

Crear un consumidor con autenticación JWT

Vaya a la página Consumers en la consola de Cloud-native API Gateway y seleccione una región.
Haga clic en Create a consumer. En el panel Create Consumer, establezca Consumer Name, seleccione JSON Web Token (JWT) como método de autenticación y complete la siguiente configuración:
- Creation Method:
  - Local Configuration: utilícelo cuando el servicio de autenticación y la puerta de enlace estén en el mismo clúster o LAN, los requisitos de rendimiento sean altos y las claves cambien con poca frecuencia.
  - Remote Fetch: utilícelo con un centro de identidad unificado como OAuth2 u OpenID Connect. Admite actualizaciones dinámicas de claves y es ideal para entornos multiinquilino o de producción.
- Key Type (no es obligatorio para Remote Fetch):
  - Symmetric Key: genera una configuración JWKS predeterminada exclusiva para cada consumidor, que contiene la clave para cifrar y descifrar el token.
  - Asymmetric Key: proporcione una configuración JWKS completa y use una clave privada para cifrar el token. La puerta de enlace lo descifra con la clave pública del JWKS.
- JWKS:
  - Si selecciona Local Configuration, configure el JWKS según la especificación JSON Web Key (JWK).
  - Si selecciona Remote Fetch, introduzca la URL. El sistema analiza automáticamente el número de puerto, el tiempo de espera y la duración de la caché a partir de la URL.
    
    Importante
    La URL debe ser un nombre de dominio, no una dirección IP.
- JWT Token: configure los parámetros del token JWT.
  - Type: tipo del parámetro del token. El valor predeterminado es Header.
  - Key: nombre del parámetro del token.
  - Prefix: prefijo del parámetro del token. De forma predeterminada usa el encabezado Authorization con el prefijo Bearer, por ejemplo, Authorization: Bearer token.
  - Enable Passthrough: reenvía el parámetro del token al servicio de backend.
- Consumer ID in JWT Payload: par clave-valor en el payload de JWT que identifica al consumidor. De forma predeterminada es uid con una cadena aleatoria como valor, aunque se puede personalizar. Ejemplo de payload:
```
{
  "uid": "11215ac069234abcb8944232b79ae711"
}
```

Crear un consumidor con autenticación HMAC

Vaya a la página Consumers en la consola de Cloud-native API Gateway y seleccione una región.
Haga clic en Create a consumer. En el panel Create Consumer, establezca Consumer Name, seleccione Hash-based Message Authentication Code (HMAC) como método de autenticación y complete la siguiente configuración:
- System Generated: el sistema genera automáticamente la Access Key (AK) y la Secret Key (SK).
- Custom: especifique una AK y una SK personalizadas.

Desactivar un consumidor

Inicie sesión en la consola de API Gateway.
En el panel de navegación izquierdo, haga clic en Consumers. En la barra de navegación superior, seleccione una región.
En la página Consumers, busque el consumidor deseado, haga clic en Disable dentro de la columna Actions y haga clic en OK para confirmar.

Eliminar un consumidor

Inicie sesión en la consola de API Gateway.
En el panel de navegación izquierdo, haga clic en Consumers. En la barra de navegación superior, seleccione una región.
En la página Consumers, busque el consumidor deseado y haga clic en Delete dentro de la columna Actions. En el cuadro de diálogo de confirmación, introduzca el nombre del consumidor y haga clic en Delete.