アクセス権の管理の概要

アカウントのユーザーの IBM Cloud Satellite® サービス・インスタンスへのアクセスは、IBM Cloud の ID およびアクセス管理 (IAM) によって制御されます。 アカウントの Satellite サービスにアクセスするすべてのユーザーに、IAM 役割を定義したアクセス・ポリシーを割り当てる必要があります。 このポリシーは、ユーザーが選択したサービスまたはインスタンスのコンテキスト内で実行できる操作を規定します。 許可されるアクションは、サービス上で実行できる操作として、IBM Cloud サービスによってカスタマイズされて定義されます。 その後、操作は IAM ユーザー役割にマップされます。

IAM での IBM Cloud Satellite サービスの名前は以下のとおりです。

  • UI では IBM Cloud Satellite
  • API および CLI では satellite

IBM Cloud でサービスを使用する場合は、Satellite サービスに対する許可が必要であることに注意してください。 例えば、Satellite ロケーションでクラスターを作成および管理するには、IAM の Red Hat OpenShift on IBM Cloud に対する適切な許可 (UI の Kubernetes Service、API および CLI の containers-kubernetes) が必要です。

ロケーションおよびホスト

Satellite のロケーションIAMリソースタイプに関する詳細を確認してください。これには、ロケーションおよびホストに対するアクションが含まれています。

アクセス・ポリシーの有効範囲を location リソース・タイプに設定した場合、ユーザーはそのロケーションと対話するためにリージョン・エンドポイントをターゲットにする必要があります。 詳しくは、トラブルシューティングのトピックを参照してください。

リソース・タイプの名前
UI: Location
API または CLI: location
IAM でリソースに割り当てることができる役割のタイプ
プラットフォーム・アクセス ビューアーオペレーター編集者、および 管理者 の役割
クラスターを作成するためのカスタム・サービス・アクセス役割、Satellite クラスター作成者
リソースのアクセス・ポリシーの有効範囲を設定できる対象
アカウント
リソース・グループ
リソースのインスタンス
説明
ロケーション は、独自のホスト計算マシンをロケーションに接続することによって IBM Cloud を拡張するために使用する場所です。 ロケーション・リソースへのアクセス権限により、ユーザーはロケーションおよびホストで作業できます。 ただし、ロケーションのアクセス権限では、エンドポイント、構成、または Red Hat OpenShift クラスターなど、ロケーション内で実行される他のリソースへのアクセス権限は付与されません。

構成、サブスクリプション、クラスター、クラスター・グループ、およびリソース

「 Satellite Config」IAMリソースタイプに関する詳細を確認してください。これには、構成、サブスクリプション、クラスター、クラスターグループ、リソース、およびストレージなど、「 Satellite Config」を使用するその他のコンポーネントに対するアクションが含まれます。

リソース・タイプの名前
コンソール: ConfigurationSubscriptionClusterClustergroup、または Resource
API または CLI: configurationsubscriptionclusterclustergroup、または resource
IAM でリソースに割り当てることができる役割のタイプ
プラットフォーム・アクセス ビューアーオペレーター編集者、および 管理者 の役割
サービス・アクセスのリーダーライター、および マネージャーの各役割と、カスタムのデプロイヤー 役割
リソースのアクセス・ポリシーの有効範囲を設定できる対象
アカウント
クラスターまたはクラスター・グループのみ: リソースの特定のインスタンス。
説明
Satellite 構成 は、Satellite Config コンポーネントに登録されているクラスターのグループに Kubernetes リソースを自動的にデプロイするために使用する構成、バージョン、およびサブスクリプションの集合です。 ただし、Satellite 構成へのアクセス権限では、ユーザーは、構成の Kubernetes リソースを実行するクラスターにはアクセスできません。 アクセスの有効範囲として、以下の Satellite Config リソースを指定できます。
  • 構成。デプロイする Kubernetes リソースの構成ファイルのバージョンをアップロードします。 ポリシーの有効範囲として特定の構成を指定することはできません。
  • サブスクリプション。これは、構成にバージョンとして追加した Kubernetes リソース定義をデプロイするクラスターグループを指定するために使用します。 ポリシーの有効範囲として特定の構成を指定することはできません。
  • クラスターまたはクラスター・グループ。Red Hat OpenShift on IBM Cloud 構成に登録され、構成にサブスクライブできる Satellite です。
  • リソース。Satellite 構成で記述され、サブスクライブされたクラスターで実行されるポッドやサービスなどの Kubernetes リソースです。 特定のロールでは、 Satellite Config を通じて Kubernetes のリソースを閲覧・管理することが可能ですが、アクセスポリシーの適用範囲を特定のリソースに限定することはできません。

その他のサービス

Red Hat OpenShift on IBM Cloud クラスタや、 Satellite に対応したその他の IBM Cloud サービスなど、 Satellite に対応したその他の IBM Cloud サービスのIAMリソースタイプに関する詳細を確認してください。

リソース・タイプ、IAM 役割、およびアクセス・ポリシーの有効範囲

サービスによって異なります。 例えば、Red Hat OpenShift on IBM Cloud は IAM の Kubernetes Service であり、アクセスの有効範囲としてクラスターまたは名前空間リソースを指定できます。 詳しくは、サービスの資料を参照してください。

Red Hat OpenShift on IBM Cloud クラスター

