Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

20.7. ロール操作

レルムロールの作成

roles エンドポイントを使用してレルムロールを作成します。 

$ kcadm.sh create roles -r demorealm -s name=user -s 'description=Regular user with limited set of permissions'
Copy to Clipboard Toggle word wrap

クライアントロールの作成

  1. 最初にクライアントを特定し、get コマンドを使用してクライアントロールの作成時に利用可能なクライアントを一覧表示します。 

    $ kcadm.sh get clients -r demorealm --fields id,clientId
    Copy to Clipboard Toggle word wrap

  2. clientId 属性を使用して、clients/ID/roles などのエンドポイント URI を構築して新規ロールを作成します。

    以下に例を示します。 

    $ kcadm.sh create clients/a95b6af3-0bdc-4878-ae2e-6d61a4eca9a0/roles -r demorealm -s name=editor -s 'description=Editor can edit, and publish any article'
    Copy to Clipboard Toggle word wrap

レルムロールの一覧表示

roles エンドポイントで get コマンドを使用して、既存のレルムロールを一覧表示します。 

$ kcadm.sh get roles -r demorealm
Copy to Clipboard Toggle word wrap

get-roles コマンドも使用できます。 

$ kcadm.sh get-roles -r demorealm
Copy to Clipboard Toggle word wrap

クライアントロールの一覧表示

レルムおよびクライアントロールの一覧表示を簡素化するための専用の get-roles コマンドがあります。get コマンドの拡張機能であり、ロールを一覧表示するための追加のセマンティクスと同じように動作します。

get-roles コマンドを使用して clientId 属性 (--cclientid オプションを使用) または id (--cid オプションを使用) のいずれかを渡して、クライアントロールをリストするクライアントを特定します。

以下に例を示します。 

$ kcadm.sh get-roles -r demorealm --cclientid realm-management
Copy to Clipboard Toggle word wrap

特定のレルムロールの取得

get コマンドおよびロール 名 を使用して、特定のレルムロール (roles/ROLE_NAME) のエンドポイント URI を作成します。user は、既存ロールの名前に置き換えます。

以下に例を示します。 

$ kcadm.sh get roles/user -r demorealm
Copy to Clipboard Toggle word wrap

特定の get-roles コマンドを使用して、ロール名 (--rolename オプションを使用) または ID (--roleid オプションを使用)を渡すこともできます。

以下に例を示します。 

$ kcadm.sh get-roles -r demorealm --rolename user
Copy to Clipboard Toggle word wrap

特定のクライアントロールの取得

専用の get-roles コマンドを使用して clientId 属性 (--cclientid オプションを使用) または ID (--cid オプションを使用) のいずれかを渡してクライアントを特定し、ロール名 (--rolename オプションを使用) または ID (--roleid 経由) のいずれかを渡します。

以下に例を示します。 

$ kcadm.sh get-roles -r demorealm --cclientid realm-management --rolename manage-clients
Copy to Clipboard Toggle word wrap

レルムロールの更新

特定のレルムロールを取得するために使用した同じエンドポイント URI で update コマンドを使用します。

以下に例を示します。 

$ kcadm.sh update roles/user -r demorealm -s 'description=Role representing a regular user'
Copy to Clipboard Toggle word wrap

クライアントロールの更新

update コマンドを、特定のクライアントロールの取得に使用したのと同じエンドポイント URI で使用します。

以下に例を示します。 

$ kcadm.sh update clients/a95b6af3-0bdc-4878-ae2e-6d61a4eca9a0/roles/editor -r demorealm -s 'description=User that can edit, and publish articles'
Copy to Clipboard Toggle word wrap

レルムロールの削除

特定のレルムロールを取得するために使用した同じエンドポイント URI で delete コマンドを使用します。

以下に例を示します。 

$ kcadm.sh delete roles/user -r demorealm
Copy to Clipboard Toggle word wrap

クライアントロールの削除

特定のクライアントロールを取得するために使用したエンドポイント URI で delete コマンドを使用します。

以下に例を示します。 

$ kcadm.sh delete clients/a95b6af3-0bdc-4878-ae2e-6d61a4eca9a0/roles/editor -r demorealm
Copy to Clipboard Toggle word wrap

複合ロールに割り当てられている、利用可能、有効なレルムロールの一覧表示

複合ロールに割り当てられ、利用可能な、有効なレルムロールを一覧表示するには、専用の get-roles コマンドを使用します。

  1. 複合ロールに 割り当てられた レルムロールを一覧表示するには、(--rname オプション) または ID (--rid オプション) のいずれかで、ターゲットの複号ロールを指定できます。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --rname testrole
    Copy to Clipboard Toggle word wrap

  2. 有効な レルムロールの一覧を表示するには、追加の --effective オプションを使用します。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --rname testrole --effective
    Copy to Clipboard Toggle word wrap

  3. --available オプションを使用して、複合ロールに追加できるレルムロールを一覧表示します。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --rname testrole --available
    Copy to Clipboard Toggle word wrap

