ブログ

Salesforceのリフレッシュトークン30日制限(アイドルTTL)とは?管理者の対応と実機検証

#Salesforce #リフレッシュトークン #アイドルTTL

積極採用中
セミナー情報

2026/10/15頃、Salesforceから管理者宛に「10月度 Salesforce 接続アプリケーションおよび外部クライアントアプリケーションのセキュリティ要件アップデート」というメールが届きました。
メールの「OAuth セキュリティ要件」には、「セキュリティ変更: リフレッシュトークンのアイドル TTL が30日間に制限されます」と記載されています。

今回の変更は、Salesforceの「接続アプリケーション」と「外部クライアントアプリケーション」の両方が対象です。リフレッシュトークンを30日間使わなかった場合、そのトークンは無効になります。使用頻度が低いアプリや連携では、再認証が必要になる可能性があります。
本記事では、このメールを受け取った管理者向けに、対応が必要かどうか、影響するアプリの確認方法、対処法をまとめます。後半では「接続アプリケーション」で行った実機検証の結果を紹介します。Sandboxで30日制限を先行適用し、API接続の動作も確認しました。
注意|本記事は2026/10/15時点の案内と実機検証に基づきます。画面や仕様は今後変わる可能性があります。

まず結論:対応が必要なのは誰?

結論|対応の要否とやること
  • ブラウザからの通常のログイン(ID・パスワードやSSO)には影響しません。
  • リフレッシュトークンを使う外部連携やアプリがある場合は、確認が必要です。
  • 特に注意したいのは、30日以上間隔が空くバッチや季節的な連携と、適用日のアクセストークン一斉取り消し後に再取得できない連携です。
  • やることは、対象アプリの洗い出し、適用日に再取得が動くかの確認、30日以上使わない連携の対処方針の決定の3つです。

Salesforceから届いた案内

Salesforceから届いた案内(該当部分)

リフレッシュトークンの30日制限とは

Salesforceと連携するアプリは、通常、アクセストークンを使ってデータにアクセスします。このトークンが使えなくなったとき、再ログインせず新しいアクセストークンを取得するために使うのが「リフレッシュトークン」です。なお、Salesforceの画面では「更新トークン」と表示されます。本記事では画面の表記を引用する場合を除き、「リフレッシュトークン」と書きます。
今回制限されるのは、このリフレッシュトークンの未使用期間です。30日以内にリフレッシュトークンを使って更新処理(新しいアクセストークンの取得)を行えば、未使用期間のカウントはリセットされます。30日ごとに必ず再ログインする変更ではありません。

項目 Salesforceからの案内
Sandboxへの適用 2026/10/21(米国時間)から順次
本番環境への適用 2026/11/4(米国時間)から順次
対象 30日を超えてリフレッシュトークンを使用しない可能性があるアプリ・連携
新規作成したアプリ 2026/7/9(米国時間)以降に作成されたアプリはすでに制限適用済み

30日制限は、従来の「更新トークンは取り消されるまで有効」という設定より優先されます。対象は接続アプリケーションと外部クライアントアプリケーションの両方です。

適用日に何が起きる?

Salesforceのリリースノートによると、30日制限が強制適用されると、次の3つが起きます。

  • 既存のアクセストークンが、すべて一度取り消されます。毎日使っている連携も対象です。
  • 30日以上使われていないリフレッシュトークンが、その時点で失効します。
  • 適用後も、30日間使われなかったリフレッシュトークンは順次失効していきます。

有効なリフレッシュトークンを使ってアクセストークンを自動で再取得できる連携であれば、再認証せずに接続を継続できます。一方、401エラーを受けたときに再取得する処理がない連携や、リフレッシュトークンがすでに失効している連携は、適用日に止まる可能性があります。リリースノートでも、取り消し時に保存済みのリフレッシュトークンで新しいアクセストークンを取得できるか、事前に確認するよう求めています。

なお、この制限を無効にしたり、30日より長くしたりすることはできません。設定画面には、変更したい場合はサポートに連絡するよう説明がありますが、リリースノートでは、強制適用後はこの方法も使えないとされています。

