Salesforce は、OAuth 2.0 ユーザーエージェントフローおよび OAuth 2.0 ハイブリッドユーザーエージェントフローを廃止します。適用後、アプリケーションはこれらのフローを使用してユーザーを認可したり、アクセストークンを取得したりできなくなります。また、Salesforce は Winter '27 リリース以降、新しく作成された組織でこれらのフローのブロックを開始します。既存の組織の既存インテグレーションは、最終廃止日である 2027 年 2 月 20 日までのみ引き続き動作します。
ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローではアクセストークンがブラウザに直接公開されるため、これらのフローを廃止することでセキュリティが向上し、お客様の Salesforce データをより適切に保護できます。詳細は、最新の 「Summer '26 リリースノート」 をご参照ください。
この記事では、Salesforce の OAuth ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローの廃止、影響を受ける対象、2027 年 2 月 20 日までの準備方法、および適用後の認可エラーの解決方法について説明します。
ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローは、アクセストークンをブラウザーに直接公開します。
これらのフローを廃止することでセキュリティが向上し、アクセストークンを安全に保ち、お客様の Salesforce データをより適切に保護できます。
Winter '27 リリース以降、新しく作成された組織ではユーザーエージェントフローおよびハイブリッドユーザーエージェントフローがブロックされます。
既存組織のインテグレーションは、最終廃止日である 2027 年 2 月 20 日まで引き続き機能します。
この変更は、すべてのエディションの Lightning Experience および Salesforce Classic に適用されます。次のいずれかのログインサブ種別をインテグレーションで使用している場合、影響を受けます。
これには、カスタムインテグレーションや管理パッケージからインストールされたアプリケーションが含まれます。
影響を受けるアプリケーションを自社で所有していない場合は、アプリケーション開発者に連絡して更新バージョンを入手してください。
/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"
}
エンドユーザーに表示されるメッセージは、この認可エラーをアプリケーションがどのように処理するかによって異なります。
Salesforce のガイド付きテストおよび有効化手順を確認するには、組織にログインしてください。
[設定] から、[クイック検索] ボックスに「リリース更新」と入力し、[リリース更新] を選択します。[OAuth ユーザーエージェントフローおよびハイブリッドユーザーエージェントフローの廃止] を開きます。
示されている英語の 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 でこれらの手順を完了してください。
/services/oauth2/authorize へのリダイレクトの失敗、および 「invalid_grant」 エラーを確認する。
注意: 2027 年 2 月 20 日以降、オプトアウト(廃止適用の除外)はできません。
Salesforce が廃止を適用した後は、[OAuth ユーザーエージェントフローを許可] の再有効化はサポートされている解決策ではありません。
Mobile SDK 11.0 以降では、OAuth 2.0 Web サーバーフローがデフォルトの認証フローです。
Salesforce アプリ、Mobile Publisher、Field Service などの Salesforce 所有のモバイルアプリケーションは、すでに Web サーバーフローに移行しています。
エンドユーザーは、2027 年 2 月 20 日より前にアプリケーションを最新バージョンに更新する必要があります。
PKCE (Proof Key for Code Exchange) 拡張機能を備えた OAuth 2.0 Web サーバーフローを使用してください。
PKCE 拡張機能を備えた OAuth 2.0 ハイブリッド Web サーバーフローを使用してください。
はい。この設定をオフにすると、ユーザーエージェントフローとハイブリッドユーザーエージェントフローの両方がブロックされるため、廃止適用前に影響をテストできます。
「ユーザーエージェントフロー無効 (User-Agent Flow Disabled)」 ステータスは、認証済みユーザーに対してのみ記録されます。
未認証ユーザーによる試行は記録されないため、アプリケーションログおよび /services/oauth2/authorize への失敗したリクエストも確認してください。
アプリケーション開発者に連絡し、PKCE を備えた適切な Web サーバーフローを使用するバージョンをリクエストしてください。
2027 年 2 月 20 日より前に、更新されたアプリケーションをテストしてください。
Salesforce は、最終適用日よりも前に、新しく作成された組織で廃止されたフローをブロックします。
古い組織では一時的に引き続き使用できますが、すべての組織で 2027 年 2 月 20 日より前に移行する必要があります。
005461282

We use three kinds of cookies on our websites: required, functional, and advertising. You can choose whether functional and advertising cookies apply. Click on the different cookie categories to find out more about each category and to change the default settings.
Privacy Statement
Required cookies are necessary for basic website functionality. Some examples include: session cookies needed to transmit the website, authentication cookies, and security cookies.
Functional cookies enhance functions, performance, and services on the website. Some examples include: cookies used to analyze site traffic, cookies used for market research, and cookies used to display advertising that is not directed to a particular individual.
Advertising cookies track activity across websites in order to understand a viewer’s interests, and direct them specific marketing. Some examples include: cookies used for remarketing, or interest-based advertising.