📔
グループプッシュの画面構成と機能
この記事では、グループプッシュ画面の各タブの見方・設定項目について説明します。
グループプッシュタブの構成
[業務アセット]の編集メニューにある[グループプッシュ]は、接続先サービスのグループ種別ごとのサブタブ（例：Entra IDの場合「Microsoft 365 グループ」「セキュリティグループ」）で構成され、各グループ種別の中に、さらに次のサブタブがあります。
| サブタブ | 内容 |
|---|---|
| 連携対象グループ | グループプッシュの連携対象になっているグループの一覧です。グループ名や連携ステータスで絞り込みができます |
| グループ連携条件 | どのグループを連携対象とするかの条件を設定します |
| メンバー割当条件 | 連携対象グループへのメンバー割当の条件を設定します |
| 同期する項目 | グループの属性について、YESODから接続先サービスに同期する項目を設定します |
注意
グループ種別の名称（「Microsoft 365 グループ」「セキュリティグループ」など）は接続先サービス固有の呼び方です。他のコネクタでは異なる名称・グループ種別数になります。
グループ連携条件
グループ連携条件タブでは、設定済みの条件が一覧で表示されます。
| 列 | 内容 |
|---|---|
| グループ連携条件名 | 条件に付けた名称です。名称を設定していない場合は「-」と表示されます |
| 連携条件 | 条件の指定方法です（例：「直接選択（配下を含む）」）。配下のグループも合わせて対象にするかどうかも、ここに表示されます |
| 連携対象 | 連携条件で指定されているグループです。直接指定の場合は選択したグループ名、属性条件の場合はその条件内容が表示されます |
| ステータス | 条件が有効か無効かを表示します |
グループ連携条件を追加
条件は「グループ連携条件を追加」から新規に追加でき、次の2つの方法のいずれかで指定できます。
| 方法 | 内容 |
|---|---|
| グループを直接指定 | 連携したいグループをYESOD上のグループから直接選択します。配下のグループも含めるかどうかを選択できます |
| 条件からグループを抽出する | グループの属性（名称など）が、次のいずれかの条件を満たす場合に連携対象とします：「と等しい」「と等しくない」「から始まる」「で終わる」「が空白である」「が空白でない」 |
補足
条件は業務アセットごとに複数追加でき、複数の条件を追加した場合はOR条件（いずれか1つでも満たせば対象）で判定されます。
ステータス
条件ごとに、有効・無効の状態を切り替えられます。新規に追加した条件は無効の状態で作成され、有効化することではじめて連携が開始されます。
| 状態 | 動作 |
|---|---|
| 有効 | 条件を満たすグループが連携対象としてリストアップされ、グループの作成・削除タスクが生成されます。属性の同期も行われます |
| 無効 | 条件を満たすグループがあってもタスクは生成されず、属性の同期も行われません。条件の変更・削除をしても何も起こりません |
注意
有効な条件を「無効化」または「削除」すると、いずれの場合も、それまでその条件によって連携対象となっていたグループについて削除タスクが生成されます（他の有効な条件でも引き続き連携対象になっている場合を除く）。連携済みのグループを条件から外す際は、意図しないグループ削除が発生しないかご注意ください。
メンバー割当条件
連携対象グループへのメンバーの割当範囲を設定するタブです。次の3つの設定があります。
ポイント
以下の設定項目名・選択肢の文言は、社内仕様をもとに記載しています。実際の画面表記と差異がないか、実画面確認後にあらためて更新予定です。
所属による割り当て
メンバーが所属しているグループの、さらに上位のグループにも割当を反映するかどうかの設定です。連携済みグループごとに、次の2つから選択します。
| 設定値 | 内容 |
|---|---|
| 所属グループすべて（デフォルト） | 所属の起点となるグループと、その親グループすべてに割り当てる |
| 親グループを対象外とする | 親グループには割り当てず、所属の起点となるグループだけに割り当てる |
関与度合い（主務・兼務）
組織に対する割当の対象範囲を設定します。メンバーが複数の組織に所属している場合、関与度合が最も高い組織を「主務」、それ以外で関与度合が設定されている組織を「兼務」として扱います。連携済みグループごとに、次の3つから選択します。
| 設定値 | 内容 |
|---|---|
| すべての組織（デフォルト） | 関与度合いの設定有無に関わらず、すべての組織に割り当てる |
| 主務の組織のみ | メンバーの関与度合いが最も高い組織のみに割り当てる |
| 主務+兼務の組織 | メンバーの関与度合いが設定されている組織のみに割り当てる |
ポイント
本設定は組織にのみ適用され、プロジェクトなど組織以外のグループには影響しません。
配下グループへの割り当て
連携対象グループに直接所属するメンバーを、YESOD上では所属していない配下のグループにも展開して、接続先サービス側の割当を追加で付与できる設定です。連携済みグループごとに、次の3つから選択します。
| 設定値 | 展開される対象 |
|---|---|
| 割り当てない（デフォルト） | 配下グループへの割り当ては行わない |
| すべてのメンバー | 全メンバーを所属の起点となるグループのすべての配下グループにも割り当てる |
| 役職で指定 | 選択した役職を持つメンバーのみ、所属の起点となるグループのすべての配下グループにも割り当てる |
注意
展開の対象になるのは、連携対象グループの配下のうち、連携対象グループが途切れず連続している範囲のみです。連携対象でないグループを挟んだ先のグループには割当が伝播しません。また、展開によって付与される割当は追加のみで、実際の所属による割当を上書きすることはありません。
同期する項目
YESOD上に登録されているグループの属性の値を、接続先サービス側のグループ属性に同期させるための設定です。グループの種別（組織・会社・事業所・プロジェクト・動的グループ）ごとに設定でき、すべての種別について設定する必要はありません。
| 列 | 内容 |
|---|---|
| グループ種別 | 会社・事業所・組織・プロジェクト・動的グループのうち、どのグループ種別に対する設定かを示します |
| Key | 接続先サービス側の属性名です（例：cn、groupType、sAMAccountName、parentDnなど） |
| 同期する項目 | Keyに対して同期する値です。YESOD側のグループ属性を属性式（例：group.groupNameLocal）で指定するほか、"GlobalSecurityGroup"のような固定の文字列値や、'OU=demoGroup,DC=exam,DC=internal'のような固定のDN文字列を指定することもできます |