サービスグループ一覧（CSV形式）
グループのサービスIDを設定する CSVフォーマットについて解説します。この CSVを利用すると、連携先のサービスプロバイダーと CloudGate UNO のグループIDを紐づけ、プロビジョニング連携を行うことができます。これにより、グループの更新内容が連携先サービスへ自動で同期されます。
- 現在のところ、グループのプロビジョニングは、SCIMを除く、Google Workspace、Microsoft 365、cybozu.com、Boxへのプロビジョニングにのみ対応しています。
- Microsoft 365のグループタイプには、すべて「セキュリティグループ」が適用されます。
- Google Workspaceで管理されているグループの投稿権限設定や公開設定などが、CSVファイルの一括処理（グループIDの登録や削除、既存IDとの紐付け）によって変更されることはありません。
- グループ一覧 ：グループの追加や削除、名称変更ができます。メンバー情報などは含みません。
- サービスグループ一覧 ：サービスプロバイダーにグループをプロビジョニング連携している場合に使用します。サービスプロバイダー側のグループIDを登録、または削除できます。
- グループメンバー一覧 ：既存のグループへメンバーを追加、または削除できます。
ダウンロード時と一括処理のためのアップロード時で CSVフォーマットは共通です。
ここでは、サービスグループ一覧の CSVファイルのフォーマットについて解説します。
CSVファイル作成時の注意点
-
文字コードは「UTF-8」形式、「BOMなし」に設定し作成してください。
-
ファイルの１行目に CSV項目を記載し、2行目以降に値を記載します。１行で１グループ分のデータが設定できますので、複数のグループを設定する場合は１グループ分ずつ複数行に分けて記載してください。
-
CSV項目や値はカンマ区切りで作成してください。カンマ以外の区切り文字はサポートしていません。
-
CSV項目は大文字・小文字を区別しません。
-
データの操作（作成・更新・削除）により必須項目は異なります。必須項目はもれなく含めてください。
サービスグループ情報の CSVファイル作成例
- 1行目に CSV項目、2行目以降に各項目の値を記載した作成例です。
- Google Workspaceと Microsoft 365の場合を例にしています。
| operation | serviceDisplayName | groupId | serviceGroupId |
|---|---|---|---|
| CREATE | Google Workspace | group1@example.com | group1@google.example.com |
| CREATE | Microsoft 365 | group2@example.com | group2@microsoft.example.com |
テキストエディターでは以下のように確認できます。
| "operation","serviceDisplayName","groupId","serviceGroupId" "CREATE","Google Workspace","group1@example.com","group1@google.example.com" "CREATE","Microsoft 365","group2@example.com","group2@microsoft.example.com" |
サービスグループ情報の項目一覧
更新操作はありません。
| CSV項目 | 画面表示項目 | 入力値 | 必須 | |
|---|---|---|---|---|
| 登録 | 削除 | |||
| operation | - | グループを 作成する場合は"CREATE" 削除する場合は"DELETE"と記載します。 大文字・小文字は区別されません。 空欄にした場合は、処理は行われません。 |
● | ● |
| serviceDisplayName | サービス表示名 | 既存のサービス名（表示名）を記載します。 この値は、 サービスプロバイダー設定 で設定されている「表示名」です。 必須項目ですので空欄にすることはできません。 |
● | ● |
| groupId | グループID | CloudGate UNO の既存のグループIDを記載します。 必須項目ですので空欄にすることはできません。 |
● | ● |
| serviceGroupId | サービス側のグループID | サービスプロバイダーに設定されている、または設定するグループIDを記載します。
CAUTION:
この値は一度登録すると、変更できません。
Google Workspaceの場合は、半角記号- _ . ' @を含む半角英数字255文字以内で記載可能です。空欄はエラーとなります。 Microsoft 365の場合は、新規作成時は空欄にします。既存グループと紐づける場合、または削除する場合は、設定済みのグループID（uuid）を記載します。 cybozu.comの場合は、既存のグループID（uuid）を記載します。半角全角128文字以内で記載可能です。空欄はエラーとなります。 Boxの場合は、半角全角255文字以内で記載可能です。空欄はエラーとなります。 |
● | ● |
