Sign-in & API Keys

← Setup · Let people sign in with Google, Microsoft, Facebook or your company's login, and give other systems a key to call the API. Either way, what they may do is still set by a role.

Sign-in options

A person who signs in this way becomes the Foundation user with the same email address (Setup → Users & Security → Manage Users), with that user's role. After the first time, the provider account stays linked to the user (shown on Edit User).
The buttons show on the login page once the site has user logins.

The providers send people back to this server by its web address, and require https:// (only localhost may use http). Use the address users reach the site by.

Google Cloud Console → APIs & Services → Credentials → Create OAuth client ID (Web application). Open

Only addresses at these domains are let in. Blank = any address that matches a user.
Off: only people an admin added can sign in. On: best with allowed domains set.

Microsoft Entra → App registrations → New registration (Web). Client id = Application (client) ID; secret from Certificates & secrets. Open

common = any account; or your organisation's tenant id / domain to allow only it.
Only addresses at these domains are let in. Blank = any address that matches a user.
Off: only people an admin added can sign in. On: best with allowed domains set.

Meta for Developers → Create app → Facebook Login. Client id = App ID, secret = App Secret. Open

Only addresses at these domains are let in. Blank = any address that matches a user.
Off: only people an admin added can sign in. On: best with allowed domains set.

Any OpenID Connect provider: Okta, Auth0, Keycloak, Entra ID for one organisation, Google Workspace… Register a web app with the redirect URI below.

Only addresses at these domains are let in. Blank = any address that matches a user.
Off: only people an admin added can sign in. On: best with allowed domains set.
API keys

For other systems (ERP, accounting, dispatch) calling the API without signing in. Send the key as X-Api-Key: fdn_… or Authorization: Bearer fdn_…. A key acts with its role: User reads, Manager can also add and change data through the Integration API, Admin can reach everything an admin can. Keys work on /api/… only, and can't manage keys or sign-in.

/api/tables then answers only a valid key (or a signed-in user) - even while the site runs without login. The office's own screens don't use it, so nothing here changes for them. With login on, every other API call already needs a sign-in or a key.
NameKeyRoleLast used
No keys yet.