7.7. グループ

Red Hat build of Keycloak のグループは、各ユーザーの共通の属性セットとロールマッピングを管理します。ユーザーは任意の数のグループのメンバーとなり、各グループに割り当てられた属性およびロールマッピングを継承できます。

グループを管理するには、メニューで Groups をクリックします。

グループは階層です。グループには複数のサブグループを指定できますが、グループには親を 1 つだけ指定できます。サブグループは、親から属性とロールマッピングを継承します。ユーザーは、親から属性とロールマッピングも継承します。

親グループと子グループがあり、子グループにのみ所属するユーザーがある場合は、子グループのユーザーは、親グループと子グループの両方の属性とロールマッピングを継承します。

グループの階層は、グループパスを使用して表されることがあります。パスは、特定のグループの階層を表す、上から下への名前の完全なリストであり、スラッシュ / で区切られています (ファイルシステム内のファイルに似ています)。たとえば、パスが /top/level1/level2 の場合、top は最上位グループで level1 の親であり、level1 は level2 の親であることを意味します。このパスは、level2 グループの階層を明確に表します。

歴史的な理由により、Red Hat build of Keycloak では、グループ名自体のスラッシュはエスケープされません。したがって、top の下の level1/group という名前のグループは、/top/level1/group のパスを使用しますが、これは誤解を招きます。Red Hat build of Keycloak は、オプション --spi-group-jpa-escape-slashes-in-group-path を true に設定して起動することができ、その後、名前内のスラッシュは ~ 文字でエスケープされます。エスケープ文字は、スラッシュが名前の一部であり、階層的な意味を持たないことを示します。前のパスの例は、エスケープすると /top/level1~/group になります。

bin/kc.[sh|bat] start --spi-group-jpa-escape-slashes-in-group-path=true

bin/kc.[sh|bat] start --spi-group-jpa-escape-slashes-in-group-path=true

以下の例には、トップレベル セールス グループと子の 北アメリカ のサブグループが含まれます。

グループを追加するには、以下を実行します。

定義する属性およびロールマッピングは、グループのメンバーであるグループおよびユーザーによって継承されます。

ユーザーをグループに追加します。

ユーザーからグループを削除するには、以下を実行します。

この例では、ユーザー jimlincoln は North America グループにあります。グループの Members タブの下に jimlincoln が表示されます。