Loading
Slack製品の問い合わせ先はSalesforce Helpへ統合・変更されます続きを読む

セキュリティの変更: 2027 年 2 月 20 日までの OAuth ユーザーエージェントフローの廃止

公開日: Oct 19, 2026
説明

Salesforce は、OAuth 2.0 ユーザーエージェントフローおよび OAuth 2.0 ハイブリッドユーザーエージェントフローを廃止します。適用後、アプリケーションはこれらのフローを使用してユーザーを認可したり、アクセストークンを取得したりできなくなります。また、Salesforce は Winter '27 リリース以降、新しく作成された組織でこれらのフローのブロックを開始します。既存の組織の既存インテグレーションは、最終廃止日である 2027 年 2 月 20 日までのみ引き続き動作します。

ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローではアクセストークンがブラウザに直接公開されるため、これらのフローを廃止することでセキュリティが向上し、お客様の Salesforce データをより適切に保護できます。詳細は、最新の 「Summer '26 リリースノート」 をご参照ください。

解決策

この記事では、Salesforce の OAuth ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローの廃止、影響を受ける対象、2027 年 2 月 20 日までの準備方法、および適用後の認可エラーの解決方法について説明します。

 

Salesforce がこの変更を行う理由

ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローは、アクセストークンをブラウザーに直接公開します。
これらのフローを廃止することでセキュリティが向上し、アクセストークンを安全に保ち、お客様の Salesforce データをより適切に保護できます
。

 

変更が有効になる時期

Winter '27 リリース以降、新しく作成された組織ではユーザーエージェントフローおよびハイブリッドユーザーエージェントフローがブロックされます。
既存組織のインテグレーションは、最終廃止日である 2027 年 2 月 20 日まで引き続き機能します
。

 

影響を受ける対象

この変更は、すべてのエディションの Lightning Experience および Salesforce Classic に適用されます。次のいずれかのログインサブ種別をインテグレーションで使用している場合、影響を受けます。

  • OAuth User-Agent
  • OAuth User-Agent for Hybrid Apps
  • OAuth User-Agent with ID Token

これには、カスタムインテグレーションや管理パッケージからインストールされたアプリケーションが含まれます。
影響を受けるアプリケーションを自社で所有していない場合は、アプリケーション開発者に連絡して更新バージョンを入手してください
。

 

フローがブロックまたは廃止された場合に想定される動作

  • ユーザーエージェントフローまたはハイブリッドユーザーエージェントフローを使用しているインテグレーションは認可を完了できなくなり、動作を停止する。
  • 認証済みユーザーの場合、[ログイン履歴] にステータス 「ユーザーエージェントフローが無効になっています (User-Agent Flow Disabled)」 が表示される。
  • 未認証ユーザーによる試行は [ログイン履歴] に記録されない。
  • /services/oauth2/authorize へのリダイレクトが失敗する。

Salesforce が廃止を適用する前に Salesforce システム管理者がこれらのフローをブロックすると、システム管理者がフローを無効化したことを示す次の 「invalid_grant」 レスポンスが返されます。

{
  "error": "invalid_grant",
  "error_description": "user-agent flow has been disabled by your Salesforce admin"
}

Salesforce が廃止を適用すると、レスポンスは Salesforce がフローを無効化したことを示す次の error_description に変わります。

{
  "error": "invalid_grant",
  "error_description": "user-agent flow has been disabled by Salesforce"
}

エンドユーザーに表示されるメッセージは、この認可エラーをアプリケーションがどのように処理するかによって異なります。

 

適用前: 準備方法

  1. ユーザーエージェントフローまたはハイブリッドユーザーエージェントフローを使用しているインテグレーションを特定する。
  2. Sandbox で、影響を受ける各インテグレーションを適切な安全な OAuth フローに移行する。
  3. ユーザーエージェントインテグレーションについては、PKCE (Proof Key for Code Exchange) を備えた OAuth 2.0 Web サーバーフローに移行する。
  4. ハイブリッドユーザーエージェントインテグレーションについては、PKCE を備えた OAuth 2.0 ハイブリッド Web サーバーフローに移行する。
  5. 自社で開発していないアプリケーションについては、アプリケーション開発者に連絡し、適用前に更新バージョンが提供されることを確認する。
  6. Sandbox で [OAuth ユーザーエージェントフローを許可] をオフにし、廃止の影響をテストする。
  7. 安全でないフローがブロックされた状態ですべてのインテグレーションが動作するようになるまで、影響を受けるすべてのインテグレーションをテストし、失敗した試行を確認する。
  8. テスト済みの変更を本番環境にコピーする。

Salesforce のガイド付きテストおよび有効化手順を確認するには、組織にログインしてください。
[設定] から、[クイック検索] ボックスに「リリース更新」と入力し、[リリース更新] を選択します。[OAuth ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローの廃止] を開きます
。 

 

影響を受けるアプリケーションの特定


方法 1: ログイン履歴の確認

  1. [設定] から、[クイック検索] ボックスに「ログイン履歴」と入力し、[ログイン履歴] を選択する。
  2. [ログインサブ種別] 列が表示されていることを確認する。表示されていない場合は、ビューを編集するか、この列を含むビューを作成する。
  3. [ログインサブ種別] が 「OAuth User-Agent」、「OAuth User-Agent for Hybrid Apps」、または 「OAuth User-Agent with ID Token」 であるエントリを探す。


方法 2: SOQL クエリの実行

示されている英語の LoginSubType 値をそのまま使用してください。次の SOQL クエリは、廃止された 3 つのログインサブ種別のいずれかを使用したすべてのログインのアプリケーション名を返します。

