Salesforce技術ブログ(Summer ’24 および Winter ’25 で Visualforce ページへのアクセスを確保する; Winter’25 リリース更新)
件名:Summer ’24 および Winter ’25 で Visualforce ページへのアクセスを確保する(リリース更新)
影響範囲
Summer ’24 では、2024 年 6 月からSandboxと本番組織を除くすべての組織で実施されました。
Winter ’25 では、Sandboxと本番組織で実施されます。
[私のドメイン] を使用した組織の状況と今後のメンテナンス日の取得
概要
ブラウザがサードパーティの Cookie をブロックしている場合でもVisualforceページへのアクセスを継続できるようにするには、管理されていない全てのVisualforceページを、force.comドメインまたはサイトドメインで提供する必要があります。
詳細
〇影響
Summer ’24 では、Sandboxと本番組織を除くすべての組織で実施されました。
このリリースは、新しい Sandbox と更新された Sandbox を除く、新しく作成されたすべての組織にも適用されました。
(例:Developer Edition 組織、デモ組織、パッチ組織、Trailhead Playground)
Winter ’25 では、Sandboxと本番組織で実施されます。
〇調査方法
・ブラウザのアドレスバーのURLを更新して、エラーが出るか確認する(Salesforceが更新を行う前に、次の手順を完了する必要がある。)
- Salesforce にログインします。
- ブラウザのアドレスバーのURLを更新して、パスとして/apex/DomainTestを要求します。
ブラウザのアドレスバーに次のURLが含まれている場合(https://mycompany.lightning.force.com/lightning/page/home)、
URLを次のように変更します。(https://mycompany.lightning.force.com/apex/DomainTest) - Enter キーを押します。DomainTest Visualforce ページを作成していない場合、システムは「ページ DomainTest は存在しません」というエラーを返します。
- 結果として得られるベース URL が .salesforce.comで終わる場合、変更が適応されるため対応が必要です。
(例:https://mycompany.my.salesforce.com/apex/DomainTest)
反対に、結果として得られるベース URL が .force.comで終わる場合、Visualforce ページはすでに force.com で提供されているため、対応する必要はありません。
〇対応方法
・方法A:ハードコードされた参照を検索して更新
1.組織のメタデータをダウンロードする。
2.Microsoft Visual Studio Code などのコード エディターを使用してmy.salesforce.com/apexを検索します。
・方法B:Salesforce でハードコードされた参照を更新
※可能な限り、ハードコードされた URL ではなく、相対 URL または構築された URL を使用することを推奨します。
Apex 経由で Visualforce URL を構築するには、DomainCreator Apex クラスのgetVisualforceHostname(packageName) メソッドを使用します 。
未管理パッケージのパッケージ名は常に c です。
ハードコードされた参照が避けられない場合にベースURLのリンクを置き換えます。
・本番組織:管理されていない Visualforce ページの更新されたベース URL 形式はhttps://MyDomainName–c.vf.force.comです。
・サンドボックス:形式はhttps://MyDomainName–SandboxName–c.sandbox.vf.force.comです。
・パーティション化された非本番組織: Visualforce URL 形式については、 Salesforce ヘルプの「パーティション化されたドメイン」を参照
・方法C:その他の参照を更新する(サイトドメインなどのSalesforce外部に存在する場合;リンク、ブックマーク、Visualforce ページをフレーム化する外部統合)
C – a:Salesforce外部のリンクを更新場合
1.上記の方法Bで更新し、ユーザーとパートナーにブックマークを更新するように通知します。
C – b:外部統合によって影響を受ける Visualforce ページがフレーム化される場合
1.統合または外部 Web サイトの所有者に、この変更や Visualforce ページに影響する時期について通知する。更新されたページへのリンクは、my.salesforce.com/apexを検索する。
2.影響を受ける Visualforce ページがforce.comドメイン上で提供された後、所有者に URL を更新するように指示する。
3.所有者に、セキュリティ (CSP) ルールで*.force.comドメインのフレーミングが許可されていることを確認するように指示する。
ハードコードされた参照の更新詳細
〇この変更をWinter’25より前に有効にする
1.[設定] から [クイック検索] ボックスに 「私のドメイン」 と入力し、 [私のドメイン]を選択する。
2.[ルーティングとポリシー] セクションで、[編集]をクリックする。
3.[Salesforce Cookie のファーストパーティ使用が必要] を有効にして、変更を保存する。
設定の詳細
「Salesforce Cookie の使用に関する制限のテスト」
「ブロックされた Salesforce セッション Cookie の影響のテスト」
〇リダイレクト
変更後、Salesforce は以前の Visualforce ページ URL のリクエストを新しい force.com URL にリダイレクトします。
ただし、すべての統合がリダイレクト命令を処理するわけではないため、リダイレクトによってパフォーマンスが影響を受ける可能性があります。
既存の統合が期待どおりに機能するようにするには、salesforce.com ドメイン上の Visualforce URL へのすべての参照を更新することを推奨します。