第8章パーミッションポリシーリファレンス

Red Hat Developer Hub のパーミッションポリシーは、リソースまたは機能へのアクセスを管理する一連のルールです。これらのポリシーは、ユーザーのロールに基づいてユーザーに付与される認可レベルを示します。パーミッションポリシーは、特定の環境内でセキュリティーと機密性を維持するために実装されます。

Developer Hub では、次の種類のパーミッションを定義できます。

リソースタイプ
basic

2 つのパーミッションタイプの違いは、パーミッションに定義されたリソースタイプが含まれているかどうかによって決まります。

リソースタイプパーミッションは、次の例に示すように、関連するリソースタイプまたはパーミッション名のいずれかを使用して定義できます。

リソースタイプパーミッションの定義の例

p, role:default/myrole, catalog.entity.read, read, allow
g, user:default/myuser, role:default/myrole

p, role:default/another-role, catalog-entity, read, allow
g, user:default/another-user, role:default/another-role

基本的なパーミッションは、次の例に示すように、パーミッション名を使用して Developer Hub で定義できます。

基本的なパーミッションの定義の例

p, role:default/myrole, catalog.entity.create, create, allow
g, user:default/myuser, role:default/myrole

Developer Hub は次のパーミッションポリシーをサポートしています。

Catalog パーミッション: .Catalog パーミッション

Expand

名前	リソースタイプ	ポリシー	説明
`catalog.entity.read`	`catalog-entity`	`read`	ユーザーまたはロールがカタログから読み取ることを許可する
`catalog.entity.create`		`create`	ユーザーまたはロールがカタログエンティティーを作成することを許可する。これには、カタログ内の既存のコンポーネントの登録も含まれます。
`catalog.entity.refresh`	`catalog-entity`	`update`	ユーザーまたはロールがカタログから単一または複数のエンティティーを更新することを許可する。
`catalog.entity.delete`	`catalog-entity`	`delete`	ユーザーまたはロールがカタログから単一または複数のエンティティーを削除することを許可する。
`catalog.location.read`		`read`	ユーザーまたはロールがカタログから単一または複数の場所を読み取ることを許可する
`catalog.location.create`		`create`	ユーザーまたはロールがカタログ内に場所を作成することを許可する
`catalog.location.delete`		`delete`	ユーザーまたはロールがカタログから場所を削除することを許可する

一括インポートパーミッション: .一括インポートパーミッション

Expand

名前	リソースタイプ	ポリシー	説明
`bulk.import`	`bulk-import`	`use`	すべての GitHub インテグレーションでアクセス可能なすべてのリポジトリーと組織のリスト表示や、インポート要求の管理など、一括インポートエンドポイントにユーザーがアクセスできるようにする

Scaffolder パーミッション: .Scaffolder パーミッション

Expand

名前	リソースタイプ	ポリシー	説明
`scaffolder.action.execute`	`scaffolder-action`	`use`	テンプレートからのアクションの実行を許可する
`scaffolder.template.parameter.read`	`scaffolder-template`	`read`	ユーザーまたはロールがテンプレートから 1 つまたは複数のパラメーターを読み取ることを許可する
`scaffolder.template.step.read`	`scaffolder-template`	`read`	ユーザーまたはロールがテンプレートから 1 つまたは複数のステップを読み取ることを許可する
`scaffolder.task.create`		`create`	ユーザーまたはロールが新しいスキャフォールダータスクを作成するソフトウェアテンプレートをトリガーすることを許可する
`scaffolder.task.cancel`		`use`	ユーザーまたはロールが現在実行中のスキャフォールダータスクをキャンセルすることを許可する
`scaffolder.task.read`		`read`	ユーザーまたはロールがすべてのスキャフォールダータスクとそれに関連するイベントおよびログを読み取ることを許可する
`scaffolder.template.management`		`use`	ユーザーまたはロールが、フロントエンドテンプレート管理機能 (テンプレート、フォーム、およびカスタムフィールドの編集、プレビュー、および試用など) にアクセスすることを許可する

RBAC パーミッション: .RBAC パーミッション

Expand

