【Box】CSV一括ユーザー更新で困った時の監査ログで原因を確認する方法

Boxの管理コンソールでは、CSVファイルを使って複数のユーザー情報を一括で更新できます。大量の社員情報を一度に変更できる便利な機能ですが、想定通りに反映されない、エラーが発生するといったトラブルに遭遇することも少なくありません。原因が分からず、同じ操作を繰り返してしまうと、かえって状況を悪化させる恐れもあります。そんな時に役立つのがBoxが記録する監査ログです。本記事では、CSV一括ユーザー更新で問題が起きた際に、監査ログを活用して原因を特定し、迅速に対応する方法を具体的に解説します。

CSV一括ユーザー更新が失敗する主な原因

CSV一括更新で問題が発生する原因は大きく分けて以下の4つに分類できます。監査ログを確認する前に、これらの可能性を頭に入れておくと、ログの読み取りがスムーズになります。

CSVファイル自体のフォーマットやデータの問題

最も多いのが、CSVファイルの記述ミスです。ヘッダー行の列名がBoxの仕様と異なる、必須項目が空欄、日付形式が不正、文字コードがUTF-8ではないなどが該当します。また、ユーザーのメールアドレスに重複がある、存在しないグループ名を指定している、といったデータ上の問題も含まれます。

実行アカウントの権限不足

CSV一括更新を実行するユーザーに、適切な管理者権限が付与されていないケースです。Boxでは「ユーザー管理」の権限が必要ですが、カスタム管理者ロールでは制限されている場合があります。権限不足の場合は、監査ログに「権限エラー」として記録されます。

ユーザー属性の競合や制約

例えば、外部ユーザーを内部ユーザーに変更しようとする、管理対象外のドメインのユーザーを更新しようとする、既存ユーザーのメールアドレスを別のユーザーが既に使用している、などBoxのポリシーに違反する更新は失敗します。

Box側の制限や障害

短時間に大量の更新を実行するとAPIレートリミットに達する、Boxのサービスに一時的な障害が発生している、メンテナンス中であるといった要因も考えられます。これらの情報は監査ログのエラーコードから判別できます。

監査ログで原因を特定する手順

実際に監査ログを開き、該当するイベントを探して内容を確認する手順を説明します。管理者アカウントでBox管理コンソールにログインした状態から始めてください。

1. 管理コンソールの左メニューから「監査ログ」をクリックします。
2. 上部のフィルターで「イベントタイプ」を選択し、「ユーザー管理」カテゴリにチェックを入れます。さらに「ユーザーの一括更新」や「ユーザーの更新」などの具体的なイベントを絞り込むと探しやすくなります。
3. 日付範囲を、CSV一括更新を実行した時間帯に設定します。標準では過去7日間が表示されますが、必要に応じて変更してください。
4. 「検索」ボタンをクリックすると、該当する監査ログが一覧表示されます。成功した更新と失敗した更新が別々の行で表示されますので、ステータス列に注目してください。
5. 失敗したイベントの行をクリックすると、詳細が表示されます。ここにエラーコードやエラーメッセージ、影響を受けたユーザー、実行者の情報が含まれています。
6. エラーメッセージの内容を確認し、原因を特定します。「無効なメールアドレス」「権限が不足しています」「レート制限を超えました」など、おおむね平易な英語で記述されています。
7. 必要に応じて、CSVファイルの内容や実行者の権限設定を修正し、再実行します。再実行後も同様のエラーが続く場合は、さらに詳細なログをダウンロードして分析しましょう。

監査ログに記録されるイベントとエラーコードの読み解き方

監査ログには様々な情報が含まれていますが、特に重要なのがイベントタイプとエラーコードです。代表的なものを下表にまとめました。

