Gestión de Claves API

Las claves API autentican acceso máquina a máquina. Cada clave usa los encabezados Api-Key y Api-Secret; el secreto se muestra solo al crear o rotar secretos y se almacena hasheado.

API real

Las claves API se gestionan en la API de serviceprojects bajo /v0/apikeys. No se gestionan bajo /projects/{id}/apikeys. La creación y gestión de proyectos está fuera del alcance actual de esta página.

 1curl -X POST "https://api.hola.cloud/v0/apikeys" \
 2  -H "X-Glue-Authentication: {\"user\":{\"id\":\"user-1234\"}}" \
 3  -H "Content-Type: application/json" \
 4  -d '{
 5    "name": "CI/CD Key",
 6    "scopes": [
 7      {
 8        "projects": ["project-123"],
 9        "host_rules": {"mi-proyecto.hola.cloud": "{}"}
10      }
11    ]
12  }'

Ámbitos

El modelo actual usa projects y host_rules.

Ámbito Campo Ejemplo
Proyectos projects ["project-123"]
Reglas de host host_rules {"mi-proyecto.hola.cloud": "{}"}

Los ámbitos de ruta y método HTTP no forman parte del modelo actual.

Listar claves

1curl "https://api.hola.cloud/v0/apikeys" \
2  -H "X-Glue-Authentication: {\"user\":{\"id\":\"user-1234\"}}"

Revocar una clave

1curl -X DELETE "https://api.hola.cloud/v0/apikeys/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
2  -H "X-Glue-Authentication: {\"user\":{\"id\":\"user-1234\"}}"

Cómo valida Glue2

  1. Glue2 extrae Api-Key y Api-Secret.
  2. Busca la clave y compara el secreto con el hash almacenado.
  3. Verifica projects y host_rules.
  4. Si es válido, inyecta X-Glue-Authentication como JSON y reenvía la solicitud.

Comentarios

Deja un comentario