IAM によるアクセス制御

Identity and Access Management(IAM)ロールを使用して Error Reporting レポートデータへのアクセスを制御し、最小権限を適用しながら、チームメンバーがアプリケーション エラーの表示、トリアージ、管理に必要な権限を確実に取得できるようにします。

IAM のロールと権限によって、Google Cloud コンソールと Error Reporting API を介してアクセスできる Error Reporting リソースが決まります。これらのロールは、 Google Cloud プロジェクト、フォルダ、または組織レベルで付与し、リソース階層全体で適切なアクセス権をプリンシパルに付与します。

事前定義ロール

IAM には、特定の Google Cloud リソースに対するきめ細かいアクセス権を付与する事前定義ロールが用意されています。 Google Cloud はこれらのロールを作成、維持し、必要に応じて自動的に権限を更新します(Error Reporting に新機能が追加された場合など)。ロールと権限については、IAM のロールと権限のインデックスをご覧ください。

次の表に、Error Reporting のロール、ロールのタイトル、説明、含まれている権限、ロールを設定できる最低レベルのリソースタイプを示します。このリソースタイプまたはほとんどの場合に Google Cloud 階層のそれ以上の任意のリソースタイプに特定のロールを付与できます。

Role Permissions

(roles/errorreporting.admin)

Provides full access to Error Reporting data.

Lowest-level resources where you can grant this role:

  • Project

cloudnotifications.activities.list

errorreporting.*

  • errorreporting.applications.list
  • errorreporting.errorEvents.create
  • errorreporting.errorEvents.delete
  • errorreporting.errorEvents.list
  • errorreporting.groupMetadata.get
  • errorreporting.groupMetadata.update
  • errorreporting.groups.list

logging.notificationRules.*

  • logging.notificationRules.create
  • logging.notificationRules.delete
  • logging.notificationRules.get
  • logging.notificationRules.list
  • logging.notificationRules.update

resourcemanager.projects.get

resourcemanager.projects.list

stackdriver.projects.get

(roles/errorreporting.user)

Provides the permissions to read and write Error Reporting data, except for sending new error events.

Lowest-level resources where you can grant this role:

  • Project

cloudnotifications.activities.list

errorreporting.applications.list

errorreporting.errorEvents.delete

errorreporting.errorEvents.list

errorreporting.groupMetadata.*

  • errorreporting.groupMetadata.get
  • errorreporting.groupMetadata.update

errorreporting.groups.list

logging.notificationRules.*

  • logging.notificationRules.create
  • logging.notificationRules.delete
  • logging.notificationRules.get
  • logging.notificationRules.list
  • logging.notificationRules.update

resourcemanager.projects.get

resourcemanager.projects.list

stackdriver.projects.get

(roles/errorreporting.viewer)

Provides read-only access to Error Reporting data.

Lowest-level resources where you can grant this role:

  • Project

cloudnotifications.activities.list

errorreporting.applications.list

errorreporting.errorEvents.list

errorreporting.groupMetadata.get

errorreporting.groups.list

logging.notificationRules.get

logging.notificationRules.list

resourcemanager.projects.get

resourcemanager.projects.list

stackdriver.projects.get

(roles/errorreporting.writer)

Provides the permissions to send error events to Error Reporting.

Lowest-level resources where you can grant this role:

  • Service Account

errorreporting.errorEvents.create

API 権限

Error Reporting API メソッドでは、特定の IAM 権限が必要です。次の表に、API メソッドで必要な権限の一覧と説明を示します。

メソッド 必要な権限 説明
deleteEvents errorreporting.errorEvents.delete エラーイベントの削除。
events.list errorreporting.errorEvents.list エラーイベントの一覧表示。
events.report errorreporting.errorEvents.create エラーイベントの作成または更新。
groupStats.list errorreporting.groups.list ErrorGroupStats の一覧表示。
groups.get errorreporting.groupMetadata.get エラーグループ情報の取得。
groups.update
  • errorreporting.groupMetadata.update
  • errorreporting.applications.list
  • エラーグループ情報の更新とミュート。
    エラー解決ステータスの変更。
  • プロジェクトのサービスとバージョンの一覧表示。
  • 考慮事項

    プリンシパルのユースケースに適用される権限とロールを決定する際は、次に示す Error Reporting のアクティビティと必要な権限の概要を考慮してください。

    アクティビティ 必要な権限
    Error Reporting Google Cloud コンソール ページに対する読み取り専用アクセス権がある。 errorreporting.applications.list
    errorreporting.groupMetadata.get
    errorreporting.groups.list
    Google Cloud コンソールでグループの詳細を表示します。 読み取り専用権限に加えて次の権限:
    errorreporting.errorEvents.list
    Google Cloud コンソールでメタデータと解決ステータス(エラーのミュートを含む)を変更します。 読み取り専用権限に加えて次の権限:
    errorreporting.groupMetadata.update
    Google Cloud コンソールでエラーを削除します。 読み取り専用権限に加えて次の権限:
    errorreporting.errorEvents.delete
    エラーを作成します( Google Cloud コンソール権限は必要ありません)。 errorreporting.errorEvents.create
    通知を設定します。 読み取り専用権限に加えて次の権限:
    cloudnotifications.activities.list

    ロールの付与と管理

    IAM ロールの付与と管理には、Google Cloud コンソール、IAM API メソッド、Google Cloud CLI を使用します。ロールの付与と管理の手順については、アクセス権の付与、変更、取り消しをご覧ください。

    1 人のユーザーに複数のロールを付与できます。ロールに含まれる権限のリストを取得するには、ロール メタデータの取得をご覧ください。

    Google Cloud リソースにアクセスしようとしたときに必要な権限が不足している場合は、リソースのオーナーとして登録されているユーザーにお問い合わせください。

    カスタムロール

    Error Reporting の権限を含むカスタムのロールを作成するには、API 権限から権限を選択し、カスタムロールの作成の手順に従います。

    ロール変更のレイテンシ

    Error Reporting は IAM 権限を 5 分間キャッシュに保存します。このため、ロールの変更が反映されるまでに最大で 5 分ほどかかります。