What you can connect to
- Sign in with Fastclinic. The standard OAuth 2.0 authorisation-code flow with PKCE. People sign in with the Fastclinic account they already use for Doorcta and Fastclinic Record.
- Single sign-out. OpenID Connect sign-out initiated from your application, so signing out in one place ends the session correctly.
- A stronger check for sensitive actions. Request a fresh second-factor sign-in before a sensitive action in your product.
- Verified clinician status. The ID token can confirm that a person is a licensed clinician whose licence our team has checked, so you can restrict clinical features to verified clinicians.
- Organisation and role. Receive the organisation a person belongs to, and their role there, within the ID token.
How sign-in works
Register your application
We register your application as a client, with the redirect and sign-out addresses you provide.
Send people to Fastclinic Account
Your application starts the authorisation-code flow with PKCE, using our OpenID Connect discovery document. Fastclinic Account handles the password, the passkey and the second factor.
Receive a signed ID token
On return, your application receives an ID token and a short-lived access token, limited to the scopes the person approved.
Verify the signature
Validate the token against Fastclinic Account's published public keys. There is no shared secret to store or rotate.
Identify each person by their Fastclinic Account user ID rather than their email address. Email addresses can change; the ID does not.
Tokens and consent
- Access tokens last 15 minutes.
- Refresh tokens change every time they are used, so a leaked refresh token works once at most.
- Fastclinic Account records every consent with the application, the scopes and the time. People can withdraw consent scope by scope, and tokens already issued expire within 15 minutes.
- Consents expire after 12 months.
Standards
- OAuth 2.0 authorisation-code flow with PKCE.
- OpenID Connect 1.0 for identity and sign-out.
- WebAuthn passkeys as a phishing-resistant second factor.
- Fastclinic Account handles requests to export, correct or erase personal data under the Nigeria Data Protection Act 2023, so your application does not need to.
Getting access
We review each integration for clinical safety. If your health product should allow people to sign in with their Fastclinic account, describe your product to us and we will share the details.