id によるクライアントの更新
クライアントの設定を更新します。詳しくは、Applications in Auth0 および Single Sign-On を参照してください。
注:
client_secret属性とsigning_key属性は、update:client_keysスコープでのみ更新できます。client_authentication_methodsプロパティとtoken_endpoint_auth_methodプロパティは相互に排他的です。クライアントを Private Key JWT 認証で構成するにはclient_authentication_methodsを使用してください。それ以外の場合は、token_endpoint_auth_methodを使用して、クライアントシークレット(basic または post)または認証方法なし(none)でクライアントを構成してください。client_authentication_methodsを使用してクライアントを Private Key JWT 認証で構成する場合は、クライアントで認証情報を作成したときに生成されたクレデンシャル ID のみを指定してください。client_authentication_methodsを構成するには、update:client_credentialsスコープが必要です。client_authentication_methodsを構成するには、jwt_configuration.algプロパティを RS256 に設定する必要があります。- クライアントの
is_first_partyプロパティをfalseに変更するには、organization_usageプロパティとorganization_require_behaviorプロパティを未設定にする必要があります。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
パスパラメータ
更新するクライアントの ID。
ボディ
このクライアントで有効になっているアドオンと、それぞれに関連付けられた設定。
デリゲーションリクエストの実行を許可するクライアントの id。一覧を指定しない場合は、デフォルトですべてのクライアントが許可されます。このフィールドを使用すると、特定のクライアントを指定できます。
1Auth0 からログアウトした後のリダイレクト先として有効な URL
CORS で有効なオリジンを表す URL のセット
このクライアントが表すアプリケーションの種類
native, spa, regular_web, non_interactive, resource_server, express_configuration, 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 ユーザー認証時に Auth0 からコールバックできる有効な URL のセット
SAML プロトコルのオーディエンスの一覧
1クライアント認証方法を定義します。
クライアントに関連付けられたメタデータ。文字列値を持つオブジェクト形式です(最大255文字)。メタデータのプロパティは最大10件まで指定できます。フィールド名(最大255文字)は英数字で、使用できる特殊文字は次のとおりです: :,-+=_*?"/\()<>@\t[Tab] [Space]
クライアントのトークン署名に使用するシークレット
1このクライアントの準拠レベルを定義します。これにより、機能が制限される場合があります。
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null このクライアントをクロスオリジン認証リクエストに使用できる場合は true、クロスオリジンが無効な場合は false
Auth0 のホスト型ログインページではなく独自ドメインで認証を実行する場合に、クロスオリジン認証フローでクロスオリジン検証を行うサイト上の場所の URL。
カスタムログインページのコンテンツ(HTML、CSS、JS)
カスタムログインページを使用する場合は true、それ以外の場合は false。
デフォルトの組織 ID とフローを定義します。
クライアントの用途に関する自由記述の説明です。(最大文字数: 140)
140クライアントの暗号化キー
OIN Express Configuration 機能で使用するアプリケーション固有の設定。
New Universal Login の FedCM ログイン設定を構成します
WS-Federation プロトコル用のフォームテンプレート
クライアントが使用を許可されているグラントタイプのセット。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 を含めることができます。
1ログイン開始 URI。https である必要があります
このクライアントがファーストパーティクライアントかどうか
true の場合、トークンエンドポイントのブルートフォース対策において、auth0-forwarded-for ヘッダーで指定された IP をエンドユーザーの IP として信頼します。
JWT の作成方法に関する設定を保持するオブジェクト
クライアントロゴの URL(推奨サイズ: 150x150)
ネイティブモバイルアプリに関する設定
クライアントの My Organization Configuration に関連する設定。
クライアントの名前。1 文字以上である必要があります。'<' または '>' は使用できません。
^[^<>]+$ネイティブソーシャル設定を構成
OIDC バックチャネルログアウトの設定(非推奨。代わりに oidc_logout を使用)
このクライアントが厳密な OIDC 仕様に準拠するかどうか
OIDC バックチャネルログアウトの設定
pre_login_prompt での組織検出に使用できる方法を定義します。ユーザーは email、organization_name、またはその両方を使って自分の組織を検出できます。
1pre_login_prompt 中に組織を特定する方法。email では、ユーザーがメールアドレスを入力してドメイン照合を行うことで組織を見つけられます。一方、organization_name では、ユーザーが組織名を直接入力する必要があります。これらの方法は組み合わせて使用できます。
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, null 組織に関して、認証トランザクション中にどのように処理を進めるかを定義します。deny(デフォルト)、allow、require のいずれかを指定できます。
deny, allow, require, null プッシュ型認可リクエスト 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 リフレッシュトークンの設定
このクライアントでは所有証明の使用が必須です
このクライアントでは、プッシュ型認可リクエストの使用が必須になります
ネイティブから Web への SSO の設定
JWT-Secured Authorization Requests(JAR)の設定。
リダイレクト URI に検証不能なコールバック URI(たとえば、myapp:// のようなカスタム URI スキームや localhost)が使用されている場合に、ログインフロー中に確認プロンプトを表示するかどうかを制御します。
true に設定すると、確認プロンプトは表示されません。悪意のあるアプリによるなりすましへの保護を強化するため、この設定は false にすることを推奨します。
詳細については、https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation を参照してください。
シングルサインオンの実行に IdP ではなく Auth0 を使用する場合は true、それ以外の場合は false(デフォルト: false)
シングルサインオンを無効にする場合は true、それ以外の場合は false(デフォルト: false)
サードパーティクライアントのセキュリティモード。strictは強化されたセキュリティ制御を適用します。これには、OAuth 2.1への準拠、明示的なAPI認可、サポート対象機能を厳選したセットが含まれます。permissiveは従来の動作を維持し、過去にサードパーティクライアントの使用実績があるテナントでのみ利用できます。作成時に設定し、後から変更することはできません。
strict, permissive トークンエンドポイントに対して要求する認証方法を定義します。none(クライアントシークレットを持たないパブリッククライアント)、client_secret_post(クライアントがHTTP POSTパラメーターを使用)、またはclient_secret_basic(クライアントがHTTP Basicを使用)を指定できます。
none, client_secret_post, client_secret_basic, null トークン交換の設定。
web message response mode で使用する有効な Web オリジンを表す URL のセット
レスポンス
クライアントを正常に更新しました。
このクライアントで有効になっているアドオンと、それぞれに関連付けられた設定。
デリゲーションリクエストを実行できる許可済みクライアントおよび API id のリスト。空の場合は、すべてのクライアントが許可されます。
Auth0 からログアウトした後のリダイレクト先として有効な URL のカンマ区切りリスト。サブドメインにはワイルドカードを使用できます。
JavaScript から Auth0 API へのリクエストを許可する URL のカンマ区切りリストです(通常は CORS で使用されます)。デフォルトでは、すべてのコールバック URL が許可されます。このフィールドでは、必要に応じて別のオリジンを入力できます。サブドメインレベルのワイルドカード(例: https://*.contoso.com)も使用できます。これらの URL の検証時には、クエリ文字列とハッシュ情報は考慮されません。
このクライアントが表すアプリケーションの種類
native, spa, regular_web, non_interactive, resource_server, express_configuration, 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 認証後に Auth0 がクライアントへのコールバックとして使用できる、許可済み URL のカンマ区切りリスト。
SAML プロトコル用のオーディエンス / レルムのリスト。wsfed アドオンで使用されます。
クライアント認証方法を定義します。
このクライアントの ID。
クライアントに関連付けられたメタデータ。文字列値を持つオブジェクト形式です(最大255文字)。メタデータのプロパティは最大10件まで指定できます。フィールド名(最大255文字)は英数字で、使用できる特殊文字は次のとおりです: :,-+=_*?"/\()<>@\t[Tab] [Space]
クライアントシークレット(公開してはいけません)。
このクライアントの準拠レベルを定義します。これにより、機能が制限される場合があります。
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null このクライアントをクロスオリジン認証リクエストに使用できるか(true)、そのようなリクエストが許可されていないか(false)を示します。
Auth0 のホスト型ログインページではなく独自のドメインで認証を実行する場合に、クロスオリジン認証フローでクロスオリジン検証を行うサイト上の場所の URL。
カスタムログインページのコンテンツ(HTML、CSS、JS)。
カスタムログインページを使用する(true)か、提供されるデフォルトのログインページを使用する(false)かを示します。
カスタムログインページのコンテンツ(HTML、CSS、JS)。(プレビューで使用)
デフォルトの組織 ID とフローを定義します。
このクライアントの説明を自由記述で指定します(最大長: 140 文字)。
このクライアントの WsFed レスポンスで使用される暗号化。
OIN Express Configuration 機能で使用するアプリケーション固有の設定。
認可フロー中に使用する代替クライアント識別子です。CIMD ベースのクライアント識別子のみサポートされます。
外部メタデータ クライアントを作成した主体を示します。値 admin は、クライアントが Management API 経由で登録されたことを示します。値 client は、クライアントが動的に登録されたことを示します。このフィールドは、external_metadata_type が設定されている場合にのみ存在します。
admin, client クライアントの登録に使用された外部メタデータの種類を示します。このフィールドは通常のクライアントでは省略されます。値 cimd は、Client ID Metadata Document 経由で登録されたクライアントを示します。値 dcr は、動的クライアント登録によって登録されたクライアントを示します。
cimd, dcr 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 を含めることができます。
ログイン開始 URI。https である必要があります
このクライアントがファーストパーティクライアント(true)かどうか(false)を示します。
true の場合、トークンエンドポイントでのブルートフォース対策のため、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 での組織検出に使用できる方法を定義します。ユーザーは email、organization_name、またはその両方で自分の組織を検出できます。
1pre_login_prompt 中に組織を特定する方法。email では、ユーザーがメールアドレスを入力してドメイン照合を行うことで組織を見つけられます。一方、organization_name では、ユーザーが組織名を直接入力する必要があります。これらの方法は組み合わせて使用できます。
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 組織に関して、認証トランザクション中にどのように処理を進めるかを定義します。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 リフレッシュトークンの設定
このクライアントでは所有証明の使用が必須です
このクライアントではプッシュ型認可リクエストの使用が必須です
このクライアントが関連付けられているリソースサーバーの識別子です。
ネイティブから Web への SSO の設定
JWT-Secured Authorization Requests(JAR)の設定。
このクライアントに関連付けられた署名証明書。
リダイレクト URI で検証できないコールバック URI(たとえば、myapp:// のようなカスタム URI スキーマや localhost)を使用している場合に、Login フロー中に確認プロンプトを表示するかどうかを制御します。
true に設定すると、確認プロンプトは表示されません。悪意のあるアプリからの保護を強化するため、この設定は false にすることを推奨します。
詳細については、https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation を参照してください。
SSO クライアントにのみ適用され、Auth0 がシングルサインオンを処理するか(true)、IDプロバイダーが処理するか(false)を決定します。
シングルサインオンが無効(true)か有効(false)かを示します。デフォルトは true です。
このクライアントが属するテナントの名前。
サードパーティクライアントのセキュリティモード。strictは強化されたセキュリティ制御を適用します。これには、OAuth 2.1への準拠、明示的なAPI認可、サポート対象機能を厳選したセットが含まれます。permissiveは従来の動作を維持し、過去にサードパーティクライアントの使用実績があるテナントでのみ利用できます。作成時に設定し、後から変更することはできません。
strict, permissive トークンエンドポイントに対して要求する認証方法を定義します。none(クライアントシークレットを持たないパブリッククライアント)、client_secret_post(クライアントがHTTP POSTパラメーターを使用)、またはclient_secret_basic(クライアントがHTTP Basicを使用)を指定できます。
none, client_secret_post, client_secret_basic トークン交換の設定。
クロスオリジン認証、デバイスフロー、および web message response mode で使用する許可済みオリジンのカンマ区切りリスト。