Salesforce へのリクエストURIエンコーディングについて（変更適用日：2018年2月11日）

変更の概要

Salesforce では、Salesforce サービスへの HTTP リクエスト（URL、フォームのデータ等）に、不適切な文字が含まれていた際の処理を見直し、適切な UTF-8 のみ処理するように改善します。これにより、「UTF-8 を適切に % エンコードした文字」以外の文字が含まれるリクエストはセキュリティリスクとみなされ、無効と判定されます。（例: Illegal Request のエラーが返る等）。

• %uXXXX 形式でエンコード（JavaScript の非標準関数である escape() を利用した場合等）された文字を含む HTTP リクエスト
• リクエストに含まれる % エンコードの文字をデコードした結果、UTF-8 ではない文字を含む HTTP リクエスト
• リクエストをデコードする前の状態で、エンコードされていない ASCII 以外の文字が含まれている HTTP リクエスト（正しく % エンコードされた文字は、ASCII  文字のみで構成されます）

お客様にご対応いただく作業

上記の「変更の理由」にてご案内の通り、Salesforce への HTTP リクエストには UTF-8 のみが利用可能ですが、お客様環境において何らかの理由で「�」（Salesforce のミドルウェアによって解釈出来なかった文字の変換結果）が Salesforce に渡されるデータとして期待されている処理や、JavaScript 非標準の escape() 関数で生成された字が Salesforce に渡されている可能性があります。
 

なお、「UTF-8 を適切に % エンコードした文字」以外の文字を利用したURIエンコーディングについては、将来的には全て修正いただくことが必要ですが、今回の変更ではエラーが発生せず、現状の通り動作する処理がございます。​
変更適用日以降、エラーとなる処理／現状のまま動作する処理の具体例を、以下のナレッジ記事に用意いたしました。調査・対応にご利用ください。

ナレッジ記事：有効ではない Salesforce へのリクエストの具体例について​

確認が必要なお客様

お客様の設定や外部プログラムで生成または利用されている Salesforce への HTTP リクエストが、「UTF-8 を適切に % エンコードした文字」のみ利用していると判断されることが難しいお客様

確認手段

お客様環境の実装方法やデータに依存するため、お客様の設定や外部プログラムで生成または利用されている Salesforce への HTTP リクエストで、「変更の概要」にあるような、「UTF-8 を適切に % エンコードした文字」以外の文字が利用されていないかの個別の確認が必要となります。

Sandboxは既にこの変更が適用されておりますので、サンドボックス上で既存機能の動作に問題が出ていないか確認していただくくことが可能です。

主な利用箇所

• Salesforce への HTTP リクエストを生成・利用している設定やプログラム（下記例の箇所も個別に実装の確認が必要です）
• Salesforce 上の特定ページへ移動するカスタムボタンまたはカスタムリンクで、［内容のソース］が “OnClick JavaScript” となっている
• Salesforce 上の特定ページへ移動するカスタムボタンまたはカスタムリンクで、［内容のソース］が “URL” となっていて、［リンクのエンコード］が "Unicode (UTF-8)” 以外となっている
• Lightning Experience 上のレポートパラメータを動的・または静的に指定しているリンク
• Salesforce 上の特定ページを呼びだす Visualforce または外部プログラム
• 静的リソースやレコードに保存している Salesforce の特定ページへの URL

確認が不要な箇所

Salesforce 以外へアクセスするための URL を生成・利用する箇所

関連ヘルプおよびKB

• 効果的なカスタム URL ボタンおよびリンクの作成
• カスタムボタンとリンク項目
• Lightning Experience での URL パラメータを使用したレポートの絞り込み
• 特定の条件下においてカスタムボタンによる差し込み値に文字化けが発生する
• Apex: EncodingUtil.urlEncode(文字列, ‘UTF-8’)
• Visualforce: URLENCODE(文字列)

一般情報（Salesforce 以外から提供されているもの）

• Mozilla Developers Network: encodeURIcomponent()
• RFC 3986: Uniform Resource Identifier (URI): Generic Syntax (英語)
• RFC 7578: Returning Values from Forms: multipart/form-data (英語)

ご不明な点がございましたら、［ヘルプ&トレーニング］より Salesforce サポートへお問い合わせください。
お客様の影響調査の参考情報として、問題が生じる可能性のあるリクエストURIをご提供することが可能です。

なお、以下のご相談については、Salesforce サポートでは承っておりません。お客様組織の管理者、開発者様、および外部プログラムを開発・保守されているシステムインテグレータ様へお問い合わせください。
 

• リクエストURI以外での、影響が想定される箇所の探索作業
• JavaScript に関する質問
• お客様が利用されいている外部プログラムに関するご相談
• お客様の実装手段に関するご相談