トークンのデータソース

トークンには、パーソナルアクセストークン (PAT)、リフレッシュトークン、OAuth トークンなど、サイト上のアクティブで期限切れになっていないユーザートークンに関する情報が含まれています。サイト管理者は、データソースを通じてトークンの使用状況と有効期限を監視し、必要に応じて必須のトークンをローテーションできます。

データソースには次のトークンが含まれています。

OAuth データベース - OAuth 接続に使用されるアクセストークンを管理します。トークンは、Tableau Cloud ユーザーが削除するか、データプロバイダーが取り消すまで有効です。詳細については、OAuth 接続を参照してください。
OAuth クライアント - Tableau Desktop や Tableau Prep などの接続されたクライアントが使用するリフレッシュトークンを管理します。詳細については、接続されているクライアントからサイトにアクセスを参照してください。
パーソナルアクセストークン (PAT) - Tableau REST API で作成された自動スクリプトやタスクなど、Tableau Cloud へのサインインに使用される長期認証トークンを管理します。詳細については、個人用アクセストークンを参照してください。

サイト管理者はいつでも、不要なトークンを持つユーザーのライセンスを解除することで、トークンをすぐに取り消すことができます。ただし、ユーザーがライセンスをもう一度取得するには、新しいトークンを作成する必要があります。特定の種類のトークンを削除または取り消す手順については、前のセクションのリンクに従ってください。

カスタムビューを作成する

サイト管理者または管理者インサイトプロジェクトへのアクセス権を付与されているユーザーは、Web 作成を使用して、または Tableau Desktop 経由で Tableau Cloud から管理者インサイトのデータソースに直接アクセスして、カスタムビューを作成することができます。管理者インサイトのデータソースへの接続の詳細については、管理者インサイトを使用したカスタムビューの作成を参照してください。

例: OAuth データベーストークンが最後に更新されたのはいつか?

次のステップに従って、OAuth データベーストークンが最後に更新された日時と組織内のトークンローテーションのコンプライアンスを測定するビューを作成します。

トークンのデータソースに接続します。
[データ] ペインから [トークンタイプ] を [フィルター] シェルフにドラッグします。[OAuth データベース] チェックボックスを選択し、[OK] をクリックします。
[データベースタイプ]、[データベースユーザー名]、[最終更新日] を [行] シェルフにドラッグします。
[行] シェルフで [最終更新日] を右クリックし、コンテキストメニューから [正確な日付] を選択します。フィールドを連続フィールドから不連続フィールドに変更します。
メニューから [分析]、[計算フィールドの作成] の順にクリックします。
1. 名前: 最終更新日からの日数
2. 計算:
```
ROUND(TODAY()-[Last Updated])
```
[OK] をクリックします。
[データ] ペインから、[最終更新日からの日数] を [行] シェルフにドラッグします。フィールドを連続フィールドから不連続フィールドに変更します。

例: 埋め込み OAuth データベーストークンの有効期限はいつ切れるか?

ビューの読み込みエラーや抽出更新の失敗などのトラブルを防止するには、埋め込み OAuth データベーストークンの有効期限を監視することが重要です。次のステップに従って、有効期限が近づいているトークンを特定し、ユーザーが認証資格情報を前もって更新できるようにします。

注: Tableau は、OAuth データベーストークンの有効期限を保存しません。この情報を入手するには、データベース管理者に問い合わせて、各データベースタイプの有効期限の詳細を確認してください。

トークンのデータソースに接続します。
[データ] ペインから [トークンタイプ] を [フィルター] シェルフにドラッグします。[OAuth データベース] チェックボックスを選択し、[OK] をクリックします。
[データベースのタイプ]と[所有者のメール] を [行] シェルフにドラッグします。
メニューから [分析]、[計算フィールドの作成] の順にクリックします。この例では、有効期限が 90 日後の Snowflake データベースを使用します。
1. 名前: Expires At (all tokens)
2. 計算:
```
IF [Token Type] = 'OAuth Database'
THEN
IF [Database Type] = 'snowflake'
THEN DATEADD('day', 90, [Last Updated])
// add conditions for other database types here //
ELSE NULL
END
ELSE [Expires At]
END
```
メニューから [分析]、[計算フィールドの作成] の順にクリックします。
1. 名前: Days Until Expiration
2. 計算:
```
DATEDIFF('day', TODAY(), [Expires At (all tokens)])
```
[有効期限までの日数] を [行] シェルフにドラッグします。フィールドを連続フィールドから不連続フィールドに変更します。
[有効期限までの日数] を [フィルター] シェルフにドラッグします。[すべての値] を選択し、最大値を 14 に設定します。これにより、14 日後に期限切れになるトークン、またはすでに期限切れになっているトークンがフィルターされます。必要に応じて調整します。
結果の値を使用して、トークンの有効期限が近づいているユーザーに連絡します。

