SalesforceとAIの接続が切れる|更新トークンと原因の切り分け

SalesforceとAIの接続が切れる

回答: AIや外部ツールとSalesforceの接続が頻繁に切れるときは、(1)いつ切れるか(毎日・使わなかった日のあと・場所が変わったとき)、(2)どの方式でつないでいるか、(3)Salesforce側の設定、の順に切り分けます。ユーザーとしてログインしてつなぐ方式なら、接続アプリケーション(または外部クライアントアプリケーション)の「更新トークンポリシー」と「IP制限」の設定を確認します。母体の会社でも、AIとSalesforceの接続が毎日切れたことがあり、原因は更新トークンを直ちに期限切れにする設定でした。ただし、原因はそれだけとは限らないので、決めつけずに順に確かめてください。この記事は、Salesforceの設定を変更できるシステム管理者向けです。AIにつなぐ前に決める範囲や権限は業務システムをAIにつなぐ前に決めることにまとめています。

目次

この記事でわかること

  • 接続が切れる原因を切り分ける順番
  • 更新トークンとは何か、4つのポリシーの違い
  • 一緒に確認する設定(IP制限・許可されているユーザー)
  • 便利さと安全性のつり合いの考え方

母体の会社で起きたこと

答え: AIとSalesforceの接続が、毎日つなぎ直しになりました。原因は、更新トークンが直ちに期限切れになる設定でした。

母体の不動産会社では、AIのサービスからSalesforceのデータを読み取り専用で参照できるようにつないでいます。つないだ当初、翌日になるとAI側で接続が切れ、毎回つなぎ直す必要がありました。Salesforce側で確認すると、その接続に使っているアプリケーションの更新トークンポリシーが「更新トークンを直ちに期限切れにする」になっていました。「一定の期間使われていなければ期限切れ」に変えたところ、毎日の切断は起きなくなりました。

この経験から言えるのは、「切れる」と「設定」はセットで調べる、ということです。以下は、そのときの調べ方を一般化した手順です。

原因を切り分ける順番

答え: 切れ方を観察し、接続の方式を確かめ、それからSalesforce側の設定を見ます。

順番 確認すること 疑う原因の例
1. 切れ方 毎日同じころに切れる/しばらく使わないと切れる/場所やネットワークを変えると切れる 更新トークンのポリシー/IP制限
2. エラーの表示 AI側・ツール側に出た表示を控える(再認証を求める、権限がない、等) トークンの期限切れ/権限の不足
3. 接続の方式 ユーザーとしてログインしてつなぐか、システム同士でつなぐか 方式によって確認する設定が違う
4. Salesforce側の記録 [ログイン履歴]で、接続アプリケーション経由のログインと失敗を見る ログインの失敗理由
5. Salesforce側の設定 更新トークンポリシー、IP制限、許可されているユーザー、更新トークンのローテーション(使うたびに新しい更新トークンに替わる仕組み)を有効にしている場合はツール側が新しい更新トークンを保存して使えているか 下の表を参照
6. ツールの提供元 他社が提供するAIやツールなら、エラーの内容を添えて提供元に対応状況を聞く ツール側の不具合や仕様

Salesforceのヘルプによると、ログイン履歴では接続アプリケーションを介したログインを種別で確認できます(ログイン履歴の監視|Salesforce ヘルプ)。

更新トークンとは

答え: 一度ログインして許可したあと、毎回ログインし直さずに新しい接続を始めるための「引換券」のようなものです。

AIやツールは、Salesforceにアクセスするための短い期限の鍵(アクセストークン)を使います。その期限が切れたときに、更新トークンと引き換えて新しい鍵をもらいます。更新トークンが使えなくなると、ユーザーがもう一度ログインして許可する必要があります。これが「つなぎ直し」です。

更新トークンポリシーの4つの選択肢

答え: 「取り消されるまで有効」「直ちに期限切れ」「一定期間使われなければ期限切れ」「一定時間が経ったら期限切れ」の4つです。

Salesforceのヘルプでは、次の4つが説明されています(2026年11月時点。接続アプリケーションの OAuth アクセスポリシーの管理|Salesforce ヘルプ)。

選択肢 動き つなぎ直しの頻度 考え方
更新トークンは取り消されるまで有効(デフォルト) ユーザーか管理者が取り消すまで使える(ただし下の「30日」の制約も当てはまる) 少ない 便利だが、使われなくなった接続も残りやすい。取り消しの運用が前提
更新トークンを直ちに期限切れにする 今の接続は使えるが、期限が切れたら新しく始められない 多い(毎回) 常に人の操作を挟みたい用途向け
次で使用されていない更新トークンを期限切れにする(期間を指定) 指定した期間内に使われていれば有効。使うたびに期間が延びる 使っていれば少ない 使われなくなった接続は自然に切れる
次の時間が経過したら更新トークンを期限切れにする(期間を指定) 使っていても、決めた期間が経てば切れる 期間ごと 定期的な再確認を必ず挟みたい用途向け

