拡張機能とは、Looker 拡張フレームワークを通じて開発された Looker コンポーネントで構築されたウェブ アプリケーションです。これらの拡張機能は、Looker インスタンスの権限構造を継承し、モデルセット レベルで権限を処理します。ユーザーが標準の Looker アプリケーションで特定のモデルにアクセスする権限を持たない場合は、Looker 拡張機能でこれらのモデルにアクセスできません。このページでは、Looker 管理者がユーザーに Looker 拡張機能にアクセスするための適切な権限を付与する方法について説明します。
Looker Marketplace では、新しいプロジェクトを Looker アプリケーションにインポートして拡張機能をデプロイします。このプロジェクトには拡張機能の実行に必要なすべての要素が含まれており、少なくとも 1 つの モデルファイルがあります。Looker 管理者は、拡張機能のモデルにアクセスする権限を持つロールをユーザーに割り当てることで、そのモデルに基づいてユーザーがコンテンツを表示または操作する方法を制御できます。
たとえば、Looker インスタンスに finance
、marketing
、sales
というモデルに基づくデータがあり、特定のユーザーだけが財務データにアクセスできるようにする場合は、finance
モデルのみへのアクセス権をユーザーに付与します。拡張機能の権限も同じように機能します。
Looker 管理者は、拡張機能のモデルへのアクセス(したがって、拡張機能自体へのアクセス)権限や、拡張機能内のコンテンツの基になるモデルへのアクセスの権限を管理できます。
Looker 管理者は、[管理] パネルの [ロール] ページに移動して、Looker インスタンスで使用可能なモデルセットを構成できます。拡張機能にアクセスして使用するには、manage models
権限、またはすべてのモデルまたは拡張機能のモデルを含むモデルセットに対する explore
または develop
権限のいずれかを含むロールがユーザーに割り当てられている必要があります。
ユーザーに拡張機能の権限を付与する
Looker の拡張機能は Looker 拡張フレームワークを通じて開発され、Looker Marketplace から入手できます。拡張機能を使用するには、拡張フレームワークと Marketplace 機能を有効にする必要があります。
これらの拡張機能に加えて、拡張機能に関連付けられた 3 種類の権限があります。
拡張機能を開発する権限
Looker 拡張フレームワークを使用して拡張機能を開発するには、ユーザーに LookML デベロッパーの権限が必要です。また、Looker 拡張フレームワークの概要のドキュメント ページで推奨されるスキルも必要です。
Looker Marketplace から拡張機能をインストールする権限
各拡張機能には、少なくとも 1 つの専用の LookML モデルを持つプロジェクトがあります。たとえば、Data 辞書の拡張機能では data-dictionary
モデルを使用します。
Looker Marketplace から拡張機能をインストールするには、拡張機能のモデルに対する develop
、manage_models
、deploy
権限が必要です。
Looker Marketplace のアクセスキーを必要とする拡張機能をインストールする際に、構成画面では、Looker インスタンスのユーザー属性として保存されるアクセスキー値の入力を求められます。
拡張機能を使用する権限
拡張機能が Looker Marketplace からインストールされるか、Looker インスタンス内から利用できるようにする場合は、Looker 管理者がユーザー権限を構成する必要があります。
ほとんどの拡張機能のユースケースでは、常にユーザーのログイン時に付与された権限を使用して実行されます。デフォルトでは、拡張機能のインストール後に、explore
または develop
の権限を持つロールと、[All] に設定された [モデルセット] のアクセス権があるユーザーは、自動的に拡張機能とそのコンテンツの表示と使用ができるようになります。追加のアクセス権の構成は不要です。拡張機能が正常に動作するには、拡張機能で使用するすべてのモデルにアクセスできる必要があります。
Looker は、Looker メインメニューの [Applications] セクションに拡張機能を表示します。
Looker では、拡張機能の基盤となるモデルの少なくとも 1 つにアクセスできる Looker ユーザーに対してのみ拡張機能が表示されます。
埋め込まれた拡張機能の場合、拡張機能は、埋め込まれた Look、ダッシュボード、Explore と同様に、作成された埋め込みユーザー ID に付与された権限を持ちます。
拡張機能の URL で /spartan
オプションを使用する全画面表示の拡張機能の場合、ユーザーを拡張機能のみのユーザー グループに追加できます。このグループのユーザーは、拡張機能外の Looker ページを表示できません。Looker 管理者は、拡張機能のみのグループを他のグループと同様にカスタマイズし、特定の権限とモデルセットのアクセス権を持つロールを割り当てることができます。全画面表示の拡張機能を表示するために、ユーザーは拡張機能のみのグループに属している必要はありません。ユーザーがこのユーザー グループに属していない場合、拡張機能はログインしているユーザーの権限で実行されます。
ユーザー権限を追加する
Looker 管理者は、ユーザーと埋め込みユーザーに、access_data
とその拡張機能に関連付けられた、より制限された権限を含む権限セットを付与する必要があります。これらの権限は、拡張機能のモデルを含むモデルセットに適用する必要があります。
ユーザーが拡張機能にアクセスできるようにするには、Looker 管理者が次のことを行う必要があります。
- 拡張機能のモデルを含むモデルセットを作成するか、既存のモデルセットを編集して拡張機能のモデルを追加します。
- ユーザーに、このモデルセットの少なくとも
access_data
権限(およびその拡張機能に関連付けられている、より制限された権限)を持つロールが割り当てられていることを確認します。
例: データ ディクショナリの拡張機能
データ ディクショナリ拡張機能プロジェクトは data-dictionary
モデルを使用します。
ロールに explore
またはdevelop
権限が含まれないか、モデルセットのアクセス権が [すべて] に設定されていないユーザーは、data-dictionary
モデルを含むモデルセットに対する explore
または develop
の権限の付与を Looker 管理者に依頼する必要があります。
たとえば、財務チームにデータ ディクショナリ拡張機能へのアクセス権を付与するとします。財務チームには Finance Team
モデルセットが割り当てられますが、現在 data-dictionary
モデルへのアクセス権は付与されません。
data-dictionary
モデルをモデルセットに追加するには、Finance Team
モデルセットの横にある [編集] ボタンを選択し、data-dictionary
モデルのチェックボックスをオンにします。
[設定を更新する] を選択して、選択内容を保存します。
data-dictionary
モデルを Finance Team
モデルセットに追加したら、財務チームのロールが explore
または develop
権限を含む権限セットを使用していることを確認します。この例では、財務チームのロール(Finance Department)に Developer
権限セットと Finance Team
モデルセットが含まれています。
Developer
権限セットには、explore
権限と develop
権限の両方が含まれています。
これで、Finance Department のロールに割り当てられたユーザーは、適切な権限と適切なモデルアクセス権を持つようになるため、データ ディクショナリ拡張機能にアクセスできます。