Skip to content
Dashboard
Theme
Theme

Shared connections

Use one SSO connection for several organizations, with the owner's consent and per-organization domain routing.

View Markdown

A shared connection lets several organizations in one environment sign in through one identity provider connection: for example, the subsidiaries of a group that runs a single Okta tenant.

  • POST /v1/connections/{conn}/shares shares the owning organization’s connection with another organization, with the routing_domains that send users there. owner_consent: true records that the owning organization agreed.
  • GET /v1/connections/{conn}/shares lists shares.
  • DELETE /v1/connections/{conn}/shares/{share} revokes one. Revocation applies to the next sign-in.

Sign-ins through a shared connection are routed to the right organization by the user’s email domain. Events: connection.shared and connection.share_revoked. An invalid share request answers connection_share_invalid. Terraform: ohauthcat_connection_share.