フリート・アプリケーション管理ポリシーおよび権限
Identity and Access Management (IAM)ポリシーを作成して、誰がフリート・アプリケーション管理リソースにアクセスできるか、および各ユーザー・グループのアクセスのタイプを制御します。
フリート・アプリケーション管理リソースに対する必要な権限をユーザーに付与するためのポリシーを作成します。デフォルトでは、Administrators
グループのユーザーは、すべてのフリート・アプリケーション管理リソースにアクセスできます。
IAMポリシーを初めて使用する場合は、ポリシーの開始を参照してください。
Oracle Cloud Infrastructureのすべてのポリシーの完全なリストは、ポリシー・リファレンスおよび共通ポリシーを参照してください。
フリート・アプリケーション管理では、テナンシ管理者が、オンボーディング中にフリート・アプリケーション管理によって作成される動的グループにルールを追加する必要があります。このアクションにより、フリート・アプリケーション管理はOCI Computeでライフサイクル管理操作を実行できます。
この項で説明する内容は次のとおりです。
リソース・タイプおよび権限
フリート・アプリケーション管理リソース・タイプおよび関連する権限のリスト。
すべてのOCIフリート・アプリケーション管理リソースに権限を割り当てるには、fams-family
集計タイプを使用します。詳細は、権限を参照してください。
次の表に、fams-family
内のすべてのリソースを示します。
姓 | メンバー・リソース |
---|---|
家族家族 |
|
<verb> fams-family
を使用するポリシーは、個々のリソース・タイプごとに個別の<verb> <resource-type>
ステートメントを使用してポリシーを記述することと同じです。
リソースの種類 | 権限 |
---|---|
家族フリート |
|
ファムランブック |
|
家族スケジュール |
|
ファム・メンテナンス・ウィンドウ |
|
ファム管理者 |
|
ファム・ワーク要求 |
|
ファム・コンプライアンス・ポリシー |
|
ファムパッチ |
|
サポートされている変数
変数は、フリート・アプリケーション管理のポリシーに条件を追加するときに使用されます。
フリート・アプリケーション管理では、次の変数がサポートされています:
- エンティティ: Oracle Cloud Identifier (OCID)
- 文字列: フリーフォーム・テキスト
- リスト: エンティティまたは文字列のリスト
すべてのリクエストの一般的な変数を参照してください。
変数は小文字で、ハイフン区切りです。たとえば、target.tag-namespace.name
、target.display-name
です。ここで、name
は一意である必要があり、display-name
は説明です。
必須変数は、すべてのリクエストに対してフリート・アプリケーション管理によって提供されます。自動変数は、認可エンジンによって提供されます(シック・クライアントではSDKを使用したサービス・ローカルで、シン・クライアントではアイデンティティ・データ・プレーンで提供されます)。
必要な変数 | タイプ | 説明 |
---|---|---|
target.compartment.id |
エンティティ(OCID) | リクエストのプライマリ・リソースのOCID |
request.operation |
文字列 | リクエストの操作ID (例: GetUser ) |
target.resource.kind |
文字列 | リクエストのプライマリ・リソースのリソース種類名 |
自動変数 | タイプ | 説明 |
---|---|---|
request.user.id |
エンティティ(OCID) | リクエスト・ユーザーのOCID。 |
request.groups.id |
エンティティ(OCID)のリスト | リクエスト・ユーザーが属しているグループのOCID。 |
target.compartment.name |
文字列 | target.compartment.id で指定されたコンパートメントの名前 |
target.tenant.id |
エンティティ(OCID) | ターゲット・テナントIDのOCID |
動的変数 | タイプ | 説明 |
---|---|---|
request.principal.group.tag.<tagNS>.<tagKey> |
文字列 | プリンシパルがメンバーであるグループの各タグの値。 |
request.principal.compartment.tag.<tagNS>.<tagKey> |
文字列 | プリンシパルを含むコンパートメントの各タグの値。 |
target.resource.tag.<tagNS>.<tagKey> |
文字列 | ターゲット・リソースの各タグの値。(各リクエストでサービスによって提供されるtagSlugに基づいて計算されます。) |
target.resource.compartment.tag.<tagNS>.<tagKey> |
文字列 | ターゲット・リソースを含むコンパートメントの各タグの値。(各リクエストでサービスによって提供されるtagSlugに基づいて計算されます。) |
次に、変数に使用可能なソースのリストを示します。
- リクエスト: リクエスト入力から取得されます。
- 導出: リクエストから取得されます。
- 格納: サービスから取得され、入力が保持されます。
- 計算: サービス・データから計算されます。
動詞とリソース・タイプの組合せについての詳細
フリート・アプリケーション管理リソースの各動詞でカバーされる権限およびAPI操作を識別します。
アクセスのレベルは、inspect
からread
、use
、manage
の順に累積します。表のセルのプラス記号(+)
は、前のセルと比較した場合に増分アクセスを示します。
アクセス権の付与の詳細は、権限を参照してください。
この表は、fams-fleets
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 内容 |
---|---|---|---|
inspect |
FAMS_FLEET_INSPECT |
ListFleets
|
すべてのフリート、フリート内のリソースのすべてのターゲット、フリート内のリソースのすべての確認済ターゲット、フリートによって管理されるターゲットに関連付けられた製品、すべてのリソースをリストしますフリート、フリート内のすべてのプロパティ、コンパートメント内のフリートの資格証明、フリート・アプリケーション管理のお知らせ、すべてのプロパティ、すべてのプラットフォーム構成、すべての作業リクエストおよびテナンシのオンボーディング情報。 |
read |
|
|
特定のフリートの詳細をID別に取得し、フリートのコンプライアンス・レポートの生成を要求し、フリートのコンプライアンス・レポートを取得し、特定の条件に一致するRQSからすべてのリソースをリストします。フリート内のリソースの詳細の取得、フリート内のプロパティの詳細の取得、特定のIDのフリート資格証明の取得、プロパティの取得、プラットフォーム構成の詳細の取得、取得IDによる特定の作業リクエスト、特定のIDに対する作業リクエストの(ページ区切り)エラーのリスト、特定のIDに対する作業リクエストの(ページ区切り)ログのリスト、コンプライアンス・レポートの詳細を返し、コンプライアンス・レポートの詳細をエクスポートし、テナンシ内のフリートまたはターゲット別のコンプライアンス・レポートの集計されたサマリー情報を取得し、テナンシ内の管理対象エンティティの集計されたサマリー情報を取得します。 |
use |
|
|
ID別の特定のフリート、ID別の特定のフリート・リソース、ID別の特定のフリート・プロパティおよびIDで識別されるフリート資格証明を更新します。 |
manage |
|
|
フリートの作成、管理対象のフリート内のターゲットの確認、フリート内のリソースのターゲット検出のリクエスト、フリート内のリソースの検証のリクエスト、確認フリート・アプリケーション管理タグは、フリート内のリソースに追加したり、フリートにリソースを追加したり、フリートにプロパティを追加したり、フリートの資格証明を作成できます。 |
manage |
|
|
ID別の特定のフリート、フリートからのリソース、ID別のフリート・プロパティおよびプロビジョニングされたフリート資格証明を削除します。 |
この表は、fams-runbooks
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 内容 |
---|---|---|---|
inspect |
FAMS_RUNBOOK_INSPECT |
ListRunbooks
|
すべてのランブック、テナンシ内のタスク、すべてのプラットフォーム構成、すべての作業リクエストをリストし、テナンシのオンボーディング情報のリストを返し、IDでオンボーディングを取得します。 |
read |
|
|
特定のランブックをIDで取得し、特定のIDでタスクを取得し、プラットフォーム構成の詳細を取得し、IDで特定の作業リクエストを取得し、特定のIDで作業リクエストのエラーの(ページ区切り)リストを返し、特定のIDで作業リクエストのログの(ページ区切り)リストを返します。 |
use |
|
|
IDで識別されるランブックおよびIDで識別されるタスクを更新します。 |
manage |
|
|
runbookとタスクを作成します。 |
manage |
|
|
IDで識別されるランブックおよびIDで識別されるタスクを削除します。 |
manage |
|
|
ランブックを公開します。 |
この表は、fams-schedules
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 説明 |
---|---|---|---|
inspect |
FAMS_SCHEDULE_INSPECT |
ListScheduleDefinitions
|
すべてのスケジュール定義、スケジュール済ジョブのリスト表示、テナンシ内のスケジューラ・ジョブの集計済サマリー情報の取得、すべてのプラットフォーム構成のリスト表示、すべての作業リクエストのリスト表示、テナンシのオンボーディング情報のリストの表示およびIDによるオンボーディングの取得を行います。 |
read |
|
|
IDによるスケジュール定義の詳細の取得、スケジュール定義のすべてのフリートのリストの取得、IDによるスケジュール済ジョブの詳細の取得、識別子によるジョブ・アクティビティの取得、実行のリスト、IDによる実行の取得、実行ステップのリスト、リソースのリストジョブ・アクティビティ、プラットフォーム構成の詳細の取得、IDによる特定の作業リクエストの取得、特定のIDを持つ作業リクエストのエラーの(ページ区切り)リストの取得、特定のIDを持つ作業リクエストのログの(ページ区切り)リストの取得。 |
use |
|
|
特定のスケジュール定義およびIDで識別されるスケジューラ・ジョブを更新し、ジョブの実行アクションを管理します。 |
manage |
|
|
パッチ・コンプライアンスおよびスケジュール定義を修正するためのスケジュールを作成します。 |
manage |
|
|
特定のスケジュール定義を削除し、特定のスケジュール済ジョブを取り消します。 |
この表は、fams-maintenance-windows
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 説明 |
---|---|---|---|
inspect |
FAMS_MAINTENANCE_WINDOW_INSPECT |
ListMaintenanceWindows
|
すべてのメンテナンス・ウィンドウ、すべてのプラットフォーム構成、すべての作業リクエスト、テナンシのオンボーディング情報、IDによるオンボーディングの取得、 |
read |
|
|
メンテナンス・ウィンドウの詳細の取得、プラットフォーム構成の詳細の取得、IDによる特定の作業リクエストの取得、特定のIDによる作業リクエストのエラーの(ページ区切り)リストの返却、特定のIDによる作業リクエストのログの(ページ区切り)リストの返却 |
use |
|
|
メンテナンス・ウィンドウを更新します。 |
manage |
|
|
メンテナンス・ウィンドウを作成します。 |
manage |
|
|
特定のメンテナンス・ウィンドウを削除します。 |
この表は、fams-admin
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 内容 |
---|---|---|---|
inspect |
FAMS_ADMIN_INSPECT |
ListProperties
|
すべてのプロパティ、すべてのプラットフォーム構成、テナンシのオンボーディング情報をリストします。 |
read |
|
|
プロパティのすべての詳細の取得、プラットフォーム構成のすべての詳細の取得、コンプライアンス・レポートの詳細の取得、コンプライアンス・レポートの詳細のエクスポート、テナンシ内のフリートまたはターゲット別のコンプライアンス・レポートの集計済サマリー情報の取得、テナンシ内の管理対象エンティティの集計済サマリー情報の取得、 |
use |
|
|
プロパティの更新、自動検出頻度、プラットフォーム構成、IDで識別されるオンボーディング設定の管理、 |
manage |
|
|
プロパティおよびプラットフォーム構成を作成します。 |
manage |
|
|
プロパティを削除し、テナンシからすべてのデータを削除し、IDによるプラットフォーム構成を削除します。 |
この表は、fams-compliance-policies
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 内容 |
---|---|---|---|
inspect |
FAMS_COMPLIANCE_POLICY_INSPECT |
ListPlatformConfigurations
|
すべてのプラットフォーム構成のリスト、すべての作業リクエストのリスト、テナンシのオンボーディング情報のリスト、IDによるオンボーディングの取得、すべてのコンプライアンス・ポリシーのリスト、すべてのコンプライアンス・ポリシー・ルールのリスト。 |
read |
|
|
プラットフォーム構成の詳細を取得し、IDで特定の作業リクエストを取得し、特定のIDで作業リクエストのエラーの(ページ区切り)リストを返し、特定のIDで作業リクエストのログの(ページ区切り)リストを返します。特定のコンプライアンス・ポリシーを取得する、特定のコンプライアンス・ポリシー・ルールを取得する、コンプライアンス・レポートの詳細を返す、コンプライアンス・レポートの詳細をエクスポートする、テナンシ内のフリートまたはターゲット別のコンプライアンス・レポートの集計サマリー情報を取得する、テナンシ内の管理対象エンティティの集計サマリー情報を取得します。 |
read |
|
|
プラットフォーム構成の詳細を取得し、IDで特定の作業リクエストを取得し、特定のIDで作業リクエストのエラーの(ページ区切り)リストを返し、特定のIDで作業リクエストのログの(ページ区切り)リストを返しますテナンシのオンボーディング情報のリスト、IDによるオンボーディングの取得、コンプライアンス・レポートの詳細の返却、コンプライアンス・レポートの詳細のエクスポート、テナンシ内のフリートまたはターゲット別のコンプライアンス・レポートの集計サマリー情報の取得、テナンシ内の管理対象エンティティの集計サマリー情報の取得。 |
use |
|
|
特定のコンプライアンス・ポリシー・ルールをIDで更新します。 |
manage |
|
|
コンプライアンス・ポリシー・ルールを作成します。 |
manage |
|
|
特定のコンプライアンス・ポリシー・ルールをIDで削除します。 |
この表は、fams-patches
リソースの権限と、権限によって完全にカバーされるAPIを示しています。
動詞 | 権限 | カバーされるAPI | 内容 |
---|---|---|---|
inspect |
FAMS_PATCH_INSPECT |
ListPlatformConfigurations
|
すべてのプラットフォーム構成のリスト、すべての作業リクエストのリスト、テナンシのオンボーディング情報のリスト、IDによるオンボーディングの取得、すべてのパッチのリスト。 |
read |
|
|
プラットフォーム構成の詳細を取得し、IDで特定の作業リクエストを取得し、特定のIDで作業リクエストのエラーの(ページ区切り)リストを返し、次を使用して作業リクエストのログの(ページ区切り)リストを返します特定のID、コンプライアンス・レポートの詳細の返却、コンプライアンス・レポートの詳細のエクスポート、テナンシ内のフリートまたはターゲット別のコンプライアンス・レポートの集計済サマリー情報の取得、テナンシ内の管理対象エンティティの集計済サマリー情報の取得、特定のパッチの取得。 |
use |
|
|
特定のパッチをIDで更新します。 |
manage |
|
|
パッチを作成します。 |
manage |
|
|
特定のパッチをIDで削除します。 |
ユーザー・ポリシー
ユーザーがフリート・アプリケーション管理リソースにアクセスするには、フリート・アプリケーション管理ユーザー・ポリシーが必要です。
ポリシーの構文は次のとおりです:
allow <subject> to <verb> <resource-type> in <location> where <conditions>
詳細は、ポリシー構文を参照してください。
特定のユーザーまたはグループのポリシーを作成して、フリート・アプリケーション管理関連リソースへのアクセス権を取得します。ポリシーの作成に関する項を参照してください。
テナンシ・レベルで権限を適用するには、compartment <compartment name>
をtenancy
に置き換えます。
ポリシーの作成
ポリシーを書き込むグループおよびコンパートメントはすでに存在している必要があります。コンパートメントはAPIゲートウェイ関連のリソースを所有している必要があります。このリソースにアクセスするには、ポリシーを作成します。
コンソールまたはAPIを使用してポリシーを作成および管理する手順については、ポリシーの管理を参照してください。
Oracle Cloud Infrastructureのすべてのポリシーの完全なリストは、ポリシー・リファレンスを参照してください。
ポリシーの例
フリート・アプリケーション管理ポリシーは、様々なフリート・アプリケーション管理リソースを使用するために必要です。
コンソールを使用したポリシーの作成については、ポリシーの作成の手順を参照してください。
構文の詳細は、ポリシー構文を参照してください。
次のポリシーの例が提供されます:
Allow group acme-fams-developers to manage fams-family in tenancy
動的グループへのルールの追加
fams-customer-dg
グループのインスタンスおよびメンバーを作成するための一致ルールを定義します。フリート・アプリケーション管理は、これらのインスタンスに対してライフサイクル操作を実行します。IAMポリシー
組織のテナンシ管理者は、テナンシのフリート・アプリケーション管理を有効にします。このアクションは、フリート・アプリケーション管理を使用するための次のIAMポリシーを含む"fams-policy"を作成します。
「fams-service-dg」のIAMポリシーは次のとおりです。
define tenancy fams-tenancy as <fams-tenancy-ocid>
allow dynamic-group fams-service-dg to use instances in tenancy
allow dynamic-group fams-service-dg to inspect limits in tenancy
allow dynamic-group fams-service-dg to use tag-namespaces in tenancy where target.tag-namespace.name='Oracle$FAMS-Tags'
allow dynamic-group fams-service-dg to read instance-agent-plugins in tenancy
allow dynamic-group fams-service-dg to read instance-agent-command-family in tenancy
allow dynamic-group fams-service-dg to use ons-family in tenancy
allow dynamic-group fams-service-dg to manage database-family in tenancy
allow dynamic-group fams-service-dg to manage osms-family in tenancy
allow dynamic-group fams-service-dg to manage osmh-family in tenancy
allow dynamic-group fams-service-dg to { INSTANCE_AGENT_COMMAND_CREATE } in tenancy
allow dynamic-group fams-service-dg to { OBJECTSTORAGE_NAMESPACE_READ } in tenancy
「fams-customer-dg」のIAMポリシーは次のとおりです。
allow dynamic-group fams-customer-dg to { KEY_READ, KEY_DECRYPT,SECRET_READ } in tenancy
allow dynamic-group fams-customer-dg to use instance-agent-command-execution-family in tenancy where request.instance.id=target.instance.id
allow dynamic-group fams-customer-dg to read instance-family in tenancy
allow dynamic-group fams-customer-dg to use osms-managed-instances in tenancy
allow dynamic-group fams-customer-dg to {OSMH_MANAGED_INSTANCE_ACCESS} in tenancy
allow dynamic-group fams-customer-dg to {VAULT_READ} in tenancy
allow dynamic-group fams-customer-dg to {SECRET_BUNDLE_READ} in tenancy
allow dynamic-group fams-customer-dg to { OBJECT_INSPECT, OBJECT_READ } in tenancy
endorse dynamic-group fams-customer-dg to { OBJECT_CREATE, OBJECT_OVERWRITE, OBJECT_READ } in tenancy fams-tenancy where all { target.bucket.name = '<CUSTOMER_TENANCY_OCID>' }
endorse dynamic-group fams-customer-dg to { OBJECT_INSPECT, OBJECT_READ } in tenancy fams-tenancy where any { target.bucket.name = 'automations', target.bucket.name = 'patches'}
テナンシ管理者は、サービスの中断を回避するために、"fams-service-dg"、"fams-customer-dg"動的グループおよび"fams-policy" IAMポリシーが削除されていないことを確認する必要があります。