どのような使い方に影響する?

利用方法 影響の有無 理由
ブラウザで通常どおり
Salesforceを使う
原則なし 通常のブラウザログインは30日制限の対象外
Salesforceモバイルアプリ 条件次第 30日以上アプリを使わないと、再ログインが必要になる可能性
外部システムとのAPI連携 条件次第 リフレッシュトークンを使い、30日を超えて未使用になる場合に影響
毎日・毎週の定期連携 低い(適用日は要確認) 30日制限の影響は受けにくいが、適用日のアクセストークン取り消し後に再取得できるかは確認が必要
数か月に1回のバッチ処理 影響あり得る 次回実行時に再認証が必要になる可能性

ポイントは、Salesforceにログインしているかではなく、対象アプリがリフレッシュトークンを最後にいつ使用したかです。API連携を使っている場合でも、クライアントログイン情報フローやJWTベアラーフローなど、リフレッシュトークンを使わない認証方式であれば、30日制限の対象にはなりません。

影響するアプリを確認する(接続アプリケーションの場合)

この章で紹介する手順と画面は、検証した接続アプリケーションの場合です。外部クライアントアプリケーションは確認する画面が異なり、本記事では試していないため、参考資料にある外部クライアントアプリケーション向けの公式ヘルプを確認してください。

OAuthの利用状況を確認

[設定]で[接続アプリケーションの OAuth の利用状況]を開くと、アプリごとの利用ユーザー、初回接続、最終使用日、使用回数が分かります。
接続アプリケーションのOAuth利用状況

接続アプリケーションのOAuth利用状況(ユーザー名は伏せています)

ただし、画面にある「最終使用日」はリフレッシュトークンを最後に使用した日時とは限りません。この一覧だけで30日制限の影響を判定することはできません。

更新トークンポリシーを確認

接続アプリケーションの場合、[設定]→[アプリケーションマネージャー]→[対象の接続アプリケーション]→[Manage]→[ポリシーを編集]から更新トークンポリシーを確認します。外部クライアントアプリケーションは[外部クライアントアプリケーションマネージャー]で設定します。
接続アプリケーションの更新トークンポリシー(30日制限適用後)

接続アプリケーションの更新トークンポリシー(30日制限適用後)

アプリケーションマネージャーには、通常のLightningアプリも表示されます。確認するのはOAuthを使う「Connected」などの接続アプリケーションです。アプリ本体の設定を編集できないものもあります。
確認する項目をまとめると、次のとおりです。

確認すること 確認のしかた
使っている接続アプリケーションを調べる [接続アプリケーションの OAuth の利用状況]を確認
リフレッシュトークンを使っているか 接続アプリケーションのOAuthスコープと認証方式を確認
30日以上使わない連携がないか バッチの実行頻度や、リフレッシュトークンを使う頻度を連携担当者に確認
再認証の方法が決まっているか アプリ提供元や運用担当者に確認
設定ファイルを使って管理しているか 管理画面と設定ファイル(Metadata API)の値が一致しているか確認

 

30日以上使わない連携の対処法

確認の結果、30日以上使わない連携が見つかった場合の主な選択肢は、次の3つです。

  • 定期的にリフレッシュする:実際の処理がない期間も、30日以内にリフレッシュトークンで更新処理を実行すれば、未使用期間はリセットされます。
  • リフレッシュトークンを使わない認証方式に切り替える:サーバー間の連携であれば、クライアントログイン情報フローやJWTベアラーフローを検討できます。これらの方式は30日制限の対象外です。適用日のアクセストークン取り消しの影響は受けますが、同じフローを実行し直せば新しいアクセストークンを取得できます。
  • 再認証の手順を決めておく:実行頻度が低く、ほかの方法が取れない場合は、失効したときに誰がどう再認証するかを事前に決めておきます。

【実機検証】30日制限を先行適用してみた

ここからは、Sandboxで実際に試した結果を紹介します。

