Skip to content

Okta integration

People sign in to EvenTier with Okta over SAML 2.0 or OpenID Connect (OIDC), and Okta's SCIM provisioning creates, updates and deactivates their EvenTier accounts. Groups pushed from Okta add people to teams and, for the roles you allow, assign roles.

Set up in
Admin → Settings → Organization settings → Authentication
Who can set it up
Sign-in: a full administrator. SCIM: the Manage settings permission.

Single sign-on with Okta

Connect Okta as the workspace's identity provider (IdP) for your verified email domains, test the connection, then require single sign-on (SSO). Once SSO is required and the connection is on and complete, people sign in through Okta, and password sign-in and password resets are turned off.

  • SAML needs Okta to sign both the response and the assertion. The email is read from an email or mail attribute, or from an email-format NameID
  • OIDC asks for the openid, profile and email scopes, uses PKCE, and checks the ID token's signature against Okta's published keys
  • Just-in-time (JIT) provisioning creates Employees or Agents on first sign-in. Administrators are invited or promoted by hand
  • The login IP allowlist applies to sign-ins through Okta too

SCIM provisioning

Turn on SCIM provisioning in the Okta app with EvenTier's SCIM base URL and a bearer token. Okta then creates and updates people, deactivates them when they are unassigned, and pushes groups and their members.

  • The SCIM userName is the person's email address
  • PATCH and filtered lookups are supported. Bulk operations are not
  • A delete from Okta deactivates the account and keeps its request history
  • New SCIM users start as Employees

Groups mapped to teams and roles

A pushed group named "Team: <team name>" adds its members to that team. A group named "Role: <role name>" assigns that role, if you turn on Directory sync can assign this role for it in Admin → Roles. Groups whose names match no team or role are listed under SCIM group mapping, where an admin picks one for each.

  • Removing someone from a group removes the team or role it gave them, unless another group still grants it
  • Workspace admins are notified when a group grants a role or adds people to a team

Limits on what SCIM can change

SCIM never deactivates the only person who can manage users and roles, and never changes the sign-in email of someone with administrator access. Make those changes in Admin → Users. Every SCIM change is written to the audit log.

Set up Okta

  1. 01

    Verify your email domain

    Enter your email domain. At your DNS provider, publish the TXT record shown on the page at _eventier-login.<domain>, then choose Verify. Add any other domain your staff sign in with under Additional verified domains. A verified domain stays trusted for 90 days after its last successful check.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  2. 02

    Connect Okta over SAML

    Choose Provider type SAML 2.0. In Okta, create a SAML 2.0 app integration with the ACS URL and SP entity ID shown in EvenTier. Set it to sign both the response and the assertion and to send the user's email. Paste Okta's IdP SSO URL, IdP entity ID and X.509 signing certificate into EvenTier. EvenTier's metadata is also published at https://<your host>/api/org-auth/saml/<workspace slug>/metadata.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  3. 03

    Or connect Okta over OIDC

    Choose Provider type OIDC. In Okta, create an OIDC web application with this redirect URI: https://<your host>/api/org-auth/oidc/callback. Paste the issuer URL, client ID and client secret into EvenTier, then the authorization, token and user info URLs from <issuer>/.well-known/openid-configuration. EvenTier sends the client secret in the body of the token request (client_secret_post).

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  4. 04

    Test, then require SSO

    Turn the connection on and choose whether new users are created automatically, and with which role. Choose Test SSO. Once the test passes, set Authentication mode to SSO required. EvenTier lets you require SSO only when the connection covers your own email domain.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  5. 05

    Turn on SCIM provisioning

    Turn SCIM on, choose when the token expires and generate it. It is shown only once. In the Okta app, turn on SCIM provisioning and enter https://<your host>/api/scim/v2/<workspace slug> as the SCIM connector base URL. Use userName as the unique identifier for users, and HTTP Header authentication with the token.

    Where:
    Admin → Settings → Organization settings → Authentication → SCIM provisioning
    Permission:
    Manage settings
  6. 06

    Map groups to teams and roles

    On each role a group may grant, turn on Directory sync can assign this role. Then push your groups from Okta. For a group whose name matches no team or role, pick one under SCIM group mapping.

    Where:
    Admin → Roles · Admin → Settings → Organization settings → Authentication → SCIM group mapping
    Permission:
    Manage roles and Manage settings

Data flow

EvenTier receives only what Okta sends at sign-in and through SCIM. It has no standing access to your Okta directory.

At sign-in

  • A signed SAML response and assertion, or an OIDC ID token and user info
  • Email address and name, and the OIDC picture claim when Okta sends one

Through SCIM

  • The user name (the email address), name, display name, title, external ID and whether the account is active
  • Group names and their members
  • The photos attribute, when Okta sends it

Stored by EvenTier

  • The OIDC client secret or SAML certificate, encrypted at rest
  • SCIM tokens, stored as hashes
  • An audit log entry for every SCIM change

Questions about Okta

Should I use SAML or OIDC with Okta?
Either works, and a workspace connects one identity provider at a time. With OIDC, the standard picture claim becomes the member's profile photo. SAML has no standard photo attribute, so send photos through SCIM instead.
What happens when someone is unassigned in Okta?
Okta deactivates them over SCIM. They can no longer sign in to EvenTier, and their requests and history are kept.
Can Okta groups assign roles?
Yes, for each role where you turn on Directory sync can assign this role in Admin → Roles. Leave it off for privileged roles. An admin can still map a group to any role under SCIM group mapping.
Does EvenTier need API access to Okta?
No. Okta calls EvenTier's SCIM endpoint with a token you generate in EvenTier, and sign-in uses the standard SAML or OIDC flow.

Get notified when signup opens.

EvenTier is in private early access. Leave your work email and we will let you know when you can create a workspace.

No card. We use your email only for your early-access invite and launch news. Privacy Policy