trustgraph/specs/api/security/bearerAuth.yaml

22 lines
634 B
YAML
Raw Normal View History

type: http
scheme: bearer
description: |
Bearer token authentication.
Clients authenticate by passing an opaque token in the
`Authorization` header. The token is treated as an opaque string by
clients — its internal structure is a gateway implementation detail
and must not be relied upon.
The gateway resolves the token to an authenticated identity and an
associated workspace. All workspace-scoped and flow-scoped operations
then execute within that workspace context.
Tokens are obtained via the IAM service (e.g. `tg-login` or
`tg-create-api-key`).
Example:
```
Authorization: Bearer <token>
```