API アクセスの概要

このページでは、Cloud Endpoints で使用可能な API アクセス制御オプションについて説明します。

概要

Endpoints では、Identity and Access Management(IAM)を使用して API へのアクセスを制御します。プロジェクト レベルまたは個別の Endpoints サービスレベルで API へのアクセス権限を付与できます。たとえば、次のようなことが可能です。

  • サービスごとにプロジェクト メンバーへアクセス権限を付与する。
  • ユーザーまたはサービス アカウントに、更新された Endpoints 構成をデプロイするためのアクセス権限を付与する。
  • API ユーザーにアクセス権限を付与して、ユーザーが自分の Google Cloud プロジェクトで API を有効化できるようにする。

サービスへのアクセスを制御するロール

特定のサービスに関する以下のロールを付与できます。ロールを付与するには、Google Cloud Console で [エンドポイント] > [サービス] ページを使用するか、API または gcloud コマンドライン ツールを使用します。

IAM のロール名 ロールのタイトル 説明
roles/servicemanagement.serviceConsumer サービス ユーザー プロジェクト メンバー以外のユーザーが、自分のプロジェクトで API を表示し、有効化できる権限。サービス ユーザーのロールを付与する対象となるのは、Google アカウント、Google グループ、サービス アカウントのみです。API 用のポータルを作成済みの場合、このロールを持つ API ユーザーはそのポータルにアクセスできます。このロールについては、Service Management API アクセス制御をご覧ください。
roles/servicemanagement.serviceController サービス コントローラ 実行時に Service Infrastructure API で check メソッドと report メソッドを呼び出すための権限。通常、このロールはサービス アカウントに付与されます。このロールについては、Service Management API アクセス制御をご覧ください。
roles/servicemanagement.configEditor Service Config 編集者 Endpoints 構成をデプロイするための権限。このロールは、サービスに関して付与されるプロジェクト編集者のロールよりも、権限が制限されています。
roles/servicemanagement.admin Service Management 管理者 Service Config 編集者のすべての権限と、API へのアクセスを管理するための権限。サービスに関して付与されるプロジェクト オーナーのロールと同等です。

Endpoints Portal での権限

Endpoints Portal 管理者のロールは、プロジェクト レベルのロールであり、以下の権限が含まれています。

権限 説明
endpoints.portals.listCustomDomains Cloud Console の [Endpoints Portal] ページにアクセスするための権限。プロジェクト閲覧者のロールが付与されたプロジェクト メンバーも、この権限を持っています。
endpoints.portals.attachCustomDomain Cloud Console の [Endpoints Portal] ページでカスタム ドメインを追加するための権限。プロジェクト編集者のロールが付与されたプロジェクト メンバーも、この権限を持っています。
endpoints.portals.detachCustomDomain Cloud Console の [Endpoints Portal] ページでカスタム ドメインを削除するための権限。プロジェクト編集者のロールが付与されたプロジェクト メンバーも、この権限を持っています。
endpoints.portals.update API 用に作成されたポータルで、[Settings] ページの [Site Wide] タブにアクセスして、ポータルで使われる色やロゴなどの設定を変更する権限。

次のステップ