Mobile-ID · Evidence-based trust
Records glossaryContact
Trusted Records · Integration & Developer

API authentication and authorization

OAuth scopes govern API access; tenant/project and records policy still govern business authorization.

Final sources tied to business decisions

Proposed profile

OAuth 2.0 client credentials for service clients; OIDC for user applications under SSO configuration. Bearer tokens require valid issuer, audience, expiry and scopes. mTLS may bind clients when configured/tested.

Required context

Examples use X-Tenant-Id, X-Project-Id and X-Correlation-Id. Backends must match context to token authority rather than trust headers. records:read does not imply redaction, export or declaration.

Credential lifecycle

Approve minimal scopes, store secrets safely, test rotation overlap, revoke and audit. Use 401 for invalid authentication and 403 for insufficient permission. Never log tokens/secrets or record content.

Start with a verifiable scope.

Agree record classes, quality criteria, permissions and evidence before scaling.

Plan assessment

Search Trusted Records

Enlarged source image

Illustrative source image; displayed values are not service commitments.