Getting Started
AuthHub provides fine-grained authorization for NHS applications using Relationship-Based Access Control (ReBAC). Integrate with our gRPC/Connect APIs to check permissions, manage relationships, and define authorization schemas.
Base URL
https://api.authhub.cloud
All API endpoints are served over gRPC and Connect (HTTP/JSON) protocols.
Authentication
All API requests require mutual TLS (mTLS) authentication using your tenant certificate. You can download your certificate from the Console under Certificates.
Request HeadersHTTP
Authorization: Bearer <your-tenant-token>
X-Tenant-ID: <your-tenant-id>
X-Sub-Tenant-ID: <your-sub-tenant-id>
Content-Type: application/jsonQuick Start
- 1Register your organisation and provision a tenant via the Console.
- 2Download your mTLS certificate from the Certificates page.
- 3Write your authorization schema (or use the NHS starter template).
- 4Write relationship tuples to represent your data model.
- 5Call CheckPermission at runtime to authorize access decisions.