このページでは、Secure Source Manager での Identity and Access Management（IAM）によるアクセス制御について説明します。
概要
IAM の権限とロールによって、Secure Source Manager インスタンスでデータを作成、表示、編集、削除できるかどうかが決まります。
ロールとは、一連の権限のことです。プリンシパルに直接権限を付与することはできません。代わりに、ロールを付与します。プリンシパルにロールを付与すると、そのロールに含まれるすべての権限が付与されます同じプリンシパルに複数のロールを付与できます。
事前定義された Secure Source Manager のロールを付与する
Secure Source Manager API のすべてのメソッドでは、リクエストを行うプリンシパル（ユーザー、グループ、またはサービス アカウント）に、リソースを使用するために必要な権限が付与されている必要があります。プリンシパルに権限を付与するには、リソースに対する事前定義ロールをプリンシパルに付与するポリシーを設定します。
Secure Source Manager のロールは、各ロールをプリンシパルに割り当てるまで、 Google Cloud コンソールに表示されません。Secure Source Manager インスタンスとリポジトリ リソースにロールを付与する方法については、IAM ロールを付与および取り消すをご覧ください。
Secure Source Manager の権限
使用可能なすべての Secure Source Manager 権限を表示するには、IAM 権限のリファレンスで securesourcemanager. を検索します。
IAM のアクセスレベル
IAM ロールは、リソース階層のさまざまなレベルで付与できます。
- プロジェクト レベル: プロジェクト内のすべての Secure Source Manager インスタンスとリポジトリへのアクセス権を付与します。プロジェクト レベルのロールは、 Google Cloud コンソールの IAM ページを使用して付与できます。
- インスタンス レベル: 特定の Secure Source Manager インスタンスへのアクセス権を付与します。インスタンス レベルのロールを付与するには、gcloud CLI ツールまたは API を使用する必要があります。これらのバインディングは、プロジェクト レベルのGoogle Cloud コンソールの IAM ページには表示されません。
- リポジトリ レベル: 特定のリポジトリへのアクセス権を付与します。リポジトリレベルのロールを付与するには、Secure Source Manager のウェブ インターフェース、gcloud CLI ツール、または API を使用します。
Secure Source Manager の事前定義ロール
プロジェクト レベルとフォルダレベルに加えて、Secure Source Manager の IAM ロールはインスタンス リソースとリポジトリ リソースに付与できます。
事前定義された Secure Source Manager のすべてのロールと、各ロールで使用可能な権限を確認するには、IAM の基本ロールと事前定義ロールのリファレンスをご覧ください。
インスタンス ロール
インスタンス ロールは、Secure Source Manager インスタンスに対する権限をプリンシパルに付与します。リポジトリのロールは個別に付与されます。
リポジトリのロール
リポジトリ ロールは、Secure Source Manager リポジトリに対する権限をプリンシパルに付与します。
カスタムロール
Secure Source Manager は、事前定義ロールに加えて、カスタムロールもサポートしています。詳しくは、IAM ドキュメントのカスタムロールの作成と管理をご覧ください。
リポジトリのロール管理
以降のセクションでは、一般的なリポジトリ アクションに必要なロールについて説明します。
リポジトリを管理
Secure Source Manager リポジトリを作成、削除、ユーザーを追加するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- Secure Source Manager インスタンスに対する Secure Source Manager インスタンス リポジトリ作成者（
roles/securesourcemanager.instanceRepositoryCreator） - 管理するリポジトリに対するリポジトリ管理者（
roles/securesourcemanager.repoAdmin）
リポジトリの作成
Secure Source Manager インスタンスにリポジトリを作成するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- Secure Source Manager インスタンスに対する Secure Source Manager インスタンス リポジトリ作成者（
roles/securesourcemanager.instanceRepositoryCreator） - Google Cloud プロジェクトに対する Secure Source Manager リポジトリ作成者（
roles/securesourcemanager.repoCreator）
リポジトリを表示する
リポジトリの表示に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- Secure Source Manager インスタンスに対する Secure Source Manager インスタンス アクセサー（
roles/securesourcemanager.instanceAccessor） - リポジトリに対する Secure Source Manager Repo 閲覧者（
roles/securesourcemanager.repoReader）
リポジトリを使用して、問題と pull リクエストを作成する
リポジトリへの push と pull、問題と pull リクエストの作成に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- Secure Source Manager インスタンスに対する Secure Source Manager インスタンス アクセサー（
roles/securesourcemanager.instanceAccessor） - リポジトリに対する Secure Source Manager リポジトリ書き込み（
roles/securesourcemanager.repoWriter）
次のステップ
- Google Cloud でのアクセス管理の詳細については、IAM の概要をご覧ください。
- Secure Source Manager の IAM ロールを付与する。
- プログラムで Secure Source Manager に対して認証を行う。