このページでは、Google Distributed Cloud(GDC)エアギャップ プロジェクト内のストレージ バケットへのアクセスを管理し、適切なユーザーに適切な権限を付与する方法について説明します。ロール バインディングと事前定義ロールを使用してユーザーとサービス アカウントのアクセス権を取得して付与するための前提条件と手順について説明します。この情報により、ストレージ リソースへのアクセスを効果的に制御し、セキュリティと運用効率の両方を維持できます。
このページは、GDC エアギャップ環境でストレージ バケットのアクセス設定を管理するインフラストラクチャ オペレーター グループの IT 管理者や、アプリケーション オペレーター グループのデベロッパーなどを対象としています。詳細については、GDC エアギャップ ドキュメントの対象読者をご覧ください。
始める前に
プロジェクトの名前空間は、Management API サーバーのバケット リソースを管理します。バケットとオブジェクトを操作するには、プロジェクトが必要です。
バケットへのアクセス権を付与する
S3 API リソース(バケットやバケット内のオブジェクトなど)へのアクセス権を User サブジェクトと ServiceAccount サブジェクトに付与するには、Management API サーバーの事前定義ロールを参照する RoleBinding を作成して適用します。
事前定義ロール
project-bucket-object-viewer: このロールを付与されたユーザーは、プロジェクト内のすべてのバケットの一覧表示、それらのバケット内のオブジェクトの一覧表示、オブジェクトとオブジェクト メタデータの読み取りを行うことができます。オブジェクトに対する書き込みオペレーションは実行できません。たとえば、アップロード、上書き、削除などです。組織とそのプロジェクト内のデュアルリージョン バケットに対する読み取り専用アクセス権と、それらのバケット内のオブジェクトに対する読み取り専用アクセス権。
project-bucket-object-admin: ユーザーは、プロジェクト内のすべてのバケットを一覧表示し、オブジェクトに対する書き込みオペレーションと読み取りオペレーションを実行できます。たとえば、アップロード、上書き、削除などです。組織とそのプロジェクト内のデュアルゾーン バケットに対する読み取り専用権限と、それらのバケット内のオブジェクトに対する読み取り / 書き込み権限。
project-bucket-admin: ユーザーは、指定された Namespace 内のすべてのバケットと、それらのバケット内のすべてのオブジェクトを管理できます。組織とそのプロジェクト内のデュアルゾーン バケットに対する読み取り専用権限と、それらのバケット内のオブジェクトに対する読み取り / 書き込み権限。
上記のロールに付与されている権限の完全なリストについては、事前定義ロールの権限セクションをご覧ください。
プロジェクトでロール バインディングを作成するには、そのプロジェクトの IAM プロジェクト管理者ロールが必要です。次の例では、ユーザーとサービス アカウントにアクセス権を付与する RoleBinding リソースを作成しています。
システムに YAML ファイル(
rolebinding-object-admin-all-buckets.yamlなど)を作成します。# Example file name: # rolebinding-object-admin-all-buckets.yaml apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: namespace: PROJECT_NAMESPACE name: readwrite-all-buckets roleRef: kind: Role name: project-bucket-object-admin apiGroup: rbac.authorization.k8s.io subjects: - kind: ServiceAccount namespace: PROJECT_NAMESPACE name: SA_NAME - kind: User namespace: PROJECT_NAMESPACE name: bob@example.com apiGroup: rbac.authorization.k8s.io # Could be bob or bob@example.com based on your organization settings.次のように置き換えます。
PROJECT_NAMESPACE: プロジェクトの名前空間の名前SA_NAME: サービス アカウントの名前
YAML ファイルを適用します。
kubectl apply \ -f rolebinding-object-admin-all-buckets.yaml
バケットのアクセス認証情報を取得する
バケットへのアクセス権を付与すると、Secret にアクセス認証情報が作成されます。Distributed Cloud CLI を構成し、バケットを操作するコマンドを実行するには、認証情報が必要です。
シークレット名の形式は object-storage-key-STORAGE_CLASS-SUBJECT_TYPE-SUBJECT_HASH です。
STORAGE_CLASSの値は次のとおりです。Standardストレージ クラスの場合はstd。
SUBJECT_TYPEの値は次のとおりです。user: ユーザー。sa: ServiceAccount。
SUBJECT_HASHは、サブジェクト名の base32 でエンコードされた SHA256 ハッシュです。
たとえば、ユーザー bob@foo.com には、次の名前のシークレットがあります。
object-storage-key-std-user-l74gbpyrsbmwy4mivocr3nur6dzrnhcfhe3otyplul42i732aama
ユーザー アクセス認証情報を取得する
ユーザー サブジェクトの場合、Secret は Management API サーバーの object-storage-access-keys Namespace にあります。
次のコマンドを実行して、名前空間
object-storage-access-keysで表示権限を持つ Secret リソースを一覧表示します。kubectl auth can-i --list --namespace object-storage-access-keys | grep "object-storage-key-"この Namespace で Secret を表示できる場合は、次のように
object-storage-key-で始まる 1 つ以上の Secret 名を含む出力が表示されます。secrets [] [object-storage-key-std-user-l74gbpyrsbmwy4mivocr3nur6dzrnhcfhe3otyplul42i732aama] [get]注: すべての Secret リソースを表示する権限または他のユーザーの権限を借用する権限を持つ管理者の場合は、次のいずれかのコマンドを実行して、指定したユーザーの Secret の名前を確認できます。
指定したユーザーに属するすべての Secret を一覧表示します。
export USER_NAME=bob@example.com kubectl get secrets --namespace object-storage-access-keys -o json | jq -r --arg USER_NAME "${USER_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'ユーザーになりすまして、表示できる Secret を確認します。
export USER_NAME=bob@example.com kubectl auth can-i --list --namespace object-storage-access-keys --as "${USER_NAME:?}" | grep "object-storage-key-"
対応する Secret の内容を取得します。
kubectl get -o yaml --namespace object-storage-access-keys secret SECRET_NAME次のような出力が表示されます。
data: access-key-id: MEhYM08wWUMySjcyMkVKTFBKRU8= create-time: MjAyMi0wNy0yMiAwMTowODo1OS40MTQyMTE3MDMgKzAwMDAgVVRDIG09KzE5OTAuMzQ3OTE2MTc3 secret-access-key: Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==アクセスキー ID とシークレットをデコードします。
echo "MEhYM08wWUMySjcyMkVKTFBKRU8=" | base64 -d \ && echo \ && echo "Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==" | base64 -d次のような出力が表示されます。
0HX3O0YC2J722EJLPJEO Rjt1TeySxJhBIRanigT00m2YsB/FRUzwjGBnaXbT取得した情報を使用して、gdcloud CLI を構成するの手順に沿って操作します。
サービス アカウントへのアクセス権を取得する
S3 シークレット認証情報は、プロジェクトの名前空間にバケットが存在する場合にのみ作成され、取得できます。
サービス アカウント(SA)サブジェクトの場合、Secret はサービス アカウントと同じ Namespace に作成されます。
次のコマンドを実行して、Namespace 内の Secret リソースを取得して一覧表示できることを確認します。できない場合は、管理者に連絡してください。
export SA_NAMESPACE=PROJECT_NAMESPACE
kubectl auth can-i --list --namespace $SA_NAMESPACE
Secret 名を確認するには、次のコマンドを実行します。
export SA_NAME=SA_NAME
kubectl get secrets --namespace $SA_NAMESPACE -o json | jq -r --arg USER_NAME "${SA_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'
次のような出力が表示されます。
object-storage-key-std-sa-mng3olp3vsynhswzasowzu3jgzct2ert72pjp6wsbzqhdwckwzbq
Pod 内の Secret は、環境変数またはファイルとして参照できます。
事前定義ロールの権限
事前定義ロールは、デュアルゾーン バケットへの管理アクセスと運用アクセスのために、グローバル API サーバーでも使用できます。
project-bucket-object-viewer 権限
このロールは、バケット内のオブジェクトとオブジェクトのメタデータを取得して一覧表示する権限を付与します。
project-bucket-object-viewer 動詞によって付与されるすべてのオブジェクト ストレージ権限のリストは次のとおりです。
バケット API の権限:
- get
- list
- watch
S3 オブジェクト ストレージの権限:
- GetBucketVersioning
- GetObject
- GetObjectAcl
- GetObjectLegalHold
- GetObjectRetention
- GetObjectTagging
- GetObjectVersion
- GetObjectVersionTagging
- ListBucket
- ListBucketVersions
- ListBucketMultipartUploads
- ListMultipartUploadParts
project-bucket-object-admin 権限
このロールは、バケット内のオブジェクト、オブジェクトのバージョン、タグを配置および削除する権限を付与します。また、project-bucket-object-viewer のすべての権限も付与されます。
ロールによって付与される追加のオブジェクト ストレージ権限のリストは次のとおりです。
S3 オブジェクト ストレージの権限:
- AbortMultipartUpload
- DeleteObject
- DeleteObjectTagging
- DeleteObjectVersion
- DeleteObjectVersionTagging
- PutObject
- PutObjectTagging
- PutObjectVersionTagging
- PutOverwriteObject
- RestoreObject
project-bucket-admin 権限
このロールは、プロジェクトの名前空間で Bucket リソースを作成、更新、削除する権限を付与します。また、project-bucket-object-admin のすべての権限も付与されます。
このロールによって付与される追加の権限は次のとおりです。
バケット API の権限:
- 作成
- 更新
- 削除