CSVディレクトリの同期
メニューのパス: 設定 > インバウンドプロビジョニング > CSVディレクトリの同期
目次
- 概要
- 画面構成
- 設定方法 (4ステップ)
- 1ステップ : サーバー接続
- 2段階 : ユーザー設定
- 3段階 : グループ設定
- 4段階 : 同期設定
- 手動同期
- 同期結果の確認
- エラー対処
- 注意事項
概要
FTPまたはSFTPサーバーにアップロードされたCSVファイルを定期的に監視し、ユーザーおよびグループ情報をSecurity365管理センターに自動的に同期する機能です。別の外部ディレクトリサーバー（HRシステムなど）で生成されるCSVファイルを連携する際に活用します。
動作フロー:
| ステップ | 内容 |
|---|---|
| 1 | FTP/SFTPサーバーに接続 |
| 2 | 指定されたパスのCSVファイルをダウンロード |
| 3 | 以前の同期に対するファイル変更の有無確認 |
| 4 | CSVデータの変換と有効性検証 |
| 5 | 管理センターのユーザー/グループ情報の反映 |
**参考:**1つのインバウンドプロビジョニング方式のみを有効にできます。CSVディレクトリの同期を有効にすると、他の方式（SCIサーバー、Microsoft365、ローカルActive Directory）は無効になります。
**参考:**ファイルの内容が変更されていない場合、同期をスキップします。これは不必要な処理を防ぐ正常な動作です。
画面構成
設定前: CSVディレクトリ同期カードに「設定後に使用できます。」という案内が表示されます。
設定完了後: カードに次の情報が表示されます。
| 情報 | 説明 |
|---|---|
| 接続方式およびサーバー情報 | 接続方式(SFTP/FTP)、ホストアドレス、ポート、接続ID |
| 最後の同期日時および結果 | 最近の同期実行時刻と成功/失敗の有無 |
| 同期周期 | 自動同期設定時刻 |
| [修正] ボタン | 設定変更 |
| [手動同期] ボタン | 即時同期実行 |
設定方法 (4ステップ)
[ステップ1] サーバー接続
FTP/SFTPサーバー接続情報を入力します。
| 項目 | 説明 |
|---|---|
| 接続方式 (プロトコル) | FTPまたはSFTPの選択 |
| ホスト（サーバーアドレス） | サーバーアドレス (IP または ドメイン) |
| ポート | 接続ポート番号 |
| 接続ID | サーバーアカウントID |
| 接続パスワード | サーバーアカウントのパスワード |
接続方式選択基準:
| 方式 | 基本ポート | 説明 | 推奨状況 |
|---|---|---|---|
| SFTP | 22 | SSHベースの暗号化転送 | セキュリティが必要な環境 (推奨) |
| FTP | 21 | 非暗号化送信 | 内部ネットワークなどセキュリティ要件が低い環境 |
設定後**[連携テスト]**ボタンをクリックしてサーバー接続状態を確認してください。
**注意:**保存前に連携テストを必ず実行して接続を確認してください。
**参考:**パスワードは暗号化されて保存され、設定画面では平文で表示されません。
ボタン: キャンセル | 一時保存 | 次へ
[ステップ2] ユーザー設定
ユーザーCSVファイルの監視方法とデータ変換ルールを設定します。
監視経路
監視モード
| モード | 説明 |
|---|---|
| 単一ファイル | 指定したパスのファイルを監視します。 |
| ディレクトリ | 指定したパスでファイルの中で最も新しいファイルを監視します。 |
ディレクトリモード選択時 - 最新ファイル判断基準
| 基準 | 説明 |
|---|---|
| 修正日基準 | 最も最近修正されたファイルを最新のファイルと判断 |
| ファイル名基準 | ファイル名に含まれる日付を解析して最新の日付のファイルを選択する |
サポート日付フォーマット（ファイル名基準選択時）：
| フォーマット | ファイル名の例 |
|---|---|
| yyyyMMdd | users_20260101.csv |
| yyyy-MM-dd | users_2026-01-01.csv |
| yy-MM-dd | users_26-01-01.csv |
| yyMMdd | users_260101.csv |
**参考:**ファイル名が
#で 始まるファイルはコメントアウトされ、同期対象から除外されます。
パスとファイルパターン
| 項目 | 説明 | 例示 |
|---|---|---|
| 経路 | サーバー内のファイルまたはディレクトリパス | data/csv/users/ |
| ファイルパターン | 監視するファイル名パターン (ワイルドカード*サポート) | users_*.csv |
同期オプション
| 項目 | オプション | 説明 |
|---|---|---|
| CSV未含項目処理 {#csv未含項目処理} | 維持 | CSVにない既存のユーザーをそのまま維持 |
| 無効化 | CSVにない既存ユーザーを無効化処理 | |
| 検証エラー時の同期中断 | 使用 | 検証エラーが発生した場合、全体の同期を中止 |
| 使用しない | エラー レコードをスキップして残りのデータを反映 |
注意:
비활성화選択すると、CSVファイルに含まれていない既存のユーザーがすべて無効になります。ファイルの内容を必ず事前に確認してください。
CSV変換設定
CSVファイル形式とフィールドマッピングルールを設定します。
入力CSV区切り文字
| オプション | 区切り文字 |
|---|---|
| コンマ | , |
| パイプ | | |
| タブ | (タブ文字) |
フィールドマッピング方式
| 方式 | 説明 |
|---|---|
| ヘッダー基盤 | CSVの最初の行（ヘッダー）のカラム名でマッピング |
| インデックスベース | カラムの順序（0から始まる）でマッピング |
標準フィールドリスト (ユーザー)
| 標準フィールド | 必須かどうか | 説明 |
|---|---|---|
| USER_ID | 必須 | ユーザーID（メール形式推奨） |
| USER_NAME | 必須 | ユーザー名 |
| 選択 | メールアドレス | |
| GROUP_ID_LIST | 選択 | 所属グループID（複数のグループはカンマで区切ります） |
| ACTIVE_STATUS | 選択 | 活性化の有無 |
ACTIVE_STATUS 認識値:
| 認識値 | 処理結果 |
|---|---|
ACTIVE, Y, 1, true（大文字と小文字は区別しない） | アクティブユーザーとして処理 |
| その他すべての値 | 非アクティブユーザーとして処理 |
**注意:**ACTIVE_STATUS カラムが誤ってマッピングされているか、認識できない値が入力された場合、全ユーザーが無効化 されました設定変更後は必ず小規模テストを先に行ってください。
レコードフィルタリング (選択)
特定の条件に合ったレコードのみを同期対象に含めたり除外したりすることができます。
- ワイルドカード(
*) パターンをサポートしています。
基本メールドメイン (選択)
ユーザーIDはメール形式(@設定したドメインを自動的に追加して、メール形式に変換します。
| 設定例 | 変換前 | 変換後 |
|---|---|---|
ドメイン:company.com | hong123 | hong123@company.com |
ボタン: キャンセル | 一時保存 | 前 | 次
[3ステップ] グループ設定
グループCSVファイルの監視方法とデータ変換ルールを設定します。構成はユーザー設定タブと同様ですが、次のような違いがあります。
同期オプション (グループ)
| 項目 | オプション | 説明 |
|---|---|---|
| CSV未含項目処理 {#csv未含項目処理} | 維持 | CSVにない既存のグルー プをそのまま維持 |
| 削除 | CSVにない既存のグループを削除 |
**参考:**グループタブには
검증 오류 시 동기화 중단トグルと기본 이메일 도메인項目がありません。
| 項目 | ユーザー設定 | グループ設定 |
|---|---|---|
| CSV未含項目処理オプション | 維持 / 無効化 | 維持 / 削除 |
| 検証エラー時の同期中断 | あり (選択可能) | なし (エラー時は常に全体中断) |
| 基本的なメールドメイン | あります | なし |
標準フィールドリスト (グループ)
| 標準フィールド | 必須かどうか | 説明 |
|---|---|---|
| GROUP_ID | 必須 | グループ固有ID |
| GROUP_NAME | 必須 | グループ名 |
| DESCRIPTION | 選択 | グループの説明 |
| PARENT_GROUP_ID | 選択 | 上位グループID（階層構成時に使用） |
注意:グループ同期中にエラーが発生した場合、部分的な反映なしに全体同期が中断されましたできます。グループCSVファイルのデータ整合性を事前に十分に確認してください。
参考:ユーザー設定とグループ設定の中必ず一方はフィールドマッピングを完了すること保存できます。
ボタン: キャンセル | 一時保存 | 前 | 次
[4ステップ] 同期設定
自動同期周期とバックアップオプションを設定します。
| 項目 | 説明 |
|---|---|
| 自動同期 | 使用 / 使用しない選択 |
| 同期周期 | 自動同期を使用する場合、毎日実行する時刻（時/分）を設定 |
| 同期前のバックアップ | 使用時、同期実行前に現在のユーザー/グループデータを自動的にバックアップ |
**注意:**バックアップが有効になっている場合、バックアップに失敗すると同期は進行しません。
**参考:**すべての実行時刻はKST（韓国標準時）基準です。
ボタン: キャンセル | 前へ | 保存
手動同期
設定を保存した後、インバウンドプロビジョニングリスト画面のCSVディレクトリ同期カードで**[手動同期]**ボタンをクリックすると、即座に同期が実行されます。
- 同期完了後、成功/失敗の有無と完了時間が表示されます。
**注意:**同期中は重複実行ができません。以前の同期が完了した後に再実行してください。
同期結果の確認
設定完了後、カードで最後の同期結果を確認できます。
最後の同期状態の種類:
| 状態 | 説明 |
|---|---|
| 成功 | ファイル監視およびデータ反映完了 |
| 変更なし | 以前の同期に対してファイル内容の変更はありません（正常動作） |
| 接続失敗 | FTP/SFTPサーバーに接続できません |
| ファイルがありません | 指定されたパスにファイルが存在しません |
| 失敗 | データ変換、検証、または反映プロセスでエラーが発生しました |
**[最終同期情報]**リンクをクリックするとスライドパネル（"CSVディレクトリの最後の同期情報"）が開きます。
| 項目 | 表示内容 |
|---|---|
| グループ同期 | 状態、監視経路、最終同期日時 |
| ユーザー同期 | 状態、監視経路、最終同期日時 |
エラー対処
| エラーの種類 | 主な症状 | 対処方法 |
|---|---|---|
| 接続エラー | 状態: 接続失敗 | サーバーアドレス・ポート・アカウント情報の確認 / ファイアウォールポートの開放状況の確認 |
| ファイルエラー | 状態: ファイルなし | 指定されたパスとファイルパターンの確認 / ファイルがサーバーにアップロードされているか の確認 |
| 変換エラー | 状態: 失敗 | CSV区切り文字設定の確認 / フィールドマッピング設定の確認 / CSVファイルエンコーディング（UTF-8）の確認 |
| 検証エラー | 状態: 失敗 | 必須フィールド(USER_ID, USER_NAME / GROUP_ID, GROUP_NAME)の欠落確認 |
| 反映エラー | 状態: 失敗 | 同期ログでエラーの詳細を確認後、担当チームに問い合わせ。 |
| バックアップ失敗 | 同期未実行 | 同期前のバックアップ設定とバックアップストレージの確認 |
注意事項
- ユーザー設定とグループ設定の中必ず一方はフィールドマッピングを完了すること設定されていない状態では、両方とも保存されません。
- ACTIVE_STATUSフィールドマッピングが誤っている場合、全ユーザーが無効化される可能性があります。設定変更後は必ず小規模テストを先に行ってください。
- グループ同期エラーが発生した場合、部分反映なしに全体同期が中断されます。
- ファイル名が
#で始まるファイルはコメントアウトされ、同期対象から除外されます。 - ファイルの内容が変更されていない場合、同期をスキップします。これは正常な動作です。
- バックアップオプションを有効にした状態で同期を行うと、バックアップに失敗した場合、同期も中断されます。
- すべての実行時刻は**KST(韓国標準時)**基準です。
- 同期されたユーザー/グループ 情報を管理センターで直接修正しても、次回の同期実行時にCSVファイルに基づいて上書きされます。永続的な変更が必要な場合は、元のCSVファイルまたはソースシステムで先に修正してください。
- 1つのインバウンドプロビジョニング方式のみを有効にでき、他の方式がすでに有効になっている場合は、切り替え後に使用する必要があります。