ユーザー一覧(CSV形式)
ユーザーアカウントの追加・変更・削除を行うための CSVファイルについて解説します。
ダウンロードされる CSVファイルも同様の形式で保存されます。
CSVファイル作成時の注意点
-
文字コードは「UTF-8」形式、「BOMなし」に設定し作成してください。
-
ファイルの1行目に CSV項目を記載し、2行目以降に値を記載します。1行で1アカウント分のデータが設定できますので、複数のアカウントを設定する場合は1アカウント分ずつ複数行に分けて記載してください。
-
CSV項目や値はカンマ区切りで作成してください。カンマ以外の区切り文字はサポートしていません。
-
CSV項目は大文字・小文字を区別しません。
-
データの操作(作成・更新・削除)により必須項目は異なります。必須項目はもれなく含めてください。
ユーザー情報の CSVファイル作成例
- 1行目に CSV項目、2行目以降に各項目の値を記載した CSVファイルの作成例です。
operation | unitPath | lastName | firstName | displayName | displayNameKana | userName | ・・・ |
---|---|---|---|---|---|---|---|
CREATE | example.com | 佐々木 | 浩一 | 佐々木浩一 | ささきこういち | sasaki | ・・・ |
CREATE | example.com | 田所 | 麻衣子 | 田所麻衣子 | たどころまいこ | tadokoro | ・・・ |
UPDATE | example.com | John | Smith | John Smith | johnsmith | ・・・ |
テキストエディターでは以下のように確認できます。
"operation","unitPath","lastName","firstName","displayName","displayNameKana","userName",・・・ "CREATE","example.com","佐々木","浩一","佐々木浩一","ささきこういち","sasaki",・・・ "CREATE","example.com","田所","麻衣子","田所麻衣子","たどころまいこ","tadokoro",・・・ "UPDATE","example.com","John","Smith","JohnSmith","","johnsmith",・・・ |
ユーザー情報の項目一覧
- パスワード有効期限・兼任情報・ロール・CloudGate UNO Administrator Site の利用許可・認証器の登録や登録解除は、対象外となります。
- ユーザーアカウントを作成する場合は、事前に組織や役職が作成されている必要があります。存在しない組織・役職を指定するとエラーとなります。
CSV項目 | 画面表示項目 | 入力値 | 必須 | ||
---|---|---|---|---|---|
作成 | 更新 | 削除 | |||
operation | - | データを 作成する場合は"CREATE" 更新する場合は"UPDATE" 削除する場合は"DELETE"と記載します。 大文字・小文字は区別されません。空欄にした場合は、処理は行われません。 |
● | ● | ● |
unitPath | 部署 | 組織またはレルムを記載します。必須項目ですので空欄にすることはできません。 組織の場合は、レルムを先頭にして上の階層から順に半角セミコロン(;)で区切り記載します。 例:レルム;組織名1;組織名2
CAUTION:
存在しない組織を指定するとエラーとなります。
|
● | ● | ● |
lastName | 姓 | 姓を記載します。 半角記号< > =を除く、半角全角60文字以内で記載します。 作成・更新の場合、必須項目となりますので空欄にすることはできません。
Note: Google Workspaceや Microsoft 365とプロビジョニング連携をした場合に対象となります。
|
● | ● | |
firstName | 名 | 名を記載します。 半角記号< > =を除く、半角全角60文字以内で記載します。 作成・更新の場合、必須項目となりますので空欄にすることはできません。
Note: Google Workspaceや Microsoft 365とプロビジョニング連携をした場合に対象となります。
|
● | ● | |
displayName | 表示名 | 表示名を記載します。 半角全角255文字以内で記載します。 作成・更新の場合、必須項目となりますので空欄にすることはできません。 |
● | ● | |
displayNameKana | 表示名(ふりがな) | 表示名(ふりがな)を記載します。 半角全角255文字以内で記載します。 |
|||
userName | ユーザーID(@マーク以降を除く) | ユーザーIDの@マークより前を記載します。 作成の場合のみ、半角英小文字、半角数字、半角記号- _ . ' 64文字以内で記載可能です。 一度作成されたユーザーIDは変更できませんので、更新・削除の場合はすでに登録されているユーザーID(@以降を除く)を記載します。 必須項目ですので空欄にすることはできません。
CAUTION:
|
● | ● | ● |
password | パスワード | パスワードを記載します。 作成の場合は、必須項目となりますので空欄にすることはできません。 任意の文字列を半角英数字、半角記号100文字以内で記載します。 更新・削除の場合は空欄にすると、パスワードの変更は行われません。
Note: この値を記載していると、Google Workspaceの連携設定でパスワードを同期する設定にしている場合に Google Workspace側のパスワードを書き換える処理が行われますのでご注意ください。
|
● | ||
passwordChangeRequired | 次回サインオン時にパスワード変更要求を行う | 変更要求をする場合は"TRUE" 変更要求をしない場合は"FALSE"を記載します。 大文字・小文字は区別されません。 |
|||
positionName | 役職 | 役職を記載します。 更新の場合に空欄にすると、設定済みの役職は未設定の状態になります。 |
|||
company | 会社名 | 会社名を記載します。 半角全角255文字以内で記載します。 |
|||
mailAddress | メールアドレス | メールアドレスを記載します。 半角英小文字、数字、+などの記号が含まれるメールアドレス形式で記載できます。@マーク前の部分のみ半角英大文字も入力可能です。 |
|||
phoneNumber | 電話番号 | 電話番号を記載します。 半角数字、半角スペース、半角記号- + 20文字以内で記載します。 |
|||
extensionNumber | 内線番号 | 内線番号を記載します。 半角数字、半角スペース、半角記号- + 20文字以内で記載します。 |
|||
mobilePhoneNumber | 携帯番号 | 携帯番号を記載します。 半角数字、半角スペース、半角記号- + 20文字以内で記載します。 |
|||
employeeCode | 社員コード | 社員コードを記載します。 半角英数字20文字以内で記載します。 |
|||
departmentCode | 部門コード | 部門コードを記載します。 半角英数字20文字以内で記載します。 |
|||
managementCode | 管理コード | 管理コードを記載します。 半角英数字20文字以内で記載します。 |
|||
passwordRecoveryMailAddress | パスワードリカバリー用のメールアドレス | パスワードリカバリー用のメールアドレスを記載します。 半角英小文字、数字、+などの記号が含まれるメールアドレス形式で記載できます。@マーク前の部分のみ半角英大文字も入力可能です。 |
|||
passwordRecoveryRegistrationStatus | パスワードリカバリー設定の状態 |
この値を変更することはできませんので、空欄または現在の値を記載します。 ダウンロード時はパスワードリカバリー機能で使用されるメールアドレスの設定状態が確認できます。 「VERIFIED」のみパスワードリカバリー機能が利用できる状態です。
|
|||
notes | 備考 | 備考を記載します。 半角英数字1,000文字以内で記載します。 |
|||
securityProfileName | セキュリティプロファイル | セキュリティプロファイル名を記載します。 作成の場合に空欄にすると「デフォルト」プロファイルが適用されます。 更新の場合に空欄にすると設定済みのプロファイルのまま、変更はされません。 |
|||
cgAuthenticator | CloudGate Authenticator | この値を変更することはできませんので、空欄または現在の値を記載します。
ダウンロード時は
CloudGate Authenticator の登録状況を確認できます。INVALIDが記載されている場合はアプリ側からアカウントが削除され利用できない状態です。
|
|||
otpActive | ワンタイムパスワード | この値を変更することはできませんので、空欄または現在の値を記載します。 ダウンロード時はワンタイムパスワード認証器の登録状況が TRUE(登録済み)または FALSE(未登録)で確認できます。 |
|||
カスタムフィールド
|
|||||
userIdReadOnly | ユーザーID | この値は変更できませんのでアップロード時は空欄で構いません。 ダウンロード時に@マーク以降も含むユーザーIDを確認できます。手動でのアカウント管理や『 サービスアカウント一覧(CSV形式) 』とマージする場合などに利用できます。 |
|||
lastAccessTime | 最終サインオン日時 | この値は変更できませんのでアップロード時は空欄で構いません。 ダウンロード時にユーザーがサインオンした最終日時を確認できます。 |
カスタムフィールドの記載方法
カスタムフィールドは CloudGate UNO Administrator Site (管理者サイト)の画面上で登録したカスタムフィールドの値に対してのみ追加・変更・削除が可能です。 カスタムフィールドのフィールドIDやフィールド名を追加・変更・削除するには画面上での操作が必要で、 管理者サイトの左メニューにある
で操作することができます。- 値を変更する場合は、半角全角文字、半角記号-_.()の5文字を含む255文字以内で記載します。
- MULTIPLEの場合は、複数の入力値を,(カンマ)区切りで記載し、,(カンマ)自体を含める場合は、 ””(ダブルクォーテーション)で値を囲みます。複数の入力値の上限数は関連リンクをご参照ください。
- 値を変更をしない場合は CSVファイルの 1行目にあるフィールドIDを削除しておくか、 2行目以降の値をダウンロード時のままの値でアップロードします。 フィールドIDが記載されたまま2行目以降の値を空欄にして アップロードすると設定値は空欄で上書きされます。
フィールドID | フィールド名 | バリュータイプ |
---|---|---|
CUSTOM-SINGLE | シングルフィールド | SINGLE |
CUSTOM-MULTIPLE | マルチフィールド | MULTIPLE |
・・・,"CUSTOM-SINGLE","CUSTOM-MULTIPLE",・・・ ・・・,"No.1","No.2-1,No.2-2,No.2-3",・・・ |
↓
「シングルフィールド」には「No.1」が登録され、
「マルチフィールド」には「No.2-1」と「No.2-2」と「No.2-3」の3つの値が登録されます。
・・・,"CUSTOM-SINGLE","CUSTOM-MULTIPLE",・・・ ・・・,"No.1",""No.2-1,No.2-2,No.2-3"",・・・ |
↓
「シングルフィールド」には「No.1」が登録され、
「マルチフィールド」には「No.2-1,No.2-2,No.2-3」の1つの値が登録されます。
・・・,"CUSTOM-SINGLE","CUSTOM-MULTIPLE",・・・ ・・・,"No.1",""No.2-1,No.2-2",No.2-3",・・・ |
↓
「シングルフィールド」には「No.1」が登録され、
「マルチフィールド」には「No.2-1,No.2-2」と「No.2-3」の2つの値が登録されます。