【Salesforce】API連携ユーザーが急に使えない時の切り分け

Salesforceで外部システムとのAPI連携を行っているユーザーが、突然APIを利用できなくなった場合、迅速な原因特定と復旧が求められます。API連携ユーザーに使えなくなる問題は、設定変更や認証情報の期限切れ、アクセス制限など複数の要因が考えられます。本記事では、具体的な確認手順と切り分けのポイントを解説し、実際の運用に役立つ情報を提供します。

突然使えなくなった原因を洗い出す

API連携が突然使えなくなった場合、考えられる原因はいくつかのカテゴリに分類できます。まずは原因の可能性を洗い出し、効率的に絞り込むことが重要です。以下に主要な原因カテゴリを説明します。

設定変更系の原因

ユーザプロファイルや権限セットの変更、API有効化フラグのオフ、ユーザの有効化解除など、設定変更が原因でAPIが使えなくなるケースです。特に、組織内の別の管理者が誤って変更した可能性も考慮します。

認証系の原因

OAuthトークンの有効期限切れ、セッションタイムアウト、パスワード変更、IP制限によるアクセス拒否など、認証に関連する問題です。特に長時間使用していない連携で発生しやすいです。

制限系の原因

APIリクエストの総数制限や同時呼び出し制限(レート制限)に達した場合も、APIが使用できなくなります。組織全体の使用量や特定のAPIの制限を確認する必要があります。

最初に確認すべき基本設定

API連携ユーザが使えなくなった場合、まずはSalesforce管理画面で基本設定を確認します。以下の手順で確認を進めてください。

1. Salesforceに管理者としてログインします。
2. 右上の歯車アイコンから「設定」を開きます。
3. 左メニューで「ユーザ」→「ユーザ」を選択します。
4. 対象のAPI連携ユーザを検索し、詳細ページを開きます。
5. 「有効」チェックボックスがオンになっているか確認します。
6. 「プロファイル」に割り当てられているプロファイル名をメモします。
7. 「権限セットの割り当て」を開き、API関連の権限セットが割り当てられているか確認します。

これらの基本設定に問題がない場合は、さらに詳細な確認に進みます。

APIユーザのプロファイルと権限セットの確認手順

API連携を使用するためには、適切なプロファイルまたは権限セットで「API 有効」権限が付与されている必要があります。以下の手順で確認します。

プロファイルの確認

1. 「設定」→「ユーザ」→「プロファイル」を開きます。
2. 対象ユーザに割り当てられているプロファイルを選択します。
3. 「システム管理者」または「標準ユーザ」などのプロファイルの設定を確認します。
4. 「システム権限」の一覧で「API 有効」にチェックが入っていることを確認します。
5. チェックが外れている場合は、編集して有効にします。ただし、会社のポリシーに従い、変更前に管理者と相談してください。

権限セットの確認

1. 「設定」→「ユーザ」→「権限セット」を開きます。
2. 「API 有効」権限を含む権限セット(例:「API Only User」など)を検索します。
3. 対象の権限セットが存在する場合、その詳細を開き「割り当てられたユーザ」一覧を確認します。
4. 該当ユーザが含まれていない場合は、権限セットを割り当てます。

プロファイルと権限セットの両方でAPIが有効になっている必要はありませんが、どちらか一方で有効になっていればAPIを使用できます。

認証トークンとセッションタイムアウトの確認

API連携でOAuth2.0を使用している場合、アクセストークンやリフレッシュトークンが期限切れになっていないか確認します。また、セッションタイムアウトの設定が短すぎると、API呼び出し中にセッションが切れる可能性があります。

1. 外部システム側で取得したトークンの有効期限を確認します。多くの場合、トークンは数時間から数日で期限切れになります。
2. Salesforce側のセッション設定を確認します。「設定」→「セキュリティ」→「セッション設定」で「セッションタイムアウト」の値が適切か確認します。
3. IP制限が設定されている場合、API連携元のIPアドレスが許可リストに含まれているか確認します。
4. リフレッシュトークンが正しく機能しているか、外部システムのログを確認します。