検証の範囲
2026/10/15、検証専用のSandboxにある自作の接続アプリケーションで検証しました。外部クライアントアプリケーション、30日間の放置による失効、設定ファイルの再デプロイは試していません。

 
変更前の更新トークンポリシーは「取り消されるまで有効」でした。
対象アプリの[編集]で「アイドル状態更新トークンの有効期間(TTL)を30日に制限」を選び、保存しました。途中で、長期間未使用のリフレッシュトークンが無効になる旨の確認ダイアログが表示されました。
30日制限の設定項目(適用後はチェックが固定)

30日制限の設定項目(適用後はチェックが固定)

有効化時に表示された確認メッセージ

有効化時に表示された確認メッセージ

適用後、ポリシーの編集画面から「更新トークンは取り消されるまで有効」の選択肢がなくなりました。項目名には「アイドル状態の有効期間制限を適用済み」と表示され、「次で使用されていない更新トークンを期限切れにする」に「30日」が設定されています。30日制限のチェックはグレーアウトし、通常の編集操作では解除できない状態になりました。2章で触れたとおり、強制適用後はサポートへの依頼で元に戻すこともできません。
適用前の更新トークンポリシー(「取り消されるまで有効」が選択されている)

適用前の更新トークンポリシー(「取り消されるまで有効」が選択されている)

適用後の更新トークンポリシー(「取り消されるまで有効」の選択肢がない)

適用後の更新トークンポリシー(「取り消されるまで有効」の選択肢がない)

注意|先行適用時の認証への影響
2章のとおり、強制適用時には既存のアクセストークンがすべて一度取り消されます。有効なリフレッシュトークンで新しいアクセストークンを取得できれば接続を続けられますが、取得できなければ再認証が必要です。利用中の接続アプリケーションで先行適用するときも、認証への影響を事前に確認してください。

 

【実機検証】API接続はどう変わった?

30日制限を有効にすると、API接続に使っていた認証情報はどうなるのでしょうか。設定変更の前後で、同じアクセストークンを使ってSalesforceに接続できるか試しました。APIの利用状況を取得するリクエストで確認しました(レコードの登録や変更は行っていません)。

順番 確認内容 結果
1 制限適用前にアクセストークンを取得 取得成功
2 そのトークンでSalesforceにAPI接続 接続成功
3 30日制限を有効化 設定完了
4 直後に同じトークンでAPI接続 HTTP 401
5 時間を置いて同じトークンでAPI接続 接続成功
6 リフレッシュトークンで再取得したトークンでAPI接続 接続成功

まず、OAuth認証でアクセストークンを取得し、そのトークンを使ってAPI接続できることを確認しました。次に30日制限を有効化し、直前まで使えていた同じトークンで接続を試しました。

注意|HTTP 401の原因は未特定
制限の適用直後はHTTP 401が返されましたが、その後、同じアクセストークンで再接続すると成功しました。原因は特定できていません。なお、Salesforceの公式リリースノートでは、強制適用時に既存のアクセストークンがすべて一度取り消されると案内されています。利用中の連携では、アクセストークンを再取得できるか事前に確認してください。

 
また、適用前に取得したリフレッシュトークンから新しいアクセストークンを取得し、そのトークンでもAPI接続に成功しました。有効なリフレッシュトークンが残っていれば、再ログインせずに新しいアクセストークンを取得できることを確認しています。

補足|30日制限とトークンの再利用
なお、30日制限は、リフレッシュトークンを1回使うと無効になる仕組みではありません。検証環境では、同じリフレッシュトークンを繰り返し使用できました。ただし、検証した接続アプリケーションでは「更新トークンのローテーションを有効化」がオフでした。ローテーションを有効にしている場合は、新しいアクセストークンの発行時に古いリフレッシュトークンが無効になり、新しいリフレッシュトークンに置き換わります。

 

【実機検証】リフレッシュトークンが使えなくなったら?

