Rol con demasiados permisos para una clave de servicio

Moses SkodaIngeniero1 min de lectura

La API responde con 403 Forbidden cuando se produce este problema. Su type es https://lingo.dev/docs/api/errors/service-key-role-too-broad. Consulta Errores y códigos de estado para conocer la estructura común de todos los errores.

No se puede asignar el rol <id> a una clave API de servicio: los roles de estas claves solo pueden incluir engine:read y engine:translate, pero este también concede org:manage_team. Elige un rol con menos permisos o crea uno para la clave.

Campos#

Además de las propiedades estándar type, status, title y detail, el cuerpo incluye estos campos. El texto de detail se genera a partir de ellos, por lo que el cliente puede mostrar su propio texto en su lugar.

CampoTipo
idstring
permissions("org:manage_team" | "org:manage_billing" | "org:manage_settings" | "org:manage_api_keys" | "org:manage_integrations" | "org:delete" | "org:view_audit_logs" | "engine:read" | "engine:translate" | "engine:create" | "engine:edit" | "engine:delete" | "engine:review_translations" | "org:manage_reviews" | "org:glossary:read" | "org:glossary:edit" | "org:brandvoice:read" | "org:brandvoice:edit" | "org:ruleset:read" | "org:ruleset:edit" | "org:suggestion:read" | "org:suggestion:edit")[]

Ejemplo#

json
{
  "detail": "Role <id> cannot be given to a service API key: a service key role may only carry engine:read, engine:translate, and this one also grants org:manage_team. Pick a narrower role or create one for the key.",
  "id": "<id>",
  "permissions": [
    "org:manage_team"
  ],
  "type": "https://lingo.dev/docs/api/errors/service-key-role-too-broad",
  "status": 403,
  "title": "Role too broad for a service key"
}

Devuelto por#

  • PATCH /v2/service-api-keys/{id}
  • POST /v2/organizations/{orgId}/service-api-keys