認証関連の問題は、トークンの再発行やセッション設定の調整で解決できることが多いです。

APIリクエスト制限とレート制限の確認

Salesforceには組織全体のAPIリクエスト制限(24時間あたりのリクエスト数)と、各APIエンドポイントのレート制限(1時間あたりの呼び出し数)があります。制限に達するとAPI呼び出しが拒否されます。

1. 「設定」→「環境」→「組織の情報」→「API リクエストの制限」を開きます。
2. 現在の使用量と制限値を確認します。使用量が制限近くであれば、原因の可能性が高いです。
3. 「API 使用状況」レポートで、特定のユーザやアプリケーションの使用量を確認します。
4. レート制限の場合は、API呼び出しの頻度を調整するか、Salesforceサポートに制限緩和を依頼します。

制限超過が原因の場合、一時的な対策として使用量を減らすか、制限の増加を申請します。

状況	考えられる原因	確認方法	対処方法
特定ユーザのみ使えない	プロファイル変更、権限セット削除	ユーザ設定の確認	権限を再付与
すべてのAPIユーザが使えない	組織全体のAPI制限超過、認証方式の変更	API使用状況レポート	制限緩和、認証再設定
時間帯によって使えない	レート制限、メンテナンス	エラーログのタイムスタンプ	呼び出し間隔の調整
特定のAPIメソッドだけ使えない	権限不足、APIバージョン変更	エラーメッセージの解析	権限追加、バージョン更新

トラブルシューティングまとめと管理者への報告

失敗パターンの具体例

実際によくある失敗パターンを紹介します。

• 誤ってプロファイルを変更した場合: システム管理者が別の作業中にAPI権限を外してしまうケース。変更履歴を確認するとすぐにわかります。
• パスワード変更後のトークン失効: ユーザがパスワードを変更すると、既存のOAuthトークンが無効になります。その結果、外部連携が突然停止します。
• IP制限の追加: セキュリティ強化のためにIP制限を追加した際、API連携サーバのIPが許可リストに含まれていないとアクセスできません。
• APIリクエスト制限の超過: 月末など利用が集中する時期に発生しやすいです。事前に使用状況を監視していれば防げます。

管理者へ報告する情報

管理者に問題を報告する際は、以下の情報を整理しておくとスムーズです。

• 発生した日時と現象(いつから使えないか、エラーメッセージの内容)
• 影響を受けるAPI連携の種類(例:取引先データの同期、売上レポートの取得など)
• エラーログのスクリーンショットまたはテキスト
• 直前に行った設定変更の有無(自分以外の変更も含めて)
• すでに確認した項目(ユーザの有効状態、プロファイル、権限セットなど)

よくある質問(FAQ)

• Q1: API連携ユーザのパスワードを変更したら使えなくなりました。どうすれば良いですか?
  A1: パスワード変更によりOAuthトークンが無効になります。外部システムで新しいトークンを取得するか、リフレッシュトークンを使用して再認証してください。
• Q2: プロファイルで「API 有効」がグレーアウトして変更できません。
  A2: そのプロファイルがシステム管理者以外の編集を許可していない可能性があります。別のプロファイルまたは権限セットでAPI権限を付与する方法を検討してください。
• Q3: API使用量が制限に達していないのにエラーが発生します。
  A3: レート制限(同時呼び出し制限)に達している可能性があります。または、特定のAPIエンドポイントに個別の制限が設定されていないか確認してください。

まとめとして、SalesforceでAPI連携ユーザが突然使えなくなった場合、原因は設定変更、認証問題、制限超過の3つに大別されます。まずはユーザの基本設定と権限を確認し、次に認証トークンと制限状況をチェックすることが重要です。問題の切り分けを迅速に行うことで、復旧時間を短縮できます。また、管理者への報告時にはエラーログや変更履歴を添えると原因特定がスムーズになります。