例: サイト上で PAT を所有しているのはどのユーザーか?

次の例では、サイト上で PAT を所有しているユーザーの名前とサイトロールが表示されます。フィルターを調整すると、その他のトークンタイプを表示できます。

トークンと TS ユーザーのデータソースに接続します。
[データ]、[ブレンド関係の編集] の順に選択します。
[ブレンド関係] ダイアログで、プライマリデータソースを [トークン] に設定し、[カスタム] ラジオボタンを選択します。
[追加] をクリックします。
[フィールドマッピングの追加または編集] ダイアログで、[所有者のメール] を [ユーザーのメール] にマッピングし、[OK]、OK の順にクリックします。
[データ] ペインから [トークンタイプ] を [フィルター] シェルフにドラッグします。[PAT] チェックボックスを選択し、[OK] をクリックします。
[データ] ペインから [ユーザー名]、[ユーザーサイトロール]、[有効期限]、[最終使用日] を [行] シェルフにドラッグします。
[データ] ペインのリンクフィールドが [ユーザーのメール] であることを確認します。壊れたリンクがある場合は、フィールド名の横にあるアイコンをクリックして、2 つのデータソースをリンクします。
[行] シェルフで [有効期限] を右クリックし、コンテキストメニューから [正確な日付] を選択します。フィールドを連続フィールドから不連続フィールドに変更します。
[最終使用日] に対して手順 7 を繰り返します。

データをさらに活用する

Tableau Prep を使用すると、次のフィールドでトークンを他の管理者インサイトデータソースと結合して、サイトの可視性を高めることができます。複数の Tableau Cloud サイトからデータを分析している場合は、「サイト LUID = サイト LUID」でも結合する必要があります。

トークン所有者のサイトロールを確認するには、「所有者のメール」=「ユーザーのメール」でトークンを TS ユーザーに結合します。
トークン所有者のグループメンバーシップを確認するには、「所有者のメール」=「ユーザーのメール」でトークンをグループに結合します。

詳細については、Tableau Prep ヘルプの「データの集計、結合、ユニオン(新しいウィンドウでリンクが開く)」を参照してください。

データスキーマ

次の表には、トークンのデータソースに含まれるフィールドがリストされています。データの各行は、トークン ID と所有者のメールの組み合わせに対応します。

フォルダー	フィールド名	タイプ	説明
Database	Asset Key ID	数値	データベースエントリの ID。OAuth データベーストークンに適用されます。
	Database Type	文字列	データベースのタイプ (Salesforce や Snowflake など)。OAuth データベーストークンに適用されます。
	Database User Name	文字列	データベースに接続しているユーザーの名前。OAuth データベーストークンに適用されます。
	Instance URL	文字列	データプロバイダーのインスタンス URL (例: https://login.salesforce.com)。OAuth データベーストークンに適用されます。
	Last Updated	日付/時刻	データソース認証資格情報が最後に変更された日時 (UTC)。OAuth データベーストークンに適用されます。
Devices	Device ID	文字列	トークンに関連付けられている接続済みクライアントの ID。OAuth クライアントトークンに適用されます。
Devices	Device Name	文字列	トークンに関連付けられている接続済みクライアントの名前。OAuth クライアントトークンに適用されます。
Site	Site LUID	文字列	Tableau Cloud サイトの LUID。主に REST API を介してコンテンツを参照するために使用されます。
Site	Site Name	文字列	Tableau Cloud サイトの名前。
Token	Expires At	日付/時刻	トークンの有効期限が切れる日時 (UTC)。PAT と OAuth クライアントトークンに適用されます。
	GUID	文字列	トークンの一意の ID。PAT と OAuth クライアントトークンに適用されます。
	Issued At	日付/時刻	トークンが発行された日時 (UTC)。
	Last Used At	日付/時刻	トークンが最後に使用された日時 (UTC)。PAT と OAuth クライアントトークンに適用されます。
	Owner Email	文字列	トークン所有者のメールアドレス。
	PAT Name	文字列	個人アクセストークンの名前。PAT に適用されます。
	Token Identifier	文字列	PAT および OAuth クライアントトークンの GUID と OAuth データベーストークンのアセットキー ID を使用して、データ行を一意に識別します。
	Token Type	文字列	トークンタイプの列挙値。個人用アクセストークン (PAT)、OAuth クライアント、OAuth データベースのいずれか。
-	Admin Insights Published At	日付/時刻	管理者インサイトのデータソースが最後にパブリッシュされた日時 (UTC)。

一番上に戻る

フィードバックをお送りいただき、ありがとうございます。

フィードバックは正常に送信されました。ありがとうございます!

Tableau Cloud ヘルプ