複合ロールに割り当てられている、利用可能、有効なクライアントロールの一覧表示

複合ロールに割り当てられ、利用可能な、有効なクライアントロールを一覧表示するには、専用の get-roles コマンドを使用します。

  1. 複合ロールに 割り当てられた クライアントロールを一覧表示するには、名前 (--rname オプション) または ID (--rid オプション) のいずれかでターゲット複号ロールを指定し、clientId 属性 (--cclientid オプションを使用) または ID (--cid オプションを使用) のいずれかでターゲット複合ロールを指定できます。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --rname testrole --cclientid realm-management
    Copy to Clipboard Toggle word wrap

  2. 有効な レルムロールの一覧を表示するには、追加の --effective オプションを使用します。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --rname testrole --cclientid realm-management --effective
    Copy to Clipboard Toggle word wrap

  3. --available オプションを使用して、ターゲット複合ロールに追加できるレルムロールを一覧表示します。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --rname testrole --cclientid realm-management --available
    Copy to Clipboard Toggle word wrap

レルムロールの複合ロールへの追加

レルムロールおよびクライアントロールの追加に使用できる専用の add-roles コマンドがあります。

以下の例では、user ロールを複合ロール testrole に追加します。 

$ kcadm.sh add-roles --rname testrole --rolename user -r demorealm
Copy to Clipboard Toggle word wrap

複合ロールからのレルムロールの削除

レルムロールおよびクライアントロールの削除に使用できる専用の remove-roles コマンドがあります。

以下の例では、ターゲット複合ロール testrole から user ロールを削除します。 

$ kcadm.sh remove-roles --rname testrole --rolename user -r demorealm
Copy to Clipboard Toggle word wrap

クライアントロールのレルムロールへの追加

レルムロールおよびクライアントロールの追加に使用できる専用の add-roles コマンドを使用します。

以下の例では、クライアント realm-management に定義したロールを追加します。create-client ロールおよび view-users ロールに定義されたロールを testrole 複合ロールに追加します。 

$ kcadm.sh add-roles -r demorealm --rname testrole --cclientid realm-management --rolename create-client --rolename view-users
Copy to Clipboard Toggle word wrap

クライアントロールへのクライアントロールの追加

  1. get-roles コマンドを使用して、複合クライアントロールの ID を確認します。

    以下に例を示します。 

    $ kcadm.sh get-roles -r demorealm --cclientid test-client --rolename operations
    Copy to Clipboard Toggle word wrap
  2. test-client の clientId 属性と、support と呼ばれるクライアントロール、および operations と呼ばれる別のクライアントロールがあるクライアントがあります。これは、複合ロールになり、ID は「fc400897-ef6a-4e8c-872b-1581b7fa8a71」となります。

  3. 以下の例を使用して、別のロールを複合ロールに追加します。 

    $ kcadm.sh add-roles -r demorealm --cclientid test-client --rid fc400897-ef6a-4e8c-872b-1581b7fa8a71 --rolename support
    Copy to Clipboard Toggle word wrap

  4. get-roles --all コマンドを使用して、複合ロールのロールを一覧表示します。

    以下に例を示します。 

    $ kcadm.sh get-roles --rid fc400897-ef6a-4e8c-872b-1581b7fa8a71 --all
    Copy to Clipboard Toggle word wrap

複合ロールからのクライアントロールの削除

専用の remove-roles コマンドを使用して、複合ロールからクライアントロールを削除します。

以下の例を使用して、クライアントの realm-management で定義された 2 つのロールを削除します (create-client ロールと view-users ロール) を testrole 複合ロールから削除します。 

$ kcadm.sh remove-roles -r demorealm --rname testrole --cclientid realm-management --rolename create-client --rolename view-users
Copy to Clipboard Toggle word wrap

クライアントロールのグループへの追加

レルムロールおよびクライアントロールの追加に使用できる専用の add-roles コマンドを使用します。

以下の例では、クライアント realm-management に定義したロールを追加します。create-client ロールおよび view-users ロールを Group グループ (--gname オプション) に追加します。代わりに、グループを ID で指定できます (--gid オプションを使用)。

グループに対して実行できる操作の詳細は、「グループ操作」を参照してください。 

$ kcadm.sh add-roles -r demorealm --gname Group --cclientid realm-management --rolename create-client --rolename view-users
Copy to Clipboard Toggle word wrap

グループからのクライアントロールの削除

専用の remove-roles コマンドを使用して、クライアントロールをグループから削除します。

以下の例を使用して、クライアントの realm-management で定義された 2 つのロールを削除します (create-client ロールと view-users ロールを Group グループから削除します)。

グループに対して実行できる操作の詳細は、「グループ操作」を参照してください。 

$ kcadm.sh remove-roles -r demorealm --gname Group --cclientid realm-management --rolename create-client --rolename view-users
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

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

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat