--- schema_version: "1" id: 27b008b888fb4f2db786afcec95f8d5400a27dba6e3d3a25e708499cd457c743 title: 接続済みアプリのアクセス スコープ collection: tableau version: next locale: ja-jp portal_url: https://docs.salesforce.com/tableau/next/ja-jp/server/connected_apps_scopes.md canonical_url: https://help.tableau.com/v0.0/server/ja-jp/connected_apps_scopes.htm source_site: help.tableau.com content_type: documentation content_hash: b99b9047fc71502a3aa2a1fa03a60ebc96d187a5d4a35c288cbe364d0f109bba description: Reference of access scopes that authorize REST API methods for connected apps via JWT. --- [メイン コンテンツに進む](#main-content) # 接続済みアプリのアクセス スコープ Tableau Server バージョン 2022.3 以降、Tableau 接続済みアプリを使用すると、Tableau Server ユーザーの代わりに、カスタム アプリケーションを通じて Tableau REST API をプログラムで呼び出して利用できるようになりました。最初にサインインを要求するときに定義される JSON Web トークン (JWT) を使用することにより、REST API へのアクセスが可能になります。JWT 内のスコープには、カスタムアプリケーションとそのユーザーが接続済みアプリを通じて利用できる REST API メソッドが定義されている必要があります。 REST API へのアクセスを接続済みアプリを使用して承認することにより、次を実現します。 - セキュリティの強化 — コンテナ内で .env ファイルを介して管理者ユーザーのパスワードを保存および管理するよりも、JWT をベアラー トークンとして使用する方が本質的に安全です - 効率の向上 — JWT をベアラー トークンとして使用すると、2 つのリクエストではなく、サインイン エンドポイントへの 1 つのリクエストで偽装を簡単化することができます - 動的なコンテンツ検索や高度なフィルタリングなど、複雑な Tableau 統合とバックエンド クエリを拡張および自動化します ## スコープ アクション 接続済みアプリが使用するスコープは、[JWT 認可をサポートする REST API メソッド](#scopes) (下記) を通じて、コンテンツや管理アクションへのアクセス権を付与します。スコープはコロンで区切られた文字列であり、名前空間 `tableau` で始まり、アクセスが許可されている Tableau リソース (`datasources` など) が続き、そのリソースに対して許可されているアクション (`update` など) で終わります。 スコープが実行できるアクションは次のとおりです。 - `create` - `read` - `run` - `update` - `download` - `delete` たとえば、カスタム アプリケーションが [データ ソースの更新](https://help.tableau.com/current/api/rest_api/ja-jp/REST/rest_api_ref_data_sources.htm#update_data_source)メソッドを呼び出せるようにするスコープは、`tableau:datasources:update` のようになります。 ## スコープの種類 使用するスコープの種類は、有効にするコンテンツまたは管理アクションによって異なります。スコープは通常、コンテンツ読み取り、個別、ワイルドカード、クロスカテゴリのいずれかのタイプに分類されます。 - **コンテンツ読み取りスコープ:** コンテンツ読み取りスコープ `tableau:content:read` は、Tableau コンテンツに対してサポートされている GET メソッドを有効にします。このスコープを使用すると、REST API カテゴリ全体でアクションを有効にできます。具体的には、このスコープを使用して、データ ソース、メトリクス、ビュー、ワークブック、プロジェクト、およびサイトに対する GET メソッドを有効にします。 Tableau Server 2023.3 以降は、[メタデータ API](https://help.tableau.com/current/api/metadata_api/ja-jp/docs/meta_api_auth.html) で使用する認証資格情報トークンの作成に使用される JWT でこのスコープも指定します。 Tableau Server 2025.1 以降は、[VizQL データ サービス](https://help.tableau.com/current/api/vizql-data-service/ja-jp/index.html)で使用する認証資格情報トークンの作成に使用される JWT でもこのスコープを指定します。 **注:** ユーザーやグループなどの管理アクションに対する GET メソッドを有効にするには、それらの個別スコープを使用できます。 - **個別スコープ:** サポートされているコンテンツと管理アクションを有効にするには、それらの個別スコープを使用できます。個別スコープは、通常、単一のメソッドと REST API カテゴリに関連付けられています。 例: - データ ソース アクションのパブリッシュまたは更新を有効にする場合は、それぞれ個別スコープ `tableau:datasources:create` または `tableau:datasources:update` を使用できます。 - ユーザーの追加または削除などの管理アクションについては、それぞれ個別スコープ `tableau:users:create` または `tableau:users:delete` を使用できます。 **注:** REST API のカテゴリをまたがるアクションを有効にできる個別スコープもいくつかあります。例えば、`tableau:views:download` は、データの表示やワークブックの REST API カテゴリでアクションを有効にします。 - **[ワイルドカード (\*) スコープ:](#wildcard)** 特定のスコープでは、アクションをワイルドカード文字 (\*) に置き換えて、特定の REST API カテゴリ内でサポートされているアクションを有効にすることができます。 例: - ワイルドカード スコープ `tableau:projects:*` を使用すると、プロジェクトの REST API カテゴリで create、delete、および update アクションを有効にできます。 - ワイルドカード スコープ `tableau:users:*` を使用すると、ユーザーの REST API カテゴリで get/list、add、delete、および update アクションを有効にできます。 - ワイルドカード スコープ `tableau:tasks:*` を使用すると、抽出とサブスクプションの REST API カテゴリで get/list、add、delete、update、および run アクションを有効にできます。また、このスコープは、データ ソースの更新 (抽出の場合) とワークブックの更新を有効にします。 - **[クロスカテゴリ スコープ:](#cross)** コンテンツ読み取りスコープに加えて、使用された場合、さまざまな REST API カテゴリにまたがってサポートされているアクションを有効にする追加スコープがいくつかあります。 例: - `tableau:tasks:run` スコープを使用すると、データ ソースとワークブックの REST API カテゴリでアクションを有効にします。 - 繰り返しになりますが、`tableau:views:download` スコープを使用すると、データの表示とワークブックの REST API カテゴリでアクションを有効にします。 - `tableau:permissions:update` または `tableau:permissions:delete` などのパブリッシュ スコープを使用すると、データ ソース、ワークブック、およびプロジェクトの REST API カテゴリでアクションを有効にします。 ## REST API アクセスを認可する方法の概要 次のリストは、JWT を介して REST API へのアクセスをリクエストする手順をまとめたものです。 1. 次のいずれかの方法を使用して**、接続済みアプリを作成**します。 - [直接的な信頼関係を使用して接続済みアプリを設定する](https://help.tableau.com/v0.0/server/ja-jp/connected_apps_direct.htm) - [OAuth 2.0 信頼を使用して接続済みアプリを設定する](https://help.tableau.com/v0.0/server/ja-jp/connected_apps_eas.htm) 2. **有効な JWT を生成します。**カスタム アプリケーションは、指定したスコープで設定された有効な JWT を実行時に生成します 3. **[サインイン](https://help.tableau.com/current/api/rest_api/ja-jp/REST/rest_api_ref_authentication.htm#sign_in) リクエストを行います。**カスタム アプリケーションは、JWT を使用してサインインをリクエストし、Tableau 認証資格情報トークンとサイトID (LUID) を返します。 4. **後続のリクエストで Tableau アクセス トークンを使用します。**後続の REST API 呼び出しでは、1) Tableau 認証資格情報トークンを [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#using_auth_token) ヘッダー値として使用し、2) サイト ID (LUID) をリクエスト URI で使用します。 ### 例 たとえば、直接的な信頼関係を使用して接続済みアプリを作成するとします。直接的な信頼関係を使用して REST API を呼び出すカスタム アプリケーションは、接続済みアプリが生成したクライアント ID とクライアント シークレットを使用して有効な JWT を生成します。 **JWT のスコープ** REST API へのアクセスを正常に認可するには、JWT に REST API 機能を定義するスコープが含まれている必要もあります。たとえば、データ ソース関連のさまざまなメソッドを有効にするには、JWT に次のようなスコープを含めることができます。 `"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"` または `"tableau:content:read","tableau:datasources:*","tableau:tasks:run"` **注:** スコープの値はリスト型として渡す必要があります。 **サインイン リクエストの URI** REST API を呼び出すには、カスタム アプリケーションは最初にサインイン要求を行い、Tableau 認証資格情報のトークンを生成する必要があります。 ``` POST https://myco/api/3.17/auth/signin ``` **リクエスト本文** JWT を使用して REST API へのアクセスを認可するには、サインイン リクエストの本文に次の例のような有効な JWT が含まれている必要があります。 ``` ``` **レスポンス本文** サインイン リクエストに対して、Tableau 認証資格情報トークンを含む、次のようなレスポンス本文が生成されます。 ``` ``` Tableau アクセス トークンが生成されたら、後続のすべての REST API リクエストのヘッダーに追加します。 **ヘッダー** X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd Tableau アクセス トークンを使用する後続のすべての REST API リクエストは、JWT のスコープによって制限されます。 ## JWT 認可をサポートする REST API メソッド 接続済みアプリのスコープは、ユーザーに代わって、カスタム アプリケーションに Tableau REST API 機能へのアクセス権を付与します ### スコープの見つけ方 JWT がサポートするメソッドに必要なスコープは、[Tableau REST API](https://help.tableau.com/current/api/rest_api/ja-jp/REST/rest_api.htm) ヘルプのプロパティ ブロックにあります。スコープがメソッドの properties ブロックにリストされていない場合、そのメソッドへのアクセスを JWT で制御することはできません。 たとえば、Tableau REST API で[サイトに対してクエリを実行する](https://help.tableau.com/current/api/rest_api/ja-jp/REST/rest_api_ref_site.htm#query_site)メソッドを呼び出せるようにするスコープは、`tableau:sites:read` のようになります。 **注:** - [サインイン](https://help.tableau.com/current/api/rest_api/ja-jp/REST/rest_api_ref_authentication.htm#sign_in)と[サインアウト](https://help.tableau.com/current/api/rest_api/ja-jp/REST/rest_api_ref_authentication.htm#sign_out)のメソッドは、共に JWT 認証でサポートされていますが、Tableau Server 2023.3.以降では、スコープを使用する必要はありません。 - 埋め込み API v3 でサポートされているスコープについては、次のいずれかを参照してください。 - [直接的な信頼関係を使用して接続済みアプリを設定する](https://help.tableau.com/v0.0/server/ja-jp/connected_apps_direct.htm) - [OAuth 2.0 信頼を使用して接続済みアプリを設定する](https://help.tableau.com/v0.0/server/ja-jp/connected_apps_eas.htm) - Tableau Server 2025.3 以降、リストされたスコープのサブセットは、統合アクセス トークン (UAT) を介した REST API 認証もサポートします。つまり、接続済みアプリと UAT スコープは同じです。 ### スコープのタイプ #### ワイルドカード (\*) スコープについて ワイルドカード スコープは、特定のアクションではなく、ワイルドカード文字 (\*) を使用して、特定の Tableau REST API カテゴリ内でサポートされている複数のアクションを有効にします。 #### 例
スコープ 有効にされるメソッド
tableau:datasources:* データ ソースの create、update、および update connection メソッドを有効にします。
tableau:metrics:* メトリクスの query、update、および delete アクションを有効にします。
tableau:workbooks:* ワークブックの publish、update、download、および preview image アクションを有効にします。
tableau:groups:* グループの create、query、update、および delete アクションを有効にします。
tableau:projects:* プロジェクトの create、delete、update メソッドを有効にします。
tableau:users:* ユーザーの get/list、add、delete、および update メソッドを有効にします。
tableau:tasks:*

