アクセス権の付与と取り消し

すべてのサブジェクト(ユーザーまたはグループ)は、2 段階のプロセスを経てグローバル API サーバーにアクセスします。IAMRoleBinding を使用して、グローバル API サーバーの権限を事前定義された IAMRole に付与します。すべてのロールとロール バインディングはグローバルです。

このページは、組織内の権限を管理するプラットフォーム管理者グループのユーザーを対象としています。詳細については、GDC エアギャップ ドキュメントの対象読者をご覧ください。

始める前に

ロール バインディングを管理したり、アクセス権を取り消したりする前に、必要な権限をリクエストして環境を準備する必要があります。必要なロールは、ロール バインディングを管理するか、ユーザー アクセスを取り消すかによって異なります。

IAM ロールをリクエストする

実行する必要があるタスクに基づいてロールをリクエストするには、IAM 組織管理者に連絡してください。

  • IAM 組織管理者(organization-iam-admin): 組織レベルとプロジェクト レベルでロール バインディングを作成、更新、削除します。
  • セッション組織管理者(org-session-admin): 特定のゾーン内でユーザーのアクティビティ セッションとアクセスを取り消します。

環境を準備する

コマンドライン ツールを使用してロール バインディングを管理したり、アクセス権を取り消したりするには、次の設定を行います。

ロール バインディングを設定する

チームメンバーに組織レベルまたはプロジェクト レベルでリソースへのアクセス権を付与するロール バインディングを設定できます。

承認済みメンバーにロールを割り当てます。

コンソール

  1. GDC コンソールにログインします。
  2. スコープ選択ツールから組織またはプロジェクトを選択します。
    • 組織のロール バインディングを設定するには、組織を選択します。
    • プロジェクトのロール バインディングを設定するには、プロジェクトを選択します。
  3. ナビゲーション メニューで、[ID とアクセス] > [アクセス] をクリックします。
  4. [メンバーを追加] をクリックします。
  5. 個々のユーザーを追加するか、グループを追加するかを選択します。
  6. [ID プロバイダ] リストで、ID プロバイダを選択します。
  7. [ユーザー名またはグループ エイリアス] フィールドに、ユーザー名、メールアドレス、またはエイリアスを入力します。
  8. [ロール] リストで、ユーザーまたはグループに割り当てるロールを選択します。たとえば、組織レベルの組織閲覧者やプロジェクト レベルのプロジェクト作成者などです。
  9. [追加] をクリックします。

メンバーが [承認済みメンバー] リストに表示されます。

gdcloud

  1. gdcloud CLI がインストールされていることを確認します。

  2. gdcloud auth login コマンドを使用してログインし、ID プロバイダで認証します。詳細については、gdcloud CLI 認証をご覧ください。

  3. ロール バインディングを設定します。

    • 組織のロール バインディングを設定します。

      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

  1. ロール バインディングの環境変数をエクスポートします。

    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 など)。
  2. 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
    

ロール バインディングを削除する

アクセスが不要になったら、メンバーと、関連付けられているロール、権限、アクセス権を削除します。

メンバーを削除する手順は次のとおりです。

コンソール

  1. GDC コンソールにログインします。
  2. ナビゲーション メニューで、[ID とアクセス] > [アクセス] をクリックします。
  3. [承認済みメンバー] リストで、メンバーを選択します。
  4. [メンバーを削除] をクリックします。
  5. 確認を求められたら、[メンバーを削除] をクリックして確定します。

gdcloud

  1. gdcloud CLI がインストールされていることを確認します。

  2. gdcloud auth login コマンドを使用してログインし、ID プロバイダで認証します。詳細については、gdcloud CLI 認証をご覧ください。

  3. ロール バインディングを削除します。

    • 組織のロール バインディングを削除します。

      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 ユニバース全体でユーザーのアクセス権を取り消すには、各ゾーンのアクセス権を個別に、各ゾーンで次の手順を完了します。

  1. アクセス権を取り消すゾーンにログインしていることを確認します。たとえば、gdcloud CLI のゾーン URL 構成を設定してから、ログインします。

    gdcloud config set organization_console_url ZONE_URL
    gdcloud auth login
    

    ZONE_URL は、ユーザー アクセスを取り消すゾーンの GDC コンソール URL に置き換えます。これは https://console.ORG_NAME.ZONE_NAME.ORG_SUFFIX のようになります。

    ゾーン コンテキストの切り替えの詳細については、ツールを使用してゾーンにアクセスするをご覧ください。

  2. ゾーンに対するユーザーのアクセス権を取り消します。

    gdcloud admin auth revoke --accounts USER_EMAIL
    

    USER_EMAIL は、アクセス権を取り消すユーザーのメールアドレスに置き換えます。

    コマンドを実行すると、次のような出力が表示されます。次の例では、ユーザー ariel@example.com のアクセス権を取り消します。

    Success: NUMBER of sessions revoked for user ariel@example.com
    

    この例では、変数 NUMBER はユーザーのアクティブ セッションの数を表します。

  3. gdcloud admin auth revoke コマンドを再度実行して、ユーザーのアクセス権が取り消されたことを確認します。成功すると、次のように表示されます。

    No sessions found for account: ariel@example.com
    
  4. ユニバース内のゾーンごとに上記の手順を繰り返します。