Frontdoor.jsp を使用した既存のセッションから Salesforce へのアクセス

<form method="POST" action="https://domain_name/secur/frontdoor.jsp">
<input type="hidden" name="sid"
      value="full_sessionID_value" />
<input type="hidden" name="retURL" 
      value="optional_relative_url_to_open" /> 
<input type="submit" name="login" value="Log In" /></form>

OAuth 2.0 ハイブリッドアプリケーショントークンフロー

OAuth 2.0 ハイブリッドアプリケーショントークンフローでは、frontdoor.jsp を使用せずに Web セッションを直接ブリッジするために、ハイブリッドアプリケーションによってセッション Cookie でドメインの関連付けられた SID が設定されます。

Web セッションで [ログイン時にデフォルトのディビジョンにリセット] 設定を使用してオブジェクトのユーザーディビジョンをリセットする場合、ハイブリッドアプリケーショントークンフローで frontdoor.jsp を使用する必要があります。このフロー中にセッションの中断を回避するには、frontdoor.jsp への要求に、値を true に設定した directBridge2 パラメーターを含めます。directBridge2 パラメーターで、要求されたドメインのセッション ID Cookie にアクセストークンが直接渡されます。このフローでは、ハイブリッドアプリケーションで API コールと UI 要求で同じアクセストークンを使用するため、アクセストークンと更新トークンの有効期限を覚えておく必要はありません。

組織全体で多要素認証 (MFA) が必要な場合、ユーザーは OAuth ハイブリッドアプリケーションフロー中に Web セッションにアクセスするための MFA を要求されます。シングルサインオン (SSO) でユーザーを認証する実装の場合、ユーザーが ID プロバイダーのサービスを使用して MFA を完了すると、Salesforce MFA チャレンジは冗長になります。frontdoor.jsp を介した OAuth セッションのブリッジング中に directBridge2 パラメーターを true に設定することで、Salesforce MFA チャレンジをバイパスできます。directBridge2 パラメーターを使用して MFA をバイパスするには、使用している SSO フローの種別に応じて、認証プロバイダーまたは SAML シングルサインオン設定で [この SSO プロバイダーに Salesforce MFA を使用] 設定を無効にする必要があります。詳細は、「サービスプロバイダーとして Salesforce を使用した SAML SSO」および「証明書利用者として Salesforce を使用した認証プロバイダー SSO」を参照してください。

directBridge2 パラメーターを使用するには、セッション ID 値が、web 範囲のある OAuth 2.0 アクセストークンであり、クエリ文字列ではなく POST ボディで渡されていることを確認してください。モバイルアプリケーションは OAuth 2.0 ハイブリッドアプリケーショントークンフローを使用し、Web ビューでセッション Cookie を管理できる必要があります。directBridge2 パラメーターは、標準 Web ブラウザーではサポートされません。

重要 [ログイン時にデフォルトのディビジョンにリセット] 設定を使用していない場合、ハイブリッドアプリケーショントークンフローで frontdoor.jsp を使用することをお勧めします。代わりに、セッション Cookie でドメイン SID を設定して Web セッションに接続します。

SID を frontdoor.jsp に投稿し、directBridge2 パラメーターを含むフォームの例を次に示します。

<form method="POST" action="https://domain_name/secur/frontdoor.jsp">
<input type="hidden" name="directBridge2" 
      value="true" />
<input type="hidden" name="sid" 
      value="full_sessionID_value" />
<input type="submit" name="Submit" />
</form>

ハイブリッド アプリケーション トークン フローについての詳細は、「ハイブリッド アプリケーションの OAuth 2.0 認証およびセッション管理」を参照してください。

完全なセッション ID

完全なセッション ID の一例が、OAuth 認証から取得する access_token です。外部クライアントアプリケーションの作成時に指定する範囲の 1 つは web または full である必要があります。

メモ frontdoor.jsp では、一部のセッション種別 (Experience Cloud サイトの API セッションなど) はサポートされていません。これらのセッションの場合、代わりにシングルサインオン用の SAML を使用することを検討してください。

セッション ID は、Apex の UserInfo.getSessionId()、$Api.SessionID、その他の取得元など、いくつかの方法で取得できます。これらの取得元から取得する ID 値がコンテキストによって異なることがあり、frontdoor.jsp で機能しない場合があります。その場合は、使用時にセキュリティ上のリスクを伴います。安全かつ信頼のおける値として、OAuth 認証の access_token を使用します。

サイトを開くための相対 URL

ユーザーを Salesforce ユーザーインターフェース、または特定のレコード、オブジェクト、レポート、Visualforce ページにリダイレクトするために、必要に応じて URL にエンコードされた相対パスを含めることができます (例: /apex/MyVisualforcePage)。