ヘルプによると、更新トークンポリシーは更新トークンを使うときにだけ評価され、今使っている接続には影響しません。設定を変えても、その場で接続が切れるわけではありません。

2026年11月からの「30日使われなければ失効」

答え: 上の4つの設定とは別に、30日間使われていない更新トークンは失効する制約を、Salesforceがすべての組織に順に適用しています。

Salesforceの案内(2026年10月26日公開)によると、使われていない更新トークンの有効期間を30日に制限するセキュリティの制御が導入され、30日間使われなかった更新トークンは失効し、関連するアクセストークンも取り消されます。適用は、Sandboxが2026年10月21日から、本番組織などが2026年11月4日から、順に行われるとされています。対象は接続アプリケーションと外部クライアントアプリケーションです(Security Change: Refresh Token Idle TTL Is Limited to 30 Days|Salesforce ヘルプ)。

そのため、設定画面が「取り消されるまで有効」になっていても、30日以上使っていない接続は切れることがあります。月に1回より少ない頻度で使う接続は、この制約に当たらないかを確かめてください。

なお、Spring ’26 以降、接続アプリケーションの新規作成は制限され、代わりに外部クライアントアプリケーションの利用が推奨されています。外部クライアントアプリケーションにも更新トークンに関する設定があるので、使っている方の画面で確認してください。

一緒に確認する設定

答え: IP制限と、許可されているユーザーです。

  • IP制限:プロファイルでログインできるIPアドレスを制限していると、AIのサービスからの接続がその範囲外になることがあります。接続アプリケーションのOAuthポリシーには、IP制限の緩和に関する選択肢があります(「IP制限を適用し、更新トークンを緩和」など)。緩和は安全性を下げる方向の変更なので、必要な接続だけに絞ります
  • 許可されているユーザー:「管理者が承認したユーザーは事前承認済み」にしている場合、プロファイルや権限セットで許可されていないユーザーは使えません

便利さと安全性のつり合い

答え: 使われなくなった接続が自然に切れることを基本に、用途ごとに決めます。

期間で切れる設定を選ぶときは、AIのサービスを使う頻度ではなく、更新トークンが実際に使われる間隔を確かめます。サービスを使っていても、更新トークンが使われる場面はそれより少ないことがあります。

  • 毎日使う分析用の接続:一定期間使われなければ期限切れ、が使いやすい
  • めったに使わないが重要なデータに触れる接続:一定時間で期限切れ、または都度の許可
  • 退職・異動した人の接続:期限を待たずに取り消す

どの選択肢でも、使われていない接続を放置しないことが大切です。Salesforceのヘルプでは、トークンの取り消しはユーザーの詳細ページの[OAuth接続アプリケーション]、または[接続アプリケーションのOAuthの利用状況]ページから行えるとされています。

よくある質問

「取り消されるまで有効」のままでは危険ですか

一律に危険とは言えませんが、使われなくなった接続が残りやすくなります。誰がどの接続を使っているかを定期的に確認し、不要な接続を取り消す運用とセットで使ってください。なお、2026年11月からは、この設定でも30日間使われない更新トークンは失効する制約が順に適用されています。

設定を変えたら、今つながっている人は切れますか

更新トークンポリシーは、更新トークンを使うときに評価される、とヘルプに書かれています。変更した瞬間に今の接続が切れるわけではありませんが、次に更新トークンを使うときに新しいポリシーが当てはまります。

まとめ

接続が切れるときは、設定を変える前に原因を切り分けます。

  1. いつ・どう切れるかを観察し、エラーの表示を控える
  2. 接続の方式と、ログイン履歴の記録を確かめる
  3. 更新トークンポリシー・IP制限・許可されているユーザー・ローテーションを確認する
  4. 30日間使われない更新トークンは失効する制約(2026年11月から順に適用)も前提にする
  5. 便利さと安全性のつり合いで、用途ごとにポリシーを選び、使われない接続は取り消す

—

この記事を書いた会社

7plus株式会社 不動産会社向けの営業DX支援を行うITソリューションプロバイダーです。反響対応を即時化する「Mail2Link」「Mail2Link×AI」、ノーコード業務アプリ「BizBlock」の開発・提供に加え、Salesforce認定パートナーとして不動産特化型Salesforceパッケージの導入・定着コンサルティングも行っています。

詳しくはこちら → https://7plus.jp/

この記事を書いた人

目次