リフレッシュトークンが30日間使用されずに失効すると、新しいアクセストークンを取得できなくなり、連携が停止する場合があります。ここでは、こうした場合のエラーと復旧方法を確認するため、検証用ユーザーのOAuth認可を手動で取り消しました。

順番 試したこと 結果
1 別の検証用ユーザーでOAuth認証し、APIに接続 接続成功
2 使えなくなった場合を想定し、管理画面から認可を取り消す 取り消し完了
3 無効になったリフレッシュトークンで更新を試す 失敗(HTTP 400)
4 再ログインして、新しいトークンでAPIに接続 接続成功

検証で返されたエラー:HTTP 400/invalid_grant(expired access/refresh token)
認可を取り消す前は更新できましたが、取り消した後は更新に失敗しました。同じユーザーでログインし直すとAPI接続が成功し、新しいリフレッシュトークンによる更新もできました。

注意|30日間放置した検証ではありません
ただし、公式リリースノートでは、30日を超えて使われていないリフレッシュトークンでも同じエラー(invalid_grant/expired access/refresh token)が返るとされています。

 

【実機検証】管理画面は30日でも、取得した設定ファイルは無期限のまま

30日制限を適用した後、Salesforce CLIで接続アプリケーションの設定ファイルを取得しました。管理画面には「30日」と表示されている一方、取得したXMLには、次の値が残っていました。
infinite
「infinite」は、従来の「取り消されるまで有効」を表す値です。管理画面で制限を有効にしても、取得した設定ファイルの値は自動で置き換わりませんでした。
Salesforce CLIで取得した設定値(26行目に「infinite」)

Salesforce CLIで取得した設定値(26行目に「infinite」)

設定ファイルをGitなどで管理している場合、XMLの値だけで実際の有効期間を判断しないよう注意が必要です。この挙動はSalesforceの公式ヘルプにも記載されており、設定ファイルを管理画面と揃えるには、refreshTokenPolicyの値を「specific_inactivity:30:DAYS」に変更するよう案内されています。設定ファイルの変更や再デプロイは行っておらず、infiniteのまま再デプロイした場合の挙動は未検証です。

まとめ

今回の変更は、接続アプリケーションと外部クライアントアプリケーションの両方が対象です。ただし、Salesforceの全ユーザーに30日ごとの再ログインを求めるものではありません。リフレッシュトークンを使う連携のうち、長期間使わないものがないか確認しましょう。また、接続アプリケーションをパッケージで配布している場合、開発元が30日制限を有効にすると、サブスクライバー側の更新トークンポリシーにも影響すると公式ヘルプで案内されています。
事前に対象アプリと再認証の手順を確認しておけば、更新処理に失敗したときも対応しやすくなります。

参考資料

Salesforceからの通知メール「10月度 Salesforce 接続アプリケーションおよび外部クライアントアプリケーションのセキュリティ要件アップデート」(2026/10/15頃)
Salesforce Winter ’27 リリースノート「Refresh Token Idle TTL Is Limited to 30 Days」
Salesforce Help「接続アプリケーションでのアイドル更新トークン TTL の制限」
Salesforce Help「外部クライアントアプリケーションでのアイドル更新トークン TTL の制限」

<Salesforce>
弊社ではSalesforceをはじめとするさまざまな無料オンラインセミナーを実施しています!
>>セミナー一覧はこちら

また、弊社ではSalesforceの導入支援のサポートも行っています。ぜひお気軽にお問い合わせください。
>>Salesforceについての詳細はこちら
>>Salesforceの導入支援実績はこちらからご覧いただけます!

医療業界に特化した営業支援、顧客管理(SFA/CRM)のコンサルティングも提供しております。こちらもぜひお気軽にお問い合わせください。
>>顧客管理(SFA/CRM)のコンサルティングの詳細はこちら

CONTACT
お問い合わせ

ご相談やご依頼、病院マスタなどについてのお問い合わせはこちらのお問い合わせフォームから。

サービスなどについてのお問い合わせ 病院マスタについてのお問い合わせ

メールお問い合わせ