Google Cloud Search のアクセス制御は、ユーザーの Google アカウントに基づいて行われます。 コンテンツをインデックス登録する際は、アイテムのすべての ACL が、有効な Google ユーザーまたは グループ ID(メールアドレス)。
多くの場合、リポジトリは Google アカウントを直接把握しません。代わりに、ユーザーはローカル アカウントで表されるか、ユーザーのメールアドレス以外の ID プロバイダと ID による連携ログインを使用して、各アカウントを識別できます。この ID は外部 ID と呼ばれます。
管理コンソールを使用して作成された ID ソースは、以下の方法で ID システム間のこのギャップを埋めるのに役立ちます。
- カスタム ID 項目を定義して外部 ID を格納します。この項目は、外部 ID を Google アカウントに解決するために使用されます。
- セキュリティ グループの名前空間を定義する リポジトリによって管理されるか、 ID プロバイダ。
以下のいずれかの場合に ID ソースを使用します。
- リポジトリに、プロジェクトのメインのメールアドレスが Google Workspace または Google Cloud Directory のユーザーを対象にします。
- リポジトリでは、アクセス制御用のグループが互いに対応していない メールベースのグループに拡張します。
ID ソースを使用すると、ID マッピングからインデックス登録が分離されるため、インデックス登録の効率が向上します。この分離により、ACL の作成時およびアイテムのインデックス登録時にユーザーの検索を延期できます。
デプロイの例
図 1 は、オンプレミスとクラウドの両方のリポジトリが企業で使用されているデプロイの例を示しています。各リポジトリでは、異なるタイプの外部 ID を使用してユーザーを参照します。
リポジトリ 1 は、 SAML。なぜなら、 リポジトリ 1 には、組織内のユーザーのメインのメールアドレスが Google Workspace または Cloud Directory を使用する場合は、ID ソースは必要ありません。
リポジトリ 2 はオンプレミス ディレクトリと直接統合され、
sAMAccountName
属性でユーザーを識別します。リポジトリ 2 は
sAMAccountName
属性を外部 ID として使用する場合、ID ソースは
必要ありません。
ID ソースを作成する
ID ソースが必要な場合は、Cloud Search でユーザー ID をマッピングするをご覧ください。
ACL とインデック スデータを作成するには ID ソースの ID が必要になるため、コンテンツ コネクタを作成する前に ID ソースを作成する必要があります。前述のように、ID ソースを作成すると、Cloud Directory にカスタム ユーザー プロパティも作成されます。このプロパティを使用して、リポジトリ内の各ユーザーの外部 ID を記録します。プロパティの名前は
IDENTITY_SOURCE_ID_identity
を使用します。
以下の表は、2 つの ID ソースを示しています。1 つは外部 ID として SAM アカウント名(sAMAccountName)を保持する ID ソース、もう 1 つは外部 ID としてユーザー ID(uid)を保持する ID ソースです。
ID ソース | ユーザー プロパティ | 外部 ID |
---|---|---|
id1 | id1_identity | sAMAccountName |
id2 | id2_identity | uid |
企業内のユーザーを参照するために使用される可能性のある外部 ID ごとに、ID ソースを作成します。
以下の表は、Google アカウントと 2 つの外部 ID(id1_identity と id2_identity)を持つユーザーとその値が Cloud Directory にどのように表示されるかを示しています。
ユーザー | メール | id1_identity | id2_identity |
---|---|---|---|
Ann | ann@example.com | example\ann | 1001 |
インデックス登録用に ACL を作成するときに、3 つの異なる ID(Google メール、sAMAccountName、uid)を使用して同じユーザーを参照できます。
ユーザー ACL を作成する
こちらの getUserPrincpal() メソッドまたは getGroupPrincipal() メソッドを使用して、指定された外部 ID を使用してプリンシパルを作成します。
以下の例は、ファイル権限を取得する方法を示しています。これらの権限には、ファイルにアクセスできる各ユーザーの名前が含まれます。
次のコード スニペットは、オーナーであるプリンシパルを作成する方法を示しています。
属性に格納されている外部 ID(externalUserName
)を使用します。
最後に、以下のコード スニペットは、ファイルの閲覧者であるプリンシパルを作成する方法を示しています。
閲覧者とオーナーのリストを取得したら、ACL を作成できます。
基盤となる REST API では、
identitysources/IDENTITY_SOURCE_ID/users/EXTERNAL_ID
ID 用に新しい ID を作成します。前の表に戻ると
Ann の id1_identity
(SAMAccountName)を使用して ACL を作成すると、ID は次のようになります。
次のように解決されます。
identitysources/id1_identity/users/example/ann
この ID 全体は、外部 ID と Cloud Directory に保存されている Google ID の橋渡しをするので、ユーザーの中間 ID と呼ばれます。
リポジトリに使用される ACL のモデル化の詳細については、ACL をご覧ください。
グループのマッピング
ID ソースは、ACL で使用されるグループの名前空間としても機能します。この名前空間機能を使用して、セキュリティ目的でのみ使用されるグループまたはリポジトリに対してローカルなグループを作成およびマッピングできます。
Cloud Identity Groups API を使用してグループを作成し、メンバーシップを管理します。グループを ID ソースに関連付けるには、ID ソースのリソース名をグループ名前空間として使用します。
次のコード スニペットは、Cloud Identity Groups API を使用してグループを作成する方法を示しています。
グループ ACL を作成する
グループ ACL を作成するには、 getGroupPrincipal() メソッドを使用して、指定された外部 ID を使用してグループ プリンシパルを作成します。次に、 ACL を使用します。 Acl.Builder クラスを次のように変更します。
ID コネクタ
Google 以外の外部 ID で ACL を作成してアイテムをインデックス登録することはできますが、ユーザーの外部 ID が Cloud Directory の Google ID に解決されるまで、ユーザーは検索でアイテムを表示できません。Cloud Directory がユーザーの Google ID と外部 ID の両方を認識できるようにするには、以下の 3 つの方法があります。
- 管理コンソールから個々のユーザー プロファイルを手動で更新します。この方法は、いくつかのユーザー プロファイルを使用したテストとプロトタイピングでのみ使用することをおすすめします。
- Directory API を使用して外部 ID を Google ID にマッピングします。この方法は、Identity Connector SDK を使用できない方におすすめします。
- ID コネクタを作成する 使用 Identity Connector SDK。 この SDK では、Directory API を使用して ID をマッピングする作業が簡単になります。
ID コネクタは、外部 ID を企業の ID(ユーザーとグループ)から Google Cloud Search で使用される内部 Google ID にマッピングするためのプログラムです。ID ソースを作成する必要がある場合は、ID コネクタを作成する必要があります。
Google Cloud Directory Sync(GCDS)は ID コネクタの一例です。この ID コネクタは、他のシステムで ID を表すユーザー属性とともに、Microsoft の Active Directory のユーザーとグループの情報を Cloud Directory にマッピングします。
REST API を使用して ID を同期する
REST API で ID を同期するには、update
メソッドを使用します。
ID の割り当て変更
アイテムの ID を別の ID に再マッピングした後、アイテムのインデックスを再作成する必要があります 保持します。次に例を示します。
- ユーザーからマッピングを削除したり、別のユーザーに再マッピングしたりしようとすると、 元のマッピングはインデックスを再作成するまで保持されます。
- アイテムの ACL に存在するマッピングされたグループを削除してから、
同じ
groupKey
を持つ新しいグループでは、新しいグループではアクセスが インデックスに再登録するまで表示されません。