クライアントを作成
新しいクライアント(アプリケーションまたは SSO 連携)を作成します。詳細は、Create Applications API Endpoints for Single Sign-On を参照してください。
注:
- 安全なシークレットを生成できるよう、
client_secretパラメーターは指定しないことを推奨します。 client_authentication_methodsプロパティとtoken_endpoint_auth_methodプロパティは相互排他的です。クライアントを Private Key JWT 認証方法で設定するには、client_authentication_methodsを使用してください。それ以外の場合は、token_endpoint_auth_methodを使用して、クライアントを client secret(basic または post)、または認証方法なし(none)で設定してください。client_authentication_methodsを使用してクライアントを Private Key JWT 認証方法で設定する場合は、完全に定義された資格情報を指定してください。 これらの資格情報は、クライアントの Private Key JWT 認証で自動的に有効になります。client_authentication_methodsを設定するには、create:client_credentialsスコープが必要です。client_authentication_methodsを設定するには、jwt_configuration.algプロパティを RS256 に設定する必要があります。
このエンドポイント経由で作成された SSO 連携は、login リクエストを受け付け、ユーザープロファイル情報を共有します。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ボディ
このクライアントの名前(最小長: 1 文字、< または > は使用できません)。
^[^<>]+$このクライアントで有効になっているアドオンと、その関連設定。
委譲リクエストを実行できる許可済みクライアントおよび API ID のリストです。空の場合は、すべてのクライアントが許可されます。
1Auth0 から logout した後のリダイレクト先として有効な URL のカンマ区切りリストです。サブドメインにはワイルドカードを使用できます。
JavaScript から Auth0 API へのリクエストを許可する URL のカンマ区切りリストです(通常は CORS で使用)。デフォルトでは、すべてのコールバック URL が許可されます。このフィールドでは、必要に応じて他のオリジンも指定できます。サブドメインレベルではワイルドカードも使用できます(例: https://*.contoso.com)。これらの URL の検証時には、クエリ文字列とハッシュ情報は考慮されません。
このクライアントが表すアプリケーションの種類
native, spa, regular_web, non_interactive, resource_server, express_configuration, b2b_integration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag 承認が必要な場合にユーザーへ通知するための通知チャネルの配列。有効な値は guardian-push、email です。
1guardian-push, email B2B 連携クライアントの設定。
authentication 後に Auth0 がクライアントへのコールバックとして使用できる、許可リスト登録済み URL のカンマ区切りリストです。
SAML プロトコル用の audience/レルム のリストです。wsfed アドオンで使用されます。
1クライアント認証方法を定義します。
クライアントに関連付けられたメタデータ。文字列値を持つオブジェクト形式です(最大255文字)。メタデータプロパティは最大10個まで使用できます。フィールド名(最大255文字)は英数字で、使用できる特殊文字は次のとおりです: :,-+=_*?"/()<>@ [Tab] [Space]
このクライアントの準拠レベルを定義します。これにより、機能が制限される場合があります。
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null このクライアントが cross-origin authentication リクエストの実行に使用できるか(true)、またはそのようなリクエストが許可されていないか(false)を示します。
Auth0 のホスト型 login page ではなく独自ドメインで認証を行う場合に、cross-origin auth フローでクロスオリジン検証を実施するサイト上の場所の URL です。
カスタム login page の内容(HTML、CSS、JS)です。
1カスタム login page を使用する場合は true、それ以外は false。デフォルトは true です
カスタム login page の内容(HTML、CSS、JS)です(プレビューで使用)。
1デフォルトの組織IDとフローを定義します。
このクライアントの説明を自由記述で入力します(最大 140 文字)。
140このクライアントの WS-Fed レスポンスで使用される暗号化。
OIN Express Configuration機能で使用するアプリケーション固有の設定。
新しい Universal Login の FedCM ログイン設定を構成
WS-Federation で使用する HTML フォームテンプレートです。
1このアプリケーションでサポートされるグラントタイプのリストです。authorization_code、implicit、refresh_token、client_credentials、password、http://auth0.com/oauth/grant-type/password-realm、http://auth0.com/oauth/grant-type/mfa-oob、http://auth0.com/oauth/grant-type/mfa-otp、http://auth0.com/oauth/grant-type/mfa-recovery-code、urn:openid:params:grant-type:ciba、urn:ietf:params:oauth:grant-type:device_code、urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token を含めることができます。
1Cross App Access での ID-JAG の使用に関する設定。
login URI を開始するための URI です。https である必要があります
このクライアントがファーストパーティクライアントかどうか
true の場合、Token endpoint のブルートフォース保護において、auth0-forwarded-for ヘッダーで指定された IP をエンドユーザーの IP として信頼します。
クライアントのJWTに関する設定。
このクライアントに表示するロゴの URL です。推奨サイズは 150 x 150 ピクセルです。
ネイティブモバイルアプリ向けの追加設定。
クライアントのMy Organization Configurationに関する設定。
ネイティブソーシャルの設定
OIDC バックチャネル logout の設定(非推奨。代わりに oidc_logout を使用)
このクライアントが厳格な OIDC 仕様に準拠しているか(true)、またはレガシー機能を使用するか(false)を示します。
OIDCバックチャネルログアウトの設定
pre_login_prompt 中の organization 検出で使用できる方法を定義します。ユーザーは email、organization_name、またはその両方で organization を検出できます。
1pre_login_prompt 中に組織を検出する方法。email では、ユーザーはメールアドレスを入力してドメイン照合を行うことで自分の組織を見つけられます。一方、organization_name では、ユーザーが organization名 を直接入力する必要があります。これらの方法は組み合わせて使用できます。
email, organization_name client.organization_usage: 'require' の場合に、認証トランザクションをどのように進めるかを定義します。no_prompt(デフォルト)、pre_login_prompt、または post_login_prompt を指定できます。post_login_prompt には oidc_conformant: true が必要です。
no_prompt, pre_login_prompt, post_login_prompt organization に関して認証トランザクションをどのように進めるかを定義します。deny(デフォルト)、allow、または require を指定できます。
deny, allow, require プッシュ型認可リクエスト URI の有効期間を秒単位で指定します
10 <= x <= 600認証エラー時またはメール認証フローにおいて、Auth0 がユーザーをアプリケーションのコールバックURLにリダイレクトするかどうかを制御します。open_redirect_protection はリダイレクトの代わりにエラーページを表示し、メールテンプレートでコールバックドメインを非表示にします。allow_always は標準のリダイレクト動作を有効にします。サードパーティのクライアントでは、デフォルトで open_redirect_protection が使用されます。これは is_first_party が false で、third_party_security_mode が strict の場合にのみ適用されます。詳しくは、Redirect protection を参照してください。
allow_always, open_redirect_protection リフレッシュトークンの設定
このクライアントで Proof-of-Possession の使用を必須にします
このクライアントでプッシュ型認可リクエストの使用を必須にします
このクライアントにリンクされているリソースサーバーの identifier です。
1 - 600ネイティブからWebへのSSO の設定
JWT で保護された認可リクエスト(JAR)の設定。
リダイレクト URI が検証不能なコールバック URI(たとえば myapp:// のようなカスタム URI スキーマや localhost)を使用している場合に、ログインフロー中に確認プロンプトを表示するかどうかを制御します。
true に設定すると、確認プロンプトは表示されません。悪意のあるアプリからの保護を強化するため、false に設定することを推奨します。
詳細については https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation を参照してください。
SSO クライアントにのみ適用され、シングルサインオンを Auth0 が処理するか(true)、アイデンティティプロバイダーが処理するか(false)を決定します。
シングルサインオンを無効にする場合は true、それ以外は false(デフォルト: false)
サードパーティ クライアントのセキュリティモード。strict は、強化されたセキュリティ制御を適用します。これには、OAuth 2.1 への準拠、明示的な API 認可、サポート対象機能を厳選したセットが含まれます。permissive は既存の動作を維持し、以前からサードパーティ クライアントを使用している tenant でのみ利用できます。作成時に設定され、後から変更することはできません。
strict, permissive トークンエンドポイントに対して要求される認証方法を定義します。none(client secret を持たないパブリッククライアント)、client_secret_post(クライアントは HTTP POST パラメーターを使用)、または client_secret_basic(クライアントは HTTP Basic を使用)を指定できます。
none, client_secret_post, client_secret_basic トークン交換の設定。
Token Vault の特権アクセスに関する設定。
Cross-Origin Authentication、Device Flow、および web message response mode で使用する許可済みオリジンのカンマ区切りリストです。
レスポンス
クライアントが正常に作成されました。
このクライアントで有効になっているアドオンと、その関連設定。
委譲リクエストの実行を許可するクライアントおよび API ID のリスト。空の場合は、すべてのクライアントが許可されます。
Auth0 からログアウトした後のリダイレクト先として有効な URL のカンマ区切りリスト。サブドメインにはワイルドカードを使用できます。
JavaScript から Auth0 API へのリクエスト送信を許可する URL のカンマ区切りリスト(通常は CORS で使用)。デフォルトでは、すべてのコールバック URL が許可されます。必要に応じて、このフィールドで他のオリジンを指定できます。サブドメインレベルではワイルドカードも使用できます(例: https://*.contoso.com)。これらの URL を検証する際、クエリ文字列とハッシュ情報は考慮されません。
このクライアントが表すアプリケーションの種類
native, spa, regular_web, non_interactive, resource_server, express_configuration, b2b_integration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag 承認が必要な場合にユーザーへ通知するための通知チャネルの配列。有効な値は guardian-push、email です。
1guardian-push, email B2B 連携クライアントの設定。
認証後に Auth0 がクライアントへのコールバックとして使用できるよう許可された URL のカンマ区切りリスト。
SAML プロトコル用の audience/レルムのリスト。wsfed アドオンで使用されます。
クライアント認証方法を定義します。
このクライアントの ID です。
クライアントに関連付けられたメタデータ。文字列値を持つオブジェクト形式です(最大255文字)。メタデータプロパティは最大10個まで使用できます。フィールド名(最大255文字)は英数字で、使用できる特殊文字は次のとおりです: :,-+=_*?"/()<>@ [Tab] [Space]
Client secret(公開してはいけません)。
このクライアントの準拠レベルを定義します。これにより、機能が制限される場合があります。
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null このクライアントがクロスオリジン認証リクエストに使用できるか(true)、そのようなリクエストが許可されていないか(false)を示します。
Auth0 のホストする login page ではなく独自ドメインで認証を実行する場合に、クロスオリジン認証フローのクロスオリジン検証を行うサイト上の URL。
カスタム login page の内容(HTML、CSS、JS)。
カスタム login page を使用するか(true)、デフォルトで提供される login page を使用するか(false)を示します。
カスタム login page の内容(HTML、CSS、JS)。(プレビューで使用)
デフォルトの組織IDとフローを定義します。
このクライアントの説明を自由記述で入力します(最大 140 文字)。
このクライアントの WS-Fed レスポンスで使用される暗号化。
OIN Express Configuration機能で使用するアプリケーション固有の設定。
認可フロー中に使用する代替のクライアント識別子。CIMD ベースのクライアント識別子のみをサポートします。
外部メタデータ クライアントを作成した主体を示します。値 admin は、クライアントが Management API 経由で登録されたことを示します。値 client は、クライアントが動的に登録されたことを示します。このフィールドは、external_metadata_type が設定されている場合にのみ存在します。
admin, client クライアントの登録に使用された外部メタデータの種類を示します。このフィールドは通常のクライアントでは省略されます。値 cimd は、Client ID Metadata Document 経由で登録されたクライアントを示します。値 dcr は、Dynamic Client Registration 経由で登録されたクライアントを示します。
cimd, dcr 新しい Universal Login の FedCM ログイン設定を構成
WS-Federation で使用する HTML フォームテンプレート。
これが、レガシーなテナント設定を表すグローバルな「All Applications」クライアントであるか(true)、通常のクライアントであるか(false)を示します。
このアプリケーションでサポートされるグラントタイプのリスト。authorization_code、implicit、refresh_token、client_credentials、password、http://auth0.com/oauth/grant-type/password-realm、http://auth0.com/oauth/grant-type/mfa-oob、http://auth0.com/oauth/grant-type/mfa-otp、http://auth0.com/oauth/grant-type/mfa-recovery-code、urn:openid:params:grant-type:ciba、urn:ietf:params:oauth:grant-type:device_code、urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token を含めることができます。
クロスアプリアクセスにおける ID-JAG の使用に関する設定。
ログイン開始 URI。https である必要があります
このクライアントがファーストパーティクライアントであるか(true)、そうでないか(false)を示します。
true の場合、token endpoint での総当たり攻撃対策のため、auth0-forwarded-for ヘッダーで指定された IP をエンドユーザーの IP として信頼します。
private_key_jwt 認証で使用する公開鍵を含む JSON Web Key Set(JWKS)の URL。private_key_jwt 認証を使用する CIMD クライアントにのみ存在します。
クライアントのJWTに関する設定。
このクライアントに表示するロゴの URL。推奨サイズは 150 x 150 ピクセルです。
ネイティブモバイルアプリ向けの追加設定。
クライアントの My Organization Configuration に関連する設定。
このクライアントの名前です(最小 1 文字、< と > は使用不可)。
ネイティブソーシャルの設定
このクライアントが厳格な OIDC 仕様に準拠しているか(true)、またはレガシー機能を使用するか(false)を示します。
OIDCバックチャネルログアウトの設定
pre_login_prompt での organization 検出に使用できる方法を定義します。ユーザーは email、organization_name、またはその両方で organization を検出できます。
1pre_login_prompt 中に組織を検出する方法。email では、ユーザーはメールアドレスを入力してドメイン照合を行うことで自分の組織を見つけられます。一方、organization_name では、ユーザーが organization名 を直接入力する必要があります。これらの方法は組み合わせて使用できます。
email, organization_name client.organization_usage: 'require' の場合に、認証トランザクションをどのように進めるかを定義します。no_prompt(デフォルト)、pre_login_prompt、または post_login_prompt を指定できます。post_login_prompt には oidc_conformant: true が必要です。
no_prompt, pre_login_prompt, post_login_prompt organization に関して認証トランザクションをどのように進めるかを定義します。deny(デフォルト)、allow、または require を指定できます。
deny, allow, require プッシュ型認可リクエスト URI の有効期間を秒単位で指定します
10 <= x <= 600認証エラー時またはメール認証フローにおいて、Auth0 がユーザーをアプリケーションのコールバックURLにリダイレクトするかどうかを制御します。open_redirect_protection はリダイレクトの代わりにエラーページを表示し、メールテンプレートでコールバックドメインを非表示にします。allow_always は標準のリダイレクト動作を有効にします。サードパーティのクライアントでは、デフォルトで open_redirect_protection が使用されます。これは is_first_party が false で、third_party_security_mode が strict の場合にのみ適用されます。詳しくは、Redirect protection を参照してください。
allow_always, open_redirect_protection リフレッシュトークンの設定
このクライアントで Proof-of-Possession の使用を必須にします
このクライアントでプッシュ型認可リクエストの使用を必須にします
このクライアントが関連付けられているリソースサーバーの identifier。
ネイティブからWebへのSSO の設定
JWT で保護された認可リクエスト(JAR)の設定。
このクライアントに関連付けられた署名証明書。
リダイレクト URI が検証不能なコールバック URI(たとえば、myapp:// のようなカスタム URI スキーマや localhost)を使用している場合に、ログインフロー中に確認プロンプトを表示するかどうかを制御します。
true に設定すると、確認プロンプトは表示されません。悪意のあるアプリからの保護を強化するため、false に設定することを推奨します。
詳細は https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation を参照してください。
SSO クライアントにのみ適用され、シングルサインオンを Auth0 が処理するか(true)、IDプロバイダーが処理するか(false)を決定します。
シングルサインオンを無効にするか(true)、有効にするか(true)を示します。デフォルトは true です。
このクライアントが属する tenant の名前です。
サードパーティ クライアントのセキュリティモード。strict は、強化されたセキュリティ制御を適用します。これには、OAuth 2.1 への準拠、明示的な API 認可、サポート対象機能を厳選したセットが含まれます。permissive は既存の動作を維持し、以前からサードパーティ クライアントを使用している tenant でのみ利用できます。作成時に設定され、後から変更することはできません。
strict, permissive トークンエンドポイントに対して要求される認証方法を定義します。none(client secret を持たないパブリッククライアント)、client_secret_post(クライアントは HTTP POST パラメーターを使用)、または client_secret_basic(クライアントは HTTP Basic を使用)を指定できます。
none, client_secret_post, client_secret_basic トークン交換の設定。
Token Vault の特権アクセスに関する設定。
Cross-Origin Authentication、Device Flow、およびweb message response modeでの使用を許可するオリジンのカンマ区切りリスト。