Compare the policies
Selecting company-managed identities does not turn on Require single sign-on. Identity trust and mandatory SSO are separate settings.
Company-managed identities
Use this policy when your organization controls account creation, work email assignment, and email changes in its identity provider. Users should not be able to register or edit their profile to claim a colleague’s address. Restrict the Forecastable application to the intended directory users or groups. Your provider’s successful authentication and company-controlled email assignment are the trust source. Users do not need a separate email confirmation step just to satisfy Forecastable’semail_verified check.
This policy is enabled by default for new organizations and for existing SSO organizations without an explicit saved trust policy. The default applies after the application update is deployed; no database backfill or provider claim change is needed. An explicitly saved Verified email choice is preserved through ordinary settings changes.
What Forecastable checks
At the SSO callback, Forecastable:- Consumes the browser-bound server-side transaction created when sign-in started.
- Exchanges the authorization code and retrieves the authoritative user attributes from Cognito.
- For email-first sign-in, requires the returned email to match the email used to start sign-in. For a company sign-in link, obtains the email from the authenticated provider response; the server-side transaction already identifies the selected organization and provider.
- Resolves that exact email domain through the organization’s verified SSO domains.
- Requires that organization and its active provider to match the sign-in transaction.
- Requires a federated identity from that provider with a nonempty subject identifier.
- Resolves an existing account or previously linked identity, then checks that it is active, belongs to this organization, and has the same email.
- Links the provider identity without replacing the native password identity or granting a role.
Prepare accounts
Create or invite each person into your Forecastable organization before their first company-managed SSO sign-in. Assign their normal membership and permissions. The work email must match the identity provider. Unknown users receive a sign-in error; this policy does not provision them automatically.Verified email
Use this policy when you need an explicit email-ownership assertion, or when users can register or edit their email without company approval. Your provider must send a trustworthy email verification claim, mapped to Cognito’semail_verified attribute, with Boolean true or the string true.
False or missing claims reject sign-in, including repeat sign-ins from already linked identities. Merely storing an address or authenticating a user does not prove ownership of that address. Your provider can use an email confirmation step, a trusted upstream source, or an existing controlled verification process.
Do not hardcode every address as verified when users can choose unverified addresses. That would allow someone to claim another person’s existing Forecastable account.
For an unknown user with a verified email, the existing pending-user behavior remains available in non-invite-only organizations. A pending user receives no effective role automatically. Invite-only organizations reject unknown users. Administrators must grant access explicitly.
Authentik
Starting with Authentik 2025.10, its default email mapping returnsemail_verified=false. This can be expected behavior, rather than an invalid login.
- For a company-controlled directory, leave Forecastable on Company-managed identities. Keep the email mapping correct and ensure users cannot claim other people’s addresses. You do not need to force email confirmation or change the false claim to true.
- For Verified email, follow Authentik’s email verification guide. Replace the default email scope mapping with a custom mapping reflecting your real verification process. Clear or update verification whenever the address changes.