Famly supports OpenID Connect (OIDC) for user authentication, allowing integration with any OIDC provider. This guide focuses on setting up Azure Active Directory with Famly.
š” Single Sign On (SSO) can be purchased as an add-on for all packages for Ā£16 per month with a one-time Ā£500 setup fee. Get in touch with your account manager or support@famly.co to enable SSO
Step 1: Register the App in Azure
Create an app registration
In Azure Active Directory, go to App registrations
Click New registration
Enter a name (e.g. āFamlyā) and click Register
Configure branding & authentication
Open the newly created App registration
Go to the Branding section and enter the home page URL:
https://app.famly.co
š” If you're using white labelling, add the white label domain as the home page URL instead
Set up authentication
Navigate to the Authentication section
Click Add a platform ā Web
Enter
https://app.famly.coas the Redirect URITick the ID tokens box
Click Configure
Add an additional redirect URI
Click Add URI
Enter
https://app.famly.co/app-trap
š” If you are using white labeling, add the white label domain in addition to the two Famly URIs
Generate a client secret
Go to Certificates & secrets
Click New client secret
Copy and save the Value immediately, as it wonāt be accessible later
Set a reminder to generate a new secret before the current one expires
Step 2: Collect Required Information for Famly
To enable the integration, collect the following details:
Client ID: Found in the Overview under "Application (client) ID"
Client Secret: Copied when generated
Endpoint/Base URI: Found under Endpoints ā "OpenID Connect metadata document"
The endpoint will look something like this:
āhttps://login.microsoftonline.com/c630ad49-3d5d-4692-9a48-74a5372c1b0b
Entering the details in Famly
Go to:
https://app.famly.co/#/account/organization/<your-organization-id>/openid/createProviderEnter the Client ID, Client Secret, and Base URI
Choose a Title (this appears on the login screen)
Save the settings
š” Famly support can provide the correct organisation ID if needed
Updating the client secret
To update an expired client secret:
Go to the same settings page in Famly
Enter the existing Client ID and Base URI
Add the new Client Secret
Save the changes
Troubleshooting
Are you getting a āNot authorisedā error when saving settings?
The required āManage single sign-on settingsā permission may be missing