メインコンテンツへスキップ
Auth0 は、Okta、Microsoft Entra ID、Google Workspace などの外部のフェデレーション型アイデンティティ プロバイダー(IdP(アイデンティティ プロバイダー))でユーザーを認証するための Enterprise Connection を提供します。設定済みの接続には、外部 IdP とのシングル サインオン(SSO)、ユーザー プロビジョニング、およびログアウト連携を統合するためのプロトコル固有の設定に加え、その接続が Auth0 の Universal Login や組織機能とどのように連携するかを制御するプライベート設定が含まれます。 Connection プロファイル(CP)により、Auth0 開発者は、サードパーティによって作成される Auth0 の Connection のプライベート設定をどのように構成するかを指定できます。

仕組み

  • プロファイル定義

    管理者は Connection プロファイルを作成し、Auth0 の委任管理機能のいずれかを使用して接続が作成されるたびに、その接続に書き込まれるべきプロパティ値を定義します。
  • 柔軟なスコープ

    プロファイルは現在、セルフサービス SSO と Okta Express Configuration のフローに関連付けられていますが、プロビジョニング、オンボーディング、権限管理、将来の Auth0 機能など、より幅広い用途で再利用できるように設計されています。

Connection Profile プロパティ

Connection Profile は、新しく作成されるすべての接続に適用される、以下の設定可能なプロパティをサポートする JSON オブジェクトです。
PropertyDescription
connection_name_prefix_template接続の名前付けに使用しなければならないプレフィックスを表します。接続の name パラメータにマッピングされます。この値は、組織 ID と組織名に対する変数置換をサポートします。最終的なプレフィックスを生成するために、OIN ワークフローがこれらの値を置換する必要があります。変数は中括弧 () で囲みます。

サポートされる変数:

例: con-{org_id}-
enabled_featuresこのリストは、構成済み接続でサポートされる機能を指定します。リストにない機能は許可されません。

サポートされる値:
  • scim: 指定されている場合、SCIM を接続で構成できます。
  • universal_logout: 指定されている場合、この接続で Universal Logout 機能を使用できます。
organization.assign_membership_on_loginログイン時に、ユーザーを自動的にその組織のメンバーとして割り当てるかどうかを指定します。これは、組織の enabled_connections サブリソースの assign_membership_on_login プロパティにマッピングされます。
Okta との Express Configuration 連携では、optionalrequired として扱われます

Connection Profile の値Enabled Connections の assign_membership_on_login の値
nonefalse
optionalfalse
requiredtrue
organization接続が作成される組織に適用される設定を含むオブジェクトです。
organization.show_as_button組織が選択された後に、ログイン画面で接続をボタンとして表示するかどうかを指定します。これは、有効化された接続の show_as_button 値にマッピングされます。
Connection Profile の値接続の show_as_button の値
nonefalse
optionaltrue
requiredtrue

Connection プロファイルの例

{
  "organization": {
    "show_as_button": "none",
    "assign_membership_on_login": "none"
  },
  "connection_name_prefix_template": "ec-{org_id}-",
  "enabled_features": [
    "scim",
    "universal_logout"
  ]
}

Connection プロファイルの作成と管理

Connection プロファイルは、Okta の Express Configuration 機能を使用すると自動的に生成されます。また、Auth0 Management API を使用して Connection プロファイルを作成および管理することもできます。

Management API で設定する

Management API を使用するには、Management API アクセストークン を取得する必要があります。Connection プロファイルを管理するために、次の Management API エンドポイントを使用できます。
  • POST /api/v2/connection-profiles
  • GET /api/v2/connection-profiles
  • PATCH /api/v2/connection-profiles/{id}
  • GET /api/v2/connection-profiles/{id}
  • GET /api/v2/connection-profiles/templates

関連情報