Autenticación
Las solicitudes para llamar a una API se pueden autenticar mediante cualquiera de los siguientes métodos:
- Autenticación basada en tokens: las solicitudes se autentican mediante un token.
- Autenticación basada en AK/SK: Las solicitudes se autentican cifrando el cuerpo de la solicitud usando un par AK/SK. Se recomienda la autenticación basada en AK/SK porque proporciona mayor seguridad que la autenticación basada en tokens.
Autenticación basada en tokens
El período de validez de un token es de 24 horas. Cuando utilice un token para la autenticación, guarde en caché para evitar llamar con frecuencia a la API de IAM utilizada para obtener un token de usuario.
Un token especifica los permisos temporales en un sistema informático. Durante la autenticación de API mediante un token, el token se agrega a las solicitudes para obtener permisos para invocar a la API.
Hacer una solicitud de API describe el proceso de llamar a la API utilizada para crear un grupo de API. Después de obtener un token, el campo de encabezado X-Auth-Token debe agregarse a las solicitudes para especificar el token al llamar a otras API. Por ejemplo, si el token es de ABCDEFJ...., X-Auth-Token: ABCDEFJ.... se puede agregar a una solicitud de la siguiente manera:
POST https://{apig_endpoint}/v2/{project_id}/apigw/instances/{instance_id}/api-groups
Content-Type: application/json
X-Auth-Token: ABCDEFJ....
Autenticación basada en AK/SK
La autenticación basada en AK/SK admite solicitudes de API con un cuerpo de no más de 12 MB. Para las solicitudes de API con un cuerpo más grande, se recomienda la autenticación basada en tokens.
En la autenticación basada en AK/SK, AK/SK se utiliza para firmar solicitudes y la firma se añade a continuación a las solicitudes de autenticación.
- AK: ID de clave de acceso, que es un identificador único usado junto con una clave de acceso secreta para firmar solicitudes criptográficamente.
- SK: clave de acceso secreta usada junto con un AK para firmar solicitudes criptográficamente. Identifica un remitente de la solicitud y evita que la solicitud sea modificada.
- El SDK de firma solo se utiliza para firmar solicitudes y es diferente de los SDK proporcionados por los servicios.
- La hora local en el cliente debe sincronizarse con el servidor de reloj para evitar un desplazamiento grande en el valor del encabezado de solicitud X-Sdk-Date.
APIG comprueba el formato de hora y compara la hora con la hora en que APIG recibe la solicitud. Si la diferencia de tiempo supera los 15 minutos, APIG rechazará la solicitud.