SELECT Application
FROM LoginHistory
WHERE LoginSubType IN (
  'OAuth User-Agent',
  'OAuth User-Agent for Hybrid Apps',
  'OAuth User-Agent with ID Token'
)

[ログイン履歴] では最近の使用状況を特定できます。
最近使用されていないインテグレーションを見落とさないように、アプリケーションの構成およびデプロイメントのドキュメントも確認してください
。

 

廃止されたフローをブロックしてテストする

まず、Sandbox でこれらの手順を完了してください。

  1. [設定] から、[クイック検索] ボックスに「OAuth」と入力し、[OAuth および OpenID Connect の設定] を選択する。
  2. [OAuth ユーザーエージェントフローを許可] をオフにする。この設定により、ユーザーエージェントフローとハイブリッドユーザーエージェントフローの両方がブロックされる。
  3. いずれかのフローに依存している可能性があるインテグレーションをテストする。
  4. 認証済みの試行については、[ログイン履歴] で 「ユーザーエージェントフロー無効 (User-Agent Flow Disabled)」 を確認する。
  5. /services/oauth2/authorize へのリダイレクトの失敗、および 「invalid_grant」 エラーを確認する。
  6. 影響を受けるインテグレーションを更新するか、開発者と連携して対応する。
  7. 設定がオフになっている状態ですべてのインテグレーションが動作するまでテストを続行する。

 

適用後: 認可エラーの解決

注意: 2027 年 2 月 20 日以降、オプトアウト(廃止適用の除外)はできません。
Salesforce が廃止を適用した後は、[OAuth ユーザーエージェントフローを許可] の再有効化はサポートされている解決策ではありません。

  1. [ログイン履歴]、アプリケーションログ、または失敗した認可リクエストから、影響を受けているアプリケーションを特定する。
  2. アプリケーションがユーザーエージェントフローまたはハイブリッドユーザーエージェントフローのどちらを使用しているかを確認する。
  3. ユーザーエージェントインテグレーションを PKCE (Proof Key for Code Exchange) を備えた OAuth 2.0 Web サーバーフローに移行する。
  4. ハイブリッドユーザーエージェントインテグレーションを PKCE を備えた OAuth 2.0 ハイブリッド Web サーバーフローに移行する。
  5. 自社で所有していないアプリケーションの場合は、開発者から準拠バージョンを入手する。
  6. Sandbox で、更新した認可フローと関連するビジネスプロセスをテストする。
  7. テスト済みの更新を本番環境にデプロイする。

 

Salesforce Mobile SDK を使用して構築されたカスタムモバイルアプリケーションへの影響

Mobile SDK 11.0 以降では、OAuth 2.0 Web サーバーフローがデフォルトの認証フローです。

  • 古いバージョンの Salesforce Mobile SDK を使用しているカスタムアプリケーションを構築した場合は、ユーザーエージェントフローの廃止期限前にすべてのユーザーが更新されたアプリケーションをインストールするための十分な時間を確保できるよう、できるだけ早く最新の Mobile SDK バージョンにアップグレードする必要があります。
  • すでに Mobile SDK 11.0 以降を使用しているが、明示的に Web サーバーフローをオプトアウトしている場合は、少なくともデフォルトとして Web サーバーフローを使用するように戻す必要があります。この要件およびその他のセキュリティ要件に備えるため、最新の Mobile SDK バージョン (14.0.0) にアップグレードすることを強く推奨します。ユーザーエージェントフローは Mobile SDK 14.0.0 で非推奨となり、Mobile SDK 15.0.0 で削除される予定です。

 

Salesforce 所有のモバイルアプリケーションへの影響

Salesforce アプリ、Mobile Publisher、Field Service などの Salesforce 所有のモバイルアプリケーションは、すでに Web サーバーフローに移行しています。
エンドユーザーは、2027 年 2 月 20 日より前にアプリケーションを最新バージョンに更新する必要があります
。

 

よくある質問

 

ユーザーエージェントフローの代わりにどの OAuth フローを使用すればよいですか?

PKCE (Proof Key for Code Exchange) 拡張機能を備えた OAuth 2.0 Web サーバーフローを使用してください。

 

ハイブリッドユーザーエージェントフローの代わりにどの OAuth フローを使用すればよいですか?

PKCE 拡張機能を備えた OAuth 2.0 ハイブリッド Web サーバーフローを使用してください。

 

[OAuth ユーザーエージェントフローを許可] をオフにすると、廃止された両方のフローがブロックされますか?

はい。この設定をオフにすると、ユーザーエージェントフローとハイブリッドユーザーエージェントフローの両方がブロックされるため、廃止適用前に影響をテストできます。

 

[ログイン履歴] に失敗した試行が表示されないのはなぜですか?

「ユーザーエージェントフロー無効 (User-Agent Flow Disabled)」 ステータスは、認証済みユーザーに対してのみ記録されます。
未認証ユーザーによる試行は記録されないため、アプリケーションログおよび /services/oauth2/authorize への失敗したリクエストも確認してください。

 

影響を受けるアプリケーションを自社で所有していない場合はどうすればよいですか?

アプリケーション開発者に連絡し、PKCE を備えた適切な Web サーバーフローを使用するバージョンをリクエストしてください。
2027 年 2 月 20 日より前に、更新されたアプリケーションをテストしてください
。

 

新しい組織ではインテグレーションが失敗するのに、古い組織では引き続き動作するのはなぜですか?

Salesforce は、最終適用日よりも前に、新しく作成された組織で廃止されたフローをブロックします。
古い組織では一時的に引き続き使用できますが、すべての組織で 2027 年 2 月 20 日より前に移行する必要があります
。

ナレッジ記事番号

005461282

 
読み込み中
Salesforce Help | Article