Satellite では、Red Hat OpenShift クラスターのアクセス・ポリシーを割り当てません。 代わりに、クラスターへのアクセスは、IBM Cloud を介した Red Hat OpenShift on IBM Cloud IAM (コンソールの Kubernetes Service あるいは API または CLI の containers-kubernetes) で割り当てられます。 詳しくは、 Red Hat OpenShift クラスターのプラットフォームおよびサービスの役割を参照してください。

Satellite ロケーションまたは構成にアクセスできる場合は、そのロケーションまたは構成に接続されているクラスターを表示できます。 ただし、これらのクラスターにアクセスするには、適切なIAMロールが必要です。 たとえば、 Satellite の設定に対する適切なアクセス権限がある場合、 Satellite のConfig APIを通じて、登録済みのクラスターで実行されているすべての Kubernetes リソースを一覧表示することができます。 個々のクラスターへのアクセスポリシーがない場合、個々のクラスターにログインして、 Red Hat OpenShift API を使用して Kubernetes のリソースを一覧表示することはできません。 詳細については、以下のトピックを参照してください。

  • プラットフォームおよびサービスの役割を含む、ユーザーアクセス権限に関する リファレンスドキュメント
  • クラスター資格情報を設定 します。例えば、基礎となるインフラストラクチャー許可の API キーをセットアップしたり、 IBM Cloud IAM を使用してユーザーにアクセス権限を付与したりします。
  • パブリック・サービス・エンドポイントまたはプライベート・サービス・エンドポイント、あるいは自動化などのために IBM Cloud IAM API キーを使用したクラスターへのアクセス
その他のマネージド・サービス

Satellite を他の マネージド・サービス と共に使用するには、 Satellite をターゲット・サービスとし、マネージド・サービスをソース・サービスとして、IAM を介したサービス間アクセスをセットアップする必要があります。

Red Hat OpenShift クラスターのプラットフォームおよびサービスの役割

Red Hat OpenShift on IBM Cloud ロケーションで使用する Red Hat OpenShift クラスターを作成する場合は、Red Hat OpenShift ではなく Red Hat OpenShift サービスの IAM でこれらのクラスターへのアクセスを管理します。 Red Hat OpenShift クラスターへの IAM アクセスを管理するには、以下の情報を確認してください。

  • プラットフォームおよびサービスの役割を含む、ユーザーアクセス権限に関する リファレンスドキュメント
  • クラスター資格情報を設定 します。例えば、基礎となるインフラストラクチャー許可の API キーをセットアップしたり、 IBM Cloud IAM を使用してユーザーにアクセス権限を付与したりします。
  • パブリック・サービス・エンドポイントまたはプライベート・サービス・エンドポイント、あるいは自動化などのために IBM Cloud IAM API キーを使用したクラスターへのアクセス

IBM Cloud での一般的なユース・ケースと役割

Satellite アクセス・グループおよびユーザーに割り当てるべきアクセス役割を判断する方法について説明します。 次の表の例を参考にして、割り当てる役割と範囲を決定してください。

さまざまなユースケースに対応するために割り当てる役割の種類。
ユース・ケース 役割および有効範囲の例
ロケーションの作成 ユーザーと、リージョンおよびリソース・グループ用に設定された API キーには、次の許可が必要です。 すべての Satellite ロケーションの管理者のプラットフォーム役割。 Satellite Link のカスタムの Satellite Link 管理者のサービス役割。 ロケーション・コントロール・プレーン・データをバックアップする IBM Cloud Object Storage インスタンスに対するマネージャーのサービス役割。 AWS または Azure のホストを追加するなどのために自動化テンプレートを使用するには、IBM Cloud Schematics に対する管理者のプラットフォーム役割と Kubernetes Service に対する管理者のプラットフォーム役割。 ロケーション・コントロールプレーンを設定するためのその他の権限については、「 クラスターを作成するための権限 」を参照してください。
ロケーションでのクラスターの作成 Satellite クラスターの作成 を参照してください。
ロケーション監査員 Satellite ロケーションおよびリンク・エンドポイントのビューアーのプラットフォーム役割。 ロケーションの構成リソースのリーダーのサービス役割。 ロケーション・コントロール・プレーン・データをバックアップする IBM Cloud Object Storage インスタンスに対するリーダーのサービス役割。
アプリ開発者 Satellite ロケーションのビューアーのプラットフォーム役割。 構成リソースのライターまたはデプロイヤーのサービス・アクセス役割。 クラスター内の Red Hat OpenShift クラスターまたは特定のプロジェクトに対する編集者プラットフォーム役割および ライター・サービス役割。
課金 アカウントのすべての Satellite ロケーションに対するビューアーのプラットフォーム役割。
ロケーション管理者 ロケーションおよびリンク・リソースの管理者のプラットフォーム役割。 Red Hat OpenShift クラスターに対する管理者プラットフォーム役割。 ロケーション・コントロール・プレーン・データをバックアップする IBM Cloud Object Storage インスタンスに対するマネージャーのサービス役割。
DevOps オペレーター ロケーションおよびリンク・リソースのエディターのプラットフォーム役割。 構成に対するデプロイヤーのサービス役割。 Red Hat OpenShift クラスターに対するオペレーター・プラットフォーム役割。
オペレーターまたはサイト信頼性エンジニア ロケーションおよびリンク・リソースの管理者のプラットフォーム役割。 構成リソースに対するマネージャーのサービス役割。 Red Hat OpenShift クラスターに対する管理者プラットフォーム役割とマネージャー・サービス役割。