# OAuth クライアントの作成と管理

OAuth は、承認と委任のためのセキュリティ プロトコルです。このプロトコルより、サード パーティのアプリケーションは、エンド ユーザーの資格情報を開示せずに API リソースにアクセスできます。OAuth クライアントは認証コードを要求し、それをアクセス トークンと交換し、そのトークンを使用して API を通じて Qlik Cloud コンテンツにアクセスします。

## OAuth クライアント タイプ

OAuth クライアントとは、ユーザーに代わってQlik Cloud のリソースへのアクセスを要求するウェブ アプリケーションまたはソフトウェアのことです。OAuth は、アプリケーション (クライアント) と認可サーバー (Qlik Cloud) 間の認可を保護するために、パブリック クライアントと機密クライアントの 2 つのクライアント タイプを定義します。

Qlik Cloud では、従来のウェブ (サーバー側) の機密クライアントと、特定の認証フローを使用するネイティブおよびシングル ページ アプリケーションのパブリック クライアントをサポートしています。

クライアント タイプに関する公式の OAuth 2.0 仕様については、次を参照してください。[RFC 6749 セクション 2.1: OAuth 2.0 クライアント タイプ](https://oauth.net/2/client-types/ "RFC 6749 セクション 2.1: OAuth 2.0 クライアント タイプ")。

### パブリック クライアント

パブリック クライアントは、必要な認証情報の機密性を保持できないため、クライアント シークレットを使用しないアプリケーションです。Qlik Cloud では、これらには分析機能が組み込まれたシングル ページ アプリケーション (SPA) や、ユーザー認証を必要とする Qlik Sense のカスタム ビジュアライゼーション拡張機能などのフロントエンド アプリケーションが含まれます。

### 機密クライアント

機密クライアントは、クライアント ID とクライアント シークレットを安全に保存し、承認サーバーとの認証に使用できます。これらのクライアントはクライアント シークレットを所有しているため、保護されたリソースにアクセスできます。

例: Qlik Cloud API と対話してユーザー アクセスを管理したり、データ更新タスクを調整したりする、安全なバックエンドを備えたウェブ アプリケーション。

## OAuth 認証フロー

Qlik では、次の 2 つの認可フロー (付与タイプ) をサポートしています。

* 認可コード フロー: 機密クライアント向け。

* コード交換用証明キー (PKCE) 対応の認可コード フロー: パブリック クライアント向け。

### 認可コード フロー

このフローは、ソース コードが公開されていないサーバー側のアプリケーションで使用されます。アクセス トークンと認可コードを交換し、認証にはクライアント シークレットを使用します。このフローを使用するウェブ アプリケーションは、トークン交換中にクライアント シークレットが承認サーバーに渡されるため、サーバー側である必要があります。

情報メモテナントのセキュリティが損なわれるため、クライアント シークレットは決して公開しないでください。安全に非公開で保管してください。

認可コード フローの詳細については、OAuth 2.0 の公式ドキュメントを参照してください。[認可コード フロー](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow "認可コード フロー")。

### PKCE 対応の認可コード フロー

ネイティブ アプリケーションやシングル ページ アプリケーションでは、ソース コードがブラウザーで逆コンパイルまたは検査される可能性があるため、クライアント シークレットを安全に保存できません。PKCE は、アクセス トークンを取得するためにコード検証の使用を要求することでセキュリティを強化します。

PKCE による認可の詳細については、公式の OAuth 2.0 ドキュメントを参照してください。[Proof Key for Code Exchange (PKCE) を使用した認可コード フロー](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-proof-key-for-code-exchange-pkce "コード交換用証明キー (PKCE) 対応の認可コード フロー")。

## OAuth のスコープと権限

OAuth スコープは、OAuth クライアント アプリケーションに付与されるアクセス レベルを定義します。たとえば、アクセス トークンを使用すると、リソースへのフル アクセスを許可することや、読み取り専用のアクセスに制限することができます。Qlik Cloud では、スコープによって利用可能な機能とリソースへのクライアント アクセスが制御されます。スコープがないと、クライアントはリソースにアクセスできません。

情報メモ

API 資格情報は Qlik Cloud への直接的なプログラムによるアクセスを提供し、ユーザー インターフェイスで利用可能なワークフローに限定されません。最小権限の原則を使用して、ロールと OAuth スコープを割り当てます。サービス アカウントと API 資格情報は、管理者資格情報と同じレベルで慎重に取り扱ってください。詳細については、「[API アクセス制御と信頼境界](https://qlik.dev/manage/access-control/api-trust-boundaries/)」を参照してください。

### 使用可能な OAuth スコープ

次の表には、使用可能なスコープとそれに関連付けられた権限が示されています。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm)

#### 利用可能なスコープと関連する権限

| 範囲 | 権限 |
| --- | --- |
| user\_default | アカウントとコンテンツへのフルアクセス |
| admin\_classic | テナントへの完全な管理者アクセス<br><br>関連項目: [展開と管理Qlik Cloud](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/qlik-sense-administration.htm)<br><br>情報メモシングル ページ アプリまたはネイティブ クライアント タイプではサポートされません。 |
| admin.apps | テナント内のすべてのアプリケーションを読み取って管理します。<br><br>関連項目: [アプリケーションの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/manage-apps.htm) |
| the 子アイテムを示す icon admin.apps:export | テナント内のすべてのアプリケーションをエクスポート<br><br>関連項目: [アプリのダウンロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/export-apps-cloud-hub.htm) |
| the 子アイテムを示す icon admin.apps:read | テナント内のすべてのアプリケーションを読み取る |
| admin.automations | テナント内のすべての自動化を読み取って管理する<br><br>関連項目: [オートメーションの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-managing-automations.htm) |
| the 子アイテムを示す icon admin.automations:read | テナント内のすべての自動化を読み取る |
| admin.direct-access-gateways:remote\_configuration | Direct Access gateway 設定の編集<br><br>参照: [設定とトラブルシューティング Qlik Data Gateway - 直接アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm) および[パブリック API](https://qlik.dev/apis/rest/direct-access-agents/)。 |
| admin.spaces | テナント内のすべてのスペースを読み取って管理する<br><br>関連項目: [スペースの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the 子アイテムを示す icon admin.spaces:read | テナント内のすべてのスペースを読み取る |
| アプリ | アプリケーションを読み取って管理する<br><br>関連項目: [アプリケーションの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/manage-apps.htm) |
| the 子アイテムを示す icon apps:export | アプリケーションをエクスポートする<br><br>関連項目: [アプリのダウンロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/export-apps-cloud-hub.htm) |
| the 子アイテムを示す icon apps:read | アプリケーションを読み取る |
| 自動化 | 自動化を読み取って管理する<br><br>関連項目: [オートメーションの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-managing-automations.htm) |
| the 子アイテムを示す icon automations:read | 自動化を読み取る |
| automl-experiments | ML 実験の読み取りと管理 |
| automl-deployments | ML 展開の読み取りと管理 |
| direct-access-gateways:consume\_data | Direct Access gateway コネクタ経由でデータをロード<br><br>関連項目: [Qlik Data Gateway - 直接アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway.htm) |
| identity.email:read | メール アドレスを読み取る<br><br>関連項目: [Qlik Cloud の ID プロバイダー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-idp-configuration.htm) |
| identity.name:read | フルネームを読み取る |
| identity.picture:read | プロフィール写真を読み取る<br><br>関連項目: [Qlik Cloud の ID プロバイダー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-idp-configuration.htm) |
| identity.subject:read | ユーザー サブジェクト識別子を読み取る |
| spaces.data | データ スペースを読み取って管理する<br><br>関連項目: [スペースの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the 子アイテムを示す icon spaces.data:read | データ スペースを読み取る |
| spaces.managed | 管理スペースを読み取って管理する<br><br>関連項目: [スペースの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the 子アイテムを示す icon spaces.managed:read | 管理スペースを読み取る |
| spaces.shared | 共有スペースを読み取って管理する<br><br>関連項目: [スペースの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the 子アイテムを示す icon spaces.shared:read | 共有スペースを読み取る |
| offline\_access | オフライン時にリソースにアクセスする<br><br>情報メモシングル ページ アプリ クライアント タイプではサポートされません。 |

情報メモこのリストは、初期リリースでサポートされているスコープを反映しています。スコープの完全なリストは、Qlik 開発者ポータルの「[スコープ](https://qlik.dev/manage/access-control/scopes/)」で確認できます。

## OAuth クライアントの作成

テナント管理者は、管理OAuth ページの アクティビティ センターで OAuth クライアントを管理します。OAuth クライアントを使用すると、クライアント アプリケーションを Qlik Cloud と統合して、リソースに安全にアクセスできます。

### OAuth クライアントのセットアップ方法

OAuth クライアントは、次のいずれかの方法で設定できます。

* 手動クライアント セットアップ (静的登録): テナント内でクライアント定義を直接作成および維持します。セットアップ中にクライアント設定を完全に制御する場合は、この方法を使用します。

* 動的クライアント登録 (DCR) テナントレベルの DCR 設定に基づいて、互換性のあるアプリケーションが OAuth クライアントを動的に登録できるようにします。詳細については、「[OAuth Dynamic Client Registration の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm)」を参照してください。

### OAuth クライアントの制限

次の制限が適用されます。

* クライアントごとに最大 5 個のリダイレクト URL。

* クライアントごとに最大 5 個のオリジンを許可。

* クライアントごとに最大 5 個のクライアント シークレット。

* テナントあたり最大 200 個の OAuth クライアント。

### OAuth クライアントを作成するステップ

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。

2. [新規作成] をクリックします。

3. 次のクライアント タイプを選択します。

   * 機密クライアント向けの [Web]。

   * パブリック クライアント向けの [シングル ページ アプリ] または [ネイティブ]。

   * 公開クライアント向けの [匿名埋め込み] 。

4. ダイアログで、OAuth クライアントの名前を入力します。

5. 必要に応じて、説明を追加します。

6. スクロールまたは検索フィールドを使用して、使用可能ないずれかのスコープを選択します。

   ヒント メモ[すべて] ボタンおよび [選択済み] ボタンを使用して、すべてのスコープを表示するか、選択したスコープのみを表示します。

7. OAuth クライアント アプリケーションの 1 つ以上のリダイレクト URL を入力します (最大 5 個)。次に、 [追加] をクリックしてリダイレクト URL を許可リストに追加します。

   * リダイレクト URL は、クライアント アプリケーションの認証と権限の付与に成功した後に、承認サーバーがユーザーのブラウザーを送信する場所です。たとえば、https://www.exampleアプリ.com/oauth/callback では、/oauth/callback は OAuth プロバイダーからの認証コールバックを処理します。

   * Qlik Cloud は、承認が成功した後、その URL がリダイレクト URL の許可リストに含まれている場合にのみ、ユーザーをアプリケーションにリダイレクトします。

   * ドメインが localhost でない限り、URL は https:// で始まる必要があります。ドメインが localhost の場合は、http:// で始めることができます。ネイティブ アプリケーションでは exampleapp:// のようなアプリケーションに特化したリンク形式も使用できます。

8. クライアント タイプが [Web] または [シングル ページ アプリ] の場合は、許可されたオリジンを 1 つ以上指定します (最大 5 つ)。

   * アプリケーションへのアクセスは、その URL が許可されたオリジン リストに追加されている場合にのみ許可されます。

9. クライアント タイプが Web の場合、ユーザーの介入なしで自動的にシステムにアクセスするために、次のいずれかのオプションを有効にできます。

   * マシンツーマシン (M2M) を許可: ユーザーの関与なしにシステム間通信を可能にします。

   * M2M ユーザーの成り代わりを許可: 認証プロセス中にアプリケーションがユーザーの代理として認証することを許可します。

10. クライアント タイプが [Web] の場合、 [認証方法] にあるオプションを 1 つまたは両方選択します。

    * クライアント シークレット (既定)

    * 秘密キー JWT は、共有シークレットの代わりに公開キー/秘密キーのペアを使用してクライアントを認証する、より安全なオプションです。

      * 秘密キー JWT を選択すると、 [公開キー] 項目が表示されます。サードパーティ アプリケーションの公開キーを JSON Web Key (JWK) 形式で入力します。秘密キーは、JWT への署名のためにアプリケーションに保持されます。公開キー形式の詳細については、次を参照してください。Qlik Developer Portal の「[JWT に署名するための公開キー/秘密キーのペアの作成](https://qlik.dev/authenticate/oauth/oauth-private-key-jwt-reference/ "JWT に署名するための公開キー/秘密キーのペアの作成")」。

        情報メモ公開キーは、使用中の ID プロバイダーの要件に応じて異なります。サード パーティ製アプリの公開キーが異なる形式である場合は、サードパーティ製ツールを使用して JWK 形式に変換してください。

11. [作成] をクリックします。

12. [クリップボードにコピー] をクリックして、後で使用できるようにクライアント ID とクライアント シークレットを保存します。クライアント シークレットを安全に保存します。

    情報メモパブリック クライアントにはクライアント シークレットがありません。

13. [完了] をクリックします。

## OAuth クライアントの管理

一部のベンダーは、ユーザーごとに 1 つ、複数の OAuth クライアントを動的に登録します。Qlik では、複数の登録を減らすために OAuth Client ID Metadata Documents (CIMD) の使用を推奨しています。この動作の詳細については、「[ベンダーからの複数の登録を管理する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm#ManagingVendors)」を参照してください。

### DCR および CIMD クライアントの識別

DCR および CIMD クライアントは、手動で作成されたクライアントと次の方法で区別できます。

* 管理 では、OAuth クライアント リストに [ソース] 列が表示されます。DCR クライアントのソース値は `DCR`、CIMD クライアントのソース値は `CIMD`、手動で作成されたクライアントのソース値は `User` です。

* API レスポンスには、DCR クライアントの場合は `dcr`、CIMD クライアントの場合は `cimd`、手動で作成されたクライアントの場合は `user` に設定された `createdByType` フィールドが含まれます。

* CIMD クライアントの場合、クライアント ID は LLM クライアントによって提供されるメタデータドキュメントの URL です。

ソースは、OAuth クライアントがどのように登録されたかを識別します。クライアント タイプは、 [ネイティブ] や [Web] などの OAuth クライアント モデルを示します。たとえば、Claude はパブリック クライアントである [ネイティブ] として表示され、ChatGPT はコンフィデンシャル クライアントである [Web] として表示されます。パブリックとコンフィデンシャルは、アプリケーションがどのように自身を認証するかを表します。これらはユーザー データがパブリックかコンフィデンシャルかを説明しておらず、ユーザーは引き続き自身のアカウントでサインインします。

## 特定のユース ケースに対応する OAuth クライアント

OAuth クライアントのユース ケースについては、次のリソースを参照してください。

* Qlik 開発者ポータルの [OAuth概要](https://qlik.dev/authenticate/oauth/ "OAuth の概要"): OAuth のユース ケースとさまざまな OAuth タイプの概要。

* [OAuth Dynamic Client Registration の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm): OAuth Dynamic Client Registration のテナント レベルの設定を構成します。

* [OAuth クライアント ID メタデータ ドキュメントの設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-client-id-metadata-documents.htm): CIMD 接続を構成および管理します。

* [Microsoft Office 用 Qlik アドインの OAuth クライアントの作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#Creating):Qlik 用の Microsoft Excel アドインをインストールするための OAuth クライアントを設定します。

* [アプリケーション コンテンツの匿名埋め込み用の OAuth クライアントの作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#CreateOAuth): 埋め込みアプリケーション コンテンツへの匿名アクセスを可能にする OAuth クライアントを作成します。

### Microsoft Office 用 Qlik アドインの OAuth クライアントの作成

Microsoft Office 用 Qlik アドインをインストールするには、OAuth クライアント構成が必要です。アドインは、レポート開発者が Qlik Cloud を使用したアプリケーション内レポート作成のためのレポート テンプレートを準備するために使用されます。

アドインで OAuth が機能するには、OAuth クライアントを以下に示すように正確に構成する必要があります。

次の手順を実行します。

1. Qlik Cloud で、画面左上の the ナビゲーション メニューを開く icon をクリックします。

2. 管理 を選択します。

3. OAuth に移動します。

4. [新規作成] をクリックします。

5. [クライアント タイプ] ドロップダウン メニューで、 [単一ページ アプリ] を選択します。その他の項目が表示されます。

6. [名前] を入力します。[説明] はオプションです。

7. 少なくとも、user\_default スコープを含めるチェックボックスをオンにします。構成に他のスコープを含めることはできますが、user\_default がないとインストールは機能しません。

   使用可能な各スコープの詳細については、「[使用可能な OAuth スコープ](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#Availabl)」を参照してください。

8. [リダイレクト URL の追加] 項目に、Qlik Cloud テナントの URL を入力し、その後に固定文字列 /office-add-ins/oAuthLoginSuccess.html を入力します。

   結果は https://&lt;tenant or alias hostname&gt;.&lt;region&gt;.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html になります。例: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

9. [追加] をクリックします。

10. [許可されているオリジンの追加] 項目にテナント URL を入力し、 [追加] をクリックします。

11. [作成] をクリックします。

12. [クライアント ID をコピー] ウィンドウが表示されます。クライアント ID をクリップボードにコピーするか、 [完了] をクリックしてウィンドウを閉じます。

OAuth クライアントを作成した後、管理 アクティビティ センターから更新されたマニフェスト XML リンクを取得します。[設定] ページに移動し、 [メールとレポート] タブを選択します。[共有とレポート] セクションで、 Microsoft Office 用 Qlik アドイン を選択します。提供されたリンクを使用して、アドインを展開およびインストールします。

マニフェスト ファイルの生成、およびアドインの展開とインストールの詳細については、次を参照してください。

* [Microsoft Office 用 Qlik アドインの展開とインストール](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

* [Microsoft Office 用 Qlik アドインのインストール マニフェストの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-add-in.htm)

### アプリケーション コンテンツの匿名埋め込み用の OAuth クライアントの作成

qlik-embed を使用して匿名アクセス用にアプリケーション コンテンツを埋め込むには、このユース ケース用に特別に設計されたタイプの OAuth クライアントを作成する必要があります。

情報メモ この機能は、Qlik Anonymous Access サブスクリプションでのみ使用できます。詳細については、「[Qlik Anonymous Access のサブスクリプション](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/subscription-options-anonymous.htm)」を参照してください。

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAth] セクションに移動します。

2. [新規作成] をクリックします。

3. [クライアント タイプ] ドロップダウン メニューで、 [匿名埋め込み] を選択します。

4. OAth クライアントの [名前] を入力し、必要に応じて [説明] を入力します。

5. [許可されているオリジン] に、承認が必要な各オリジンを入力します。これらは、埋め込み分析の情報を取得するために Qlik Cloud テナントにアクセスするドメインです。

   各 URL を挿入した後、 [追加] をクリックします。

6. 完了したら、 [作成] をクリックします。

7. [クリップボードにコピー] をクリックして、後で使用できるようにクライアント ID を保存します。アプリケーション コンテンツが qlik-embed に埋め込まれている場合に必要になります。

8. [完了] をクリックします。

## OAuth クライアントの編集

OAuth クライアントの名前を変更したり、説明を更新したり、リダイレクト URL を管理したりできます。

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。
2. 編集する OAuth クライアントを見つけます。
3. the 詳細 iconをクリックし、 [編集] を選択します。
4. 必要に応じて OAuth クライアント オプションを変更します。
5. [保存] をクリックします。

## OAuth クライアントの削除

OAuth クライアントが不要になったとき、またはアクセスを無効化するときに、OAuth クライアントを削除できます。

テナントに多数の OAuth クライアントがある場合は、OAuth クライアント リストのフィルタリングを使用して、ベンダーまたは名前パターンでクライアントを検索し、一致するクライアントを選択して一括で削除します。

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。

2. 削除する OAuth クライアントを 1 つ以上選択し、 [削除] をクリックします。

3. 削除を確定します。

## OAuth クライアントの公開

OAuth クライアントは、それを作成したテナントに最初にバインドされます。ただし、同じリージョン内の複数のテナントで OAuth クライアントを共有するように構成できます。この構成により、サードパーティのアプリケーションは、異なる Qlik Cloud テナント間で同じクライアント ID を使用できるようになります。

アプリケーションの所有者は、テナント管理者の介入なしに、シークレットをローテーションして構成を更新できます。テナント管理者は、資格情報を管理したり、公開されたクライアントの構成の詳細を認識したりする必要はありません。

他のテナントが OAuth クライアントに接続できるようにするには、公開する必要があります。

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。
2. 公開する OAuth クライアントを見つけます。
3. クライアントの横にある the 詳細 icon をクリックし、 [公開] を選択します。
4. [公開] をクリックして確定します。

OAuth クライアントが公開されると、他のテナントが外部で使用できるようになります。ユーザーがこの OAuth クライアントを使用する外部ウェブ サイトにアクセスすると、アクティブな SaaS セッションがすでにない限り、テナント ホスト名とユーザー資格情報を入力するよう求められます。

初回のログインにはテナント管理者の同意が必要です。承認されると、OAuth クライアントがテナントの 管理 アクティビティ センターに表示されます。

## 同意方法

既定では、Qlik Cloud は認証時にユーザーに同意を求めます。特に信頼できるアプリケーションの場合、プロセスを効率化するために同意方法を「信頼済み」に設定して、同意のプロンプトをスキップすることができます。

同意には、次の 2 つのオプションがあります。

* 必須: OAuth クライアントによって新しいスコープが要求されるたびに、ユーザーに同意を求められます。この方法によって、各アクセス レベルに対する明示的なユーザー承認が保証されます。

* 信頼済み: ユーザーに同意を求めるプロンプトは表示されません。このオプションは、未公開のクライアントに対してのみ使用できます。公開済みのクライアントの場合、複数のテナント間でセキュリティを維持するために、同意方法は常に [必須] となります。

情報メモマシンツーマシン (M2M) として使用されるクライアントの場合、クライアントの作成後、同意方法を [信頼済み] に変更する必要があります。OAuth クライアント ID メタデータ ドキュメント (CIMD) 接続では、公開ステータスに関係なく、常に [必須] の同意が使用され、 [信頼済み] に変更することはできません。

### 同意方法の変更

OAuth クライアントの同意方法を変更するには、次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。
2. OAuth クライアントで the 詳細 icon をクリックし、 [同意方法の変更] を選択します。
3. [必須] または [信頼済み] を選択し、 [同意方法の変更] をクリックします。

## OAuth 構成の表示とコピー

アクティビティセンターの OAuth管理 セクションで、 [OAuth 構成を確認する] を選択し、Qlik Cloud テナントの認証の詳細を表示します。この操作により、OAuth エンドポイントと設定を含むコード スニペットと、外部アプリケーションで使用するためにコピーできる URL が表示されます。

この設定を使用して、Qlik Cloud をサードパーティのアプリケーションと統合したり、API アクセスを自動化したり、組み込み分析の認証を構成したりできます。

## クライアント シークレットの管理

クライアント シークレットが侵害された場合、またはセキュリティ ポリシーで定期的な更新が必要な場合は、シークレットを追加または削除できます。ダウンタイムを回避するには、複数のクライアント シークレット (最大 5 個) を追加し、クライアント アプリケーションを更新してから、古いシークレットを削除します。

### クライアント シークレットの追加

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。

2. OAuth クライアントを見つけます。

3. [the 詳細 icon] をクリックし、 [シークレットの管理] を選択します。

4. [新しいクライアント シークレットを生成する] をクリックします。

5. クライアント シークレットとクライアント ID をコピーし、安全に保管します。

   情報メモクライアント シークレットは後で再表示できません。

6. [閉じる] をクリックします。

### クライアント シークレットの削除

次の手順を実行します。

1. 管理 アクティビティ センターで、 [OAuth] に移動します。
2. OAuth クライアントを見つけます。
3. [the 詳細 icon] をクリックし、 [シークレットの管理] を選択します。
4. クライアント シークレットの横にある the 削除 icon をクリックします。
5. [閉じる] をクリックします。

## OAuth クライアントの詳細

### 次のステップ: OAuth クライアント アプリケーションの構築

Qlik Cloud に OAuth クライアントを登録すると、Qlik Cloud コンテンツにアクセスする OAuth クライアント アプリケーションを構築できます。関連付けられたクライアント ID とクライアント シークレットをアプリケーションで使用します。

詳細な手順については、[開発者ポータルの「](https://qlik.dev/authenticate/oauth/)OAuth の概要Qlik」セクションにあるチュートリアルを参照してください。これらのチュートリアルでは、一般的なプログラミング言語を使用してクライアント アプリケーションを構築する方法について説明しています。

### 組織レベルの OAuth クライアント

テナント固有の OAuth クライアントに加えて、組織レベルの OAuth クライアントを使用できます。サービス アカウント所有者 (SAO) として、これらのクライアントを作成および管理できます。組織レベルの OAuth クライアントは、サブスクリプション内のすべてのテナントにわたるテナント情報へのアクセスを提供します。

詳細は、[My Qlik での OAuth クライアントの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/create-oauth-client-for-organization.htm)をご覧ください。