名前	リソースタイプ	ポリシー	説明
`policy.entity.read`	`policy-entity`	`read`	ユーザーまたはロールがパーミッションポリシーとロールを読み取ることを許可する
`policy.entity.create`		`create`	ユーザーまたはロールが単一または複数のパーミッションポリシーとロールを作成することを許可する
`policy.entity.update`	`policy-entity`	`update`	ユーザーまたはロールが単一または複数のパーミッションポリシーとロールを更新することを許可する
`policy.entity.delete`	`policy-entity`	`delete`	ユーザーまたはロールが単一または複数のパーミッションポリシーとロールを削除することを許可する

Kubernetes パーミッション: .Kubernetes パーミッション

Expand

名前	ポリシー	説明
`kubernetes.clusters.read`	`read`	ユーザーが `/clusters` パスの下にある Kubernetes クラスターの詳細を読み取ることを許可する
`kubernetes.resources.read`	`read`	ユーザーが `/services/:serviceId` および `/resources` にある Kubernetes リソースに関する情報を読み取ることを許可する
`kubernetes.proxy`	`use`	ユーザーまたはロールがプロキシーエンドポイントにアクセスすることを許可する

OCM パーミッション: 基本的な OCM パーミッションはクラスタービューへのアクセスのみを制限しますが、リソースビュー内の Kubernetes クラスターへのアクセスを妨げることはありません。より効果的なパーミッションを得るには、条件付きポリシーを適用して、kubernetes-cluster タイプのカタログエンティティーへのアクセスを制限することを検討してください。アクセス制限は、ロールに付与されたパーミッションのセットに依存します。たとえば、ロールに完全なパーミッション (read、update、delete) がある場合は、permissionMapping フィールドにそのすべてのパーミッションを指定する必要があります。

permissionMapping 定義の例

result: CONDITIONAL
roleEntityRef: 'role:default/<YOUR_ROLE>'
pluginId: catalog
resourceType: catalog-entity
permissionMapping:
  - read
  - update
  - delete
conditions:
  not:
    rule: HAS_SPEC
    resourceType: catalog-entity
    params:
      key: type
      value: kubernetes-cluster

Expand

名前	リソースタイプ	ポリシー	説明
`ocm.entity.read`		`read`	ユーザーまたはロールが OCM プラグインから読み取ることを許可する
`ocm.cluster.read`		`read`	ユーザーまたはロールが OCM プラグイン内のクラスター情報を読み取ることを許可する

トポロジーパーミッション: .Topology パーミッション

Expand

名前	ポリシー	説明
`kubernetes.clusters.read`	`read`	ユーザーが `/clusters` パスの下にある Kubernetes クラスターの詳細を読み取ることを許可する
`kubernetes.resources.read`	`read`	ユーザーが `/services/:serviceId` および `/resources` にある Kubernetes リソースに関する情報を読み取ることを許可する
`kubernetes.proxy`	`use`	ユーザーまたはロールがプロキシーエンドポイントにアクセスすることを許可し、RHDH 内の Pod ログとイベントを読み取ることを許可する

Tekton パーミッション: .Tekton パーミッション

Expand

名前	ポリシー	説明
`kubernetes.clusters.read`	`read`	ユーザーが `/clusters` パスの下にある Kubernetes クラスターの詳細を読み取ることを許可する
`kubernetes.resources.read`	`read`	ユーザーが `/services/:serviceId` および `/resources` にある Kubernetes リソースに関する情報を読み取ることを許可する
`kubernetes.proxy`	`use`	ユーザーまたはロールがプロキシーエンドポイントにアクセスすることを許可し、RHDH 内の Pod ログとイベントを読み取ることを許可する

ArgoCD パーミッション: .ArgoCD パーミッション

Expand

名前	リソースタイプ	ポリシー	説明
`argocd.view.read`		`read`	ユーザーが ArgoCD プラグインから読み取ることを許可する

Quay パーミッション: .Quay パーミッション

Expand

名前	リソースタイプ	ポリシー	説明
`quay.view.read`		`read`	ユーザーが Quay プラグインから読み取ることを許可する

第8章パーミッションポリシーリファレンス

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第8章 パーミッションポリシーリファレンス

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第8章パーミッションポリシーリファレンス