注: このスコープもクロスカテゴリです。

 抽出タスクとサブスクリプション タスクの get/list、add、delete、update、および run メソッドを有効にします。

ワークブックのデータ ソースの update メソッドを有効にします。
#### クロスカテゴリ スコープについて クロスカテゴリ スコープは、複数の Tableau REST API カテゴリにまたがってサポートされている複数のアクションを有効にします。 #### 例
スコープ 有効にされるメソッド
tableau:content:read データ ソース、メトリクス、ビュー、ワークブック、プロジェクト、サイトなど、Tableau コンテンツの read/list メソッドを有効にします。
tableau:tasks:run データ ソース、ワークブック、抽出の run メソッドを有効にします。
tableau:views:download データの表示とワークブックの download メソッドを有効にします。
tableau:tasks:*

注: このスコープもワイルドカードです。

 抽出タスクとサブスクリプション タスクの get/list、add、delete、update、および run メソッドを有効にします。

ワークブックのデータ ソースの update メソッドを有効にします。
## トラブルシューティングのスコープ ### 401001 - サインイン エラー エラー 401001 が発生した場合、**サインイン**の応答本文には、追加の接続アプリ固有のエラー コード (16、10084、または 10085) のいずれかが追加されます。 たとえば、次の応答本文では、「10084」は接続アプリのエラー コードであり、REST API 認証に JWT を使用して Tableau Server にサインインする際に起こる問題のトラブルシューティングに役立ちます。 "summary": "Signin Error", "detail": "Error signing in to Tableau Cloud (10084)" 問題を解決するには、該当するエラー コードとその潜在的な原因の説明を参照してください。 - **16: Cloud でユーザーが見つかりません** - このエラーは、正しくない「`sub`」 (ユーザー名) が指定されると発生する可能性があります。 - **10084: Cloud でアクセス トークンを解析できませんでした** - このエラーは、次の理由で発生する可能性があります。 - JWT が無効であるか、予期しない問題が発生しました - 正しくない \[`aud`\] (オーディエンス) が指定されました - 直接的な信頼関係の場合、シークレットの署名に問題がありました - **10085: Cloud でクライアント ID の署名を検証するためのシークレットを取得できませんでした** - このエラーは、次の理由で発生する可能性があります。 - 指定された \[`iss`\] のクライアント ID が正しくありません - 直接的な信頼関係の場合、正しくない \[`kid`\] (シークレット ID) が指定されました - EAS で、JWKSource からキーを取得できませんでした ### 401002 - 不正アクセス エラー エラー 401002 が発生し、リクエストを行う適切なパーミッションがあることを確認した場合は、JWT に含まれるスコープが正しく、作成しようとしているリクエストと一致していることを確認してください。エンドポイントとサポートされるスコープのリストについては、上記の「[JWT 認可をサポートする REST API メソッド](#scopes)」セクションを参照してください。