すべてのサブジェクト(ユーザーまたはグループ)は、2 段階のプロセスを経てグローバル API サーバーにアクセスします。IAMRoleBinding を使用して、グローバル API サーバーの権限を事前定義された IAMRole に付与します。すべてのロールとロール バインディングはグローバルです。
このページは、組織内の権限を管理するプラットフォーム管理者グループのユーザーを対象としています。詳細については、GDC エアギャップ ドキュメントの対象読者をご覧ください。
始める前に
ロール バインディングを管理したり、アクセス権を取り消したりする前に、必要な権限をリクエストして環境を準備する必要があります。必要なロールは、ロール バインディングを管理するか、ユーザー アクセスを取り消すかによって異なります。
IAM ロールをリクエストする
実行する必要があるタスクに基づいてロールをリクエストするには、IAM 組織管理者に連絡してください。
- IAM 組織管理者(
organization-iam-admin): 組織レベルとプロジェクト レベルでロール バインディングを作成、更新、削除します。 - セッション組織管理者(
org-session-admin): 特定のゾーン内でユーザーのアクティビティ セッションとアクセスを取り消します。
環境を準備する
コマンドライン ツールを使用してロール バインディングを管理したり、アクセス権を取り消したりするには、次の設定を行います。
ロール バインディングを設定する
チームメンバーに組織レベルまたはプロジェクト レベルでリソースへのアクセス権を付与するロール バインディングを設定できます。
承認済みメンバーにロールを割り当てます。
コンソール
- GDC コンソールにログインします。
- スコープ選択ツールから組織またはプロジェクトを選択します。
- 組織のロール バインディングを設定するには、組織を選択します。
- プロジェクトのロール バインディングを設定するには、プロジェクトを選択します。
- ナビゲーション メニューで、[ID とアクセス] > [アクセス] をクリックします。
- [メンバーを追加] をクリックします。
- 個々のユーザーを追加するか、グループを追加するかを選択します。
- [ID プロバイダ] リストで、ID プロバイダを選択します。
- [ユーザー名またはグループ エイリアス] フィールドに、ユーザー名、メールアドレス、またはエイリアスを入力します。
- [ロール] リストで、ユーザーまたはグループに割り当てるロールを選択します。たとえば、組織レベルの組織閲覧者やプロジェクト レベルのプロジェクト作成者などです。
- [追加] をクリックします。
メンバーが [承認済みメンバー] リストに表示されます。
gdcloud
gdcloud CLI がインストールされていることを確認します。
gdcloud auth loginコマンドを使用してログインし、ID プロバイダで認証します。詳細については、gdcloud CLI 認証をご覧ください。ロール バインディングを設定します。
組織のロール バインディングを設定します。
gdcloud organizations add-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLE次の変数を置き換えます。
ORGANIZATION: ロール バインディングを設定する組織の名前。USER_ACCOUNT: ロールを付与するユーザー アカウント。このフラグには、ID プロバイダの接頭辞(user:idpprefix-user@example.com)が付いたユーザーのメールアドレス、またはサービス アカウント プロジェクト(serviceAccount:projectName:serviceAccountName)が付いたサービス アカウント名を指定できます。ROLE: ユーザーに割り当てる事前定義ロールまたはカスタムロールの名前。
プロジェクトのロール バインディングを設定します。
gdcloud projects add-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLE次の変数を置き換えます。
PROJECT: ロール バインディングを設定するプロジェクトの名前。USER_ACCOUNT: ロールを付与するユーザー アカウント。このフラグには、ID プロバイダの接頭辞(user:idpprefix-user@example.com)が付いたユーザーのメールアドレス、またはサービス アカウント プロジェクト(serviceAccount:projectName:serviceAccountName)が付いたサービス アカウント名を指定できます。ROLE: ユーザーに割り当てる事前定義ロールまたはカスタムロールの名前。
API
ロール バインディングの環境変数をエクスポートします。
export GLOBAL_API_SERVER_KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG export USERNAME=IDP_PREFIX-USERNAME export ROLE_NAME=ROLE_NAME export BINDING_NAMESPACE=BINDING_NAMESPACE export USER_EMAIL=IDP_PREFIX-USER_EMAIL次のように置き換えます。
GLOBAL_API_SERVER_KUBECONFIG: グローバル API サーバーの kubeconfig ファイルのパス。IDP_PREFIX: ID プロバイダの接頭辞。USERNAME: ユーザーのメールアドレスの@記号の前にあるユーザー名部分(paul@example.comのpaulなど)。ROLE_NAME: ユーザーに必要なロールの名前(project-creatorなど)。ロールとそのスコープの一覧については、ロールの定義をご覧ください。BINDING_NAMESPACE: 組織スコープのロールの場合はplatform、プロジェクト スコープのロールの場合はターゲット プロジェクトの名前空間の名前。USER_EMAIL: ロールを割り当てるユーザー アカウントのメールアドレス(paul@example.comなど)。
IAMRoleBindingカスタム リソースを作成して適用します。cat <<EOF | kubectl --kubeconfig ${GLOBAL_API_SERVER_KUBECONFIG} apply -f - apiVersion: iam.global.gdc.goog/v1 kind: IAMRoleBinding metadata: name: ${USERNAME}-${ROLE_NAME}-binding namespace: ${BINDING_NAMESPACE} spec: roleRef: apiGroup: iam.global.gdc.goog kind: IAMRole name: ${ROLE_NAME} subjects: - apiGroup: rbac.authorization.k8s.io kind: User name: ${USER_EMAIL} EOF
ロール バインディングを削除する
アクセスが不要になったら、メンバーと、関連付けられているロール、権限、アクセス権を削除します。
メンバーを削除する手順は次のとおりです。
コンソール
- GDC コンソールにログインします。
- ナビゲーション メニューで、[ID とアクセス] > [アクセス] をクリックします。
- [承認済みメンバー] リストで、メンバーを選択します。
- [メンバーを削除] をクリックします。
- 確認を求められたら、[メンバーを削除] をクリックして確定します。
gdcloud
gdcloud CLI がインストールされていることを確認します。
gdcloud auth loginコマンドを使用してログインし、ID プロバイダで認証します。詳細については、gdcloud CLI 認証をご覧ください。ロール バインディングを削除します。
組織のロール バインディングを削除します。
gdcloud organizations remove-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLE次の変数を置き換えます。
ORGANIZATION: ロール バインディングを削除する組織の名前。USER_ACCOUNT: ロールを削除するユーザー アカウント。このフラグには、ID プロバイダの接頭辞(user:idpprefix-user@example.com)が付いたユーザーのメールアドレス、またはサービス アカウント プロジェクト(serviceAccount:projectName:serviceAccountName)が付いたサービス アカウント名を指定できます。ROLE: ユーザー アカウントから削除する事前定義ロールまたはカスタムロールの名前。
プロジェクトのロール バインディングを削除します。
gdcloud projects remove-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLE次の変数を置き換えます。
PROJECT: ロール バインディングを削除するプロジェクトの名前。USER_ACCOUNT: ロールを削除するユーザー アカウント。このフラグには、ID プロバイダの接頭辞(user:idpprefix-user@example.com)が付いたユーザーのメールアドレス、またはサービス アカウント プロジェクト(serviceAccount:projectName:serviceAccountName)が付いたサービス アカウント名を指定できます。ROLE: ユーザー アカウントから削除する事前定義ロールまたはカスタムロールの名前。
kubectl
IAMRoleBinding を削除して、PA アカウントに付与された権限を取り消します。
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG \
delete iamrolebinding IDP_PREFIX-USERNAME-ROLE_NAME-binding -n BINDING_NAMESPACE
次のように置き換えます。
- GLOBAL_API_SERVER_KUBECONFIG: グローバル API サーバーの kubeconfig ファイルのパス。
- IDP_PREFIX: ID プロバイダの接頭辞。
- USERNAME: ユーザーのメールアドレスの
@記号の前のユーザー名部分(paul@example.comのpaulなど)。 - ROLE_NAME: 削除するロールの名前(
project-creatorなど)。 - BINDING_NAMESPACE: 組織スコープのロールの場合は
platformに置き換え、プロジェクト スコープのロールの場合はターゲット プロジェクトの名前空間の名前に置き換えます。
ユーザーのアクセス権を取り消す
メンバーが組織またはチームを離れた場合は、Google Distributed Cloud(GDC)エアギャップへのアクセス権を取り消すことができます。ユーザーのアクセス権を取り消すと、ユーザーは Distributed Cloud からログアウトされ、ロールと権限が削除されます。ユーザーのアクティビティとセッションを、開始時刻と終了時刻から一覧表示することもできます。
GDC ユニバース全体でユーザーのアクセス権を取り消すには、各ゾーンのアクセス権を個別に、各ゾーンで次の手順を完了します。
アクセス権を取り消すゾーンにログインしていることを確認します。たとえば、gdcloud CLI のゾーン URL 構成を設定してから、ログインします。
gdcloud config set organization_console_url ZONE_URL gdcloud auth loginZONE_URLは、ユーザー アクセスを取り消すゾーンの GDC コンソール URL に置き換えます。これはhttps://console.ORG_NAME.ZONE_NAME.ORG_SUFFIXのようになります。ゾーン コンテキストの切り替えの詳細については、ツールを使用してゾーンにアクセスするをご覧ください。
ゾーンに対するユーザーのアクセス権を取り消します。
gdcloud admin auth revoke --accounts USER_EMAILUSER_EMAIL は、アクセス権を取り消すユーザーのメールアドレスに置き換えます。
コマンドを実行すると、次のような出力が表示されます。次の例では、ユーザー
ariel@example.comのアクセス権を取り消します。Success: NUMBER of sessions revoked for user ariel@example.comこの例では、変数 NUMBER はユーザーのアクティブ セッションの数を表します。
gdcloud admin auth revokeコマンドを再度実行して、ユーザーのアクセス権が取り消されたことを確認します。成功すると、次のように表示されます。No sessions found for account: ariel@example.comユニバース内のゾーンごとに上記の手順を繰り返します。