Identity 実装ガイド
j[私のドメイン] を実装するためのガイドラインとベストプラクティス
次のヒントにより、[私のドメイン] で作成したサブドメインを使用することに円滑に移行できます。
| 使用可能なインターフェース: Salesforce Classic および Lightning Experience の両方 |
| 使用可能なエディション: Essentials、Performance、Unlimited、Enterprise、Developer、Professional、および Group Edition |
- リリースする前に今後の変更をユーザに通知します。
- トラフィックが少ないときにトラブルシューティングができるように、組織で受信するトラフィックが最小になるタイミング (週末など) に新しいサブドメインをリリースします。
- ボタンや Visualforce ページなどを使用して組織をカスタマイズした場合、変更を徹底的にテストしてください。ハードコード化された参照のために破損したリンク (https://na30.salesforce.com などのインスタンスベースの URL) を探します。これらの URL を代わりにサブドメインを使用するように変更します。詳細は、Salesforce ヘルプに「ハードコード化された参照」と入力してください。最初に Sandbox 環境でテストします。
- [私のドメイン] サブドメインをリリースする前に、すべてのアプリケーション URL を更新していることを確認します。たとえば、Chatter アンサーの [メール通知 URL] オプションを更新しないと、古い URL で通知を内部ユーザに送信し続けます。
- [私のドメイン] サブドメインが登録されたが、リリースされていない場合に [私のドメイン] ログインページからログインすると、URL にサブドメイン名が示されます。ただし、ワークフローメールなど非同期で送信されるメールに埋め込まれている差し込み項目から作成されたリンクには、依然として古い URL が使用されます。ドメインのリリース後は、上記のようなリンクにも新しい [私のドメイン] URL が表示されます。
- 頻繁に使用するページ (ログインページなど) へのリンクを提供して、ユーザが新しいサブドメイン名の使用を開始できるようにサポートします。ログインポリシーが変更されたことをユーザに通知して、ユーザが初めてリダイレクトされたときにブックマークを更新するように促します。
- リダイレクトポリシーの [ドメイン内の同じページに警告付きでリダイレクト] オプションを選択して、ユーザがブックマークを新しいサブドメイン名に更新する猶予期間を設けます。数日または数週間が経過したら、ポリシーを [未リダイレクト] に変更します。このオプションは、ページを表示するときにサブドメイン名を使用するようユーザに要求します。これはセキュリティレベルが最も高いオプションです。
- [https://login.salesforce.com からログインできないようにする] は、サブドメインを認識していないユーザがそのドメインを使用するのではないかと懸念される場合にのみ使用します。それ以外の場合は、ユーザが新しいドメイン名に慣れるまでの間このオプションを使用できるようにしておきます。
- パートナーポータルに [ドメイン内の同じページにリダイレクト] が選択されている場合はブックマークが機能しません。既存のブックマークを手動で変更し、Salesforce インスタンス名を [私のドメイン] サブドメイン名に置き換えることによって、新しいサブドメイン URL を参照するようにします。たとえば、ブックマークの URL にある https://na30.salesforce.com/ を https://yourDomain.my.salesforce.com/ に置き換えます。
- 新しい Salesforce サブドメイン URL を使用していないアプリケーションページ要求をブロックする場合は、ユーザに、以前のブックマークを更新するか、ログインページの新しいブックマークを作成する必要があることを通知します。ユーザはアプリケーション内のタブやリンクも更新する必要があります。ログインリダイレクトポリシーを [未リダイレクト] に変更する場合は、ユーザが直ちに新しいサブドメイン URL を使用する必要があります。
- [私のドメイン] を使用する場合は、いつどのユーザが新しいログイン URL でログインしているかを識別できます。[設定] から、[クイック検索] ボックスに「ログイン履歴」と入力し、[ログイン履歴] を選択して、[ユーザ名] 列と [ログイン URL] 列を表示します。
- login.salesforce.com ページで、ユーザは [カスタムドメインにログインする] をクリックし、[私のドメイン] サブドメイン名を入力してログインできます。この場合、ユーザがサブドメイン名を認識している必要があります。安全を期すために、サブドメインのログインページへのダイレクトリンクをユーザに配布します。
- ユーザがユーザ名とパスワードを入力するデフォルトのログインページを使用する代わりに、私のドメインのログイン検出ページを設定できます。このログインページでは、ユーザは、メールアドレス、電話番号、またはその他の識別子を最初に入力してログインできます。入力後、認証されます。
- 代替として、Salesforce URL を変更して標準ログインページにアクセスすることもできます。(標準ログインページでは、ユーザのユーザ名とパスワードの入力が求められます。)URL クエリ文字列のパラメータとして login を追加できます。たとえば、https://northerntrailoutfitters-dev-ed.my.salesforce.com/?login のように追加できます。URL に login=true を追加することもできます。たとえば、https://northerntrailoutfitters-dev-ed.my.salesforce.com/?login=true のように追加できます。
|
使用している要素 |
実行すること |
|---|---|
|
組織への API インテグレーション |
API クライアントがサーバエンドポイントを直接参照するかどうかを確認します。API クライアントには、ログイン要求で返された LoginResult.serverURL 値を使用します。ハードコード化されたサーバ URL は使用しないでください。 サブドメインのリリース後、Salesforce がサブドメイン名を含むサーバ URL を返します。リダイレクトポリシー設定が API コールに影響することはありません。つまり、インスタンス URL への従来のコールも継続して機能します。ただし、ベストプラクティスは、Salesforce から返された値を使用することです。 |
|
メールテンプレート |
組織のインスタンス URL への参照をサブドメインに置き換えます。 |
|
カスタム Visualforce ページまたはカスタムアプリケーション |
組織のインスタンス URL への参照をサブドメインに置き換えます。「How to find hard-coded references with the Force.com IDE」を参照してください。 |
|
Chatter |
Chatter グループにリストされたすべてのブックマークを更新するようにユーザに通知します。 |
|
コミュニティのゾーン (アイデア/アンサー/Chatter アンサー) |
メール通知 URL を更新します。 URL を更新するには、既存の URL をクリアして項目を空白にし、ページを保存します。その後、システムが項目に新しい [私のドメイン] の URL を入力します。 |