イベントタイプ	エラーコード	意味と対処法
Bulk User Update	INVALID_CSV_FORMAT	CSVファイルのフォーマットが不正です。ヘッダー行や区切り文字、文字コードを確認してください。
Bulk User Update	INSUFFICIENT_PRIVILEGES	実行者の権限が不足しています。管理者ロールに「ユーザー管理」権限があるか確認してください。
Bulk User Update	DUPLICATE_EMAIL	CSV内または既存ユーザーに重複したメールアドレスがあります。メールアドレスの一意性を確認してください。
Bulk User Update	RATE_LIMIT_EXCEEDED	APIレート制限を超えました。更新数を分割して実行するか、時間を空けてから再試行してください。
Bulk User Update	USER_NOT_FOUND	CSVで指定したユーザーが存在しません。メールアドレスやユーザーIDを確認してください。

監査ログの詳細には、更新対象となったユーザーの一覧や、各ユーザーごとの成否も記録されています。CSVの行番号とユーザー情報が紐付いているため、エラーが発生した行を特定するのに役立ちます。

よくある失敗パターンと監査ログを使った対策

実際に現場で発生しやすい失敗例を3つ挙げ、それぞれ監査ログでどのように確認し、どう対処すればよいかを説明します。

失敗パターン1:CSVの文字コードがShift_JISでアップロードした

日本語版Excelから出力したCSVはShift_JISになることが多く、BoxはUTF-8を要求します。監査ログには「INVALID_CSV_FORMAT」または「不正な文字が検出されました」といったエラーが記録されます。対処法は、CSVファイルをUTF-8(BOMなし)に変換し直してから再アップロードすることです。

失敗パターン2:一般管理者ロールで実行したが権限が足りなかった

Boxでは「ユーザー管理」権限を持つ管理者でないと一括更新できません。監査ログに「INSUFFICIENT_PRIVILEGES」が記録された場合、実行者のロール設定を見直す必要があります。管理者コンソールの「ユーザーとグループ」→「管理者ロール」で、適切な権限を割り当ててください。

失敗パターン3:CSVに存在しないユーザーの更新を試みた

メールアドレスを間違えたり、削除済みユーザーを指定したりすると「USER_NOT_FOUND」エラーになります。監査ログの詳細に「Failed users: user@example.com」のように具体的なユーザーが表示されるので、該当行を修正します。

管理者が確認すべき監査ログの項目と注意点

CSV一括更新に関するトラブルを上司や他部署に報告する際、監査ログから得られる情報を整理しておくとスムーズです。以下の項目を押さえておきましょう。

• 実行日時と実行者: いつ、誰が実行したか。
• 対象ユーザー数と成功率: 全件中何件成功し、何件失敗したか。
• エラーコードとエラーメッセージ: 原因を特定するためのキー。
• 影響を受けたユーザー: 個別のユーザー名やメールアドレス。
• IPアドレス: 実行元の端末を特定したい場合に有用。

監査ログはBoxのエンタープライズプラン以上で保存期間が異なります。標準では90日間ですが、長期保存が必要な場合はログをエクスポート(CSV形式でダウンロード可能)し、社内のストレージに保管することをおすすめします。

よくある質問(FAQ)

Q1. 監査ログに一括更新のイベントが表示されません。

フィルターの日付範囲が適切でない可能性があります。CSV一括更新を実行した正確な時間帯を指定し直してください。また、イベントタイプのフィルターで「すべて」を選択して一度検索し、該当しそうなイベントがないか確認してください。

Q2. エラーメッセージが英語で意味がわかりません。

Boxの公式ヘルプセンターでエラーコードを検索すると、詳細な説明が表示されます。よくあるエラーコードは本記事の表でカバーしていますので、まずはそちらをご参照ください。

Q3. CSV一括更新を実行できるのはどの管理者ロールですか?

「ユーザー管理」権限を含むカスタム管理者ロール、または「スーパー管理者」「共同管理者」が実行できます。デフォルトの「一般管理者」では権限が不足している場合があります。詳細は管理コンソールの「管理者ロール」設定で確認してください。

まとめ

BoxのCSV一括ユーザー更新で問題が発生した場合、監査ログは原因を特定するための強力なツールです。まずはイベントタイプとエラーコードを確認し、CSVフォーマット、権限、データ競合、Box制限のいずれかに切り分けましょう。エラーメッセージが示す具体的な修正箇所を直せば、多くのトラブルは解決します。本記事で紹介した手順を参考に、監査ログを日常の運用トラブルシューティングに活用してみてください。