接続アプリケーションの作成

• [ロゴ画像をアップロード] をクリックして、独自のロゴ画像をアップロードできます。ローカルファイルシステムからロゴのサイズ要件を満たす画像を選択します。アップロードが成功すると、ロゴへの URL が [ロゴ画像 URL] 項目に表示されます。表示されない場合は、ロゴのサイズ要件を満たしていることを確認します。
• [いずれかのサンプルロゴを選択] をクリックして、Salesforce のサンプルからロゴを選択することもできます。Salesforce アプリケーション、サードパーティアプリケーション、標準化団体のロゴなどが含まれます。目的のロゴをクリックし、URL をコピーして [ロゴ画像 URL] 項目に貼り付けます。
• [ドキュメント] タブから画像をドキュメントとしてアップロードすることで、Salesforce サーバで公開されてホストされるロゴを使用できます。画像を表示して URL を取得し、その URL を [ロゴ画像 URL] 項目に入力します。

��常、この URL は、認証が成功した後にユーザのブラウザがリダイレクトされる URL であり、使用する OAuth フローによって決まります。この URL は一部の OAuth フローでアクセストークンを渡すために使用されるため、URL でセキュア HTTPS またはカスタム URI スキームを使用する必要があります。複数のコールバック URL を入力すると、実行時に Salesforce は、アプリケーションで指定されたコールバック URL の値を [コールバック URL] のいずれかの値と照合します。検証テストに通過するには、いずれか 1 つの値と一致する必要があります。複数のコールバック URL は、改行で区切ります。

コールバック URL 項目には、累積で 2000 行までという制限があります。複数の URL があってこの制限を超えた場合は、追加のコールバック URL を管理できるように、別の接続アプリケーションを作成します。

• ID トークンはアクセストークン応答に常に含まれます。
• プライマリ ID トークン設定を有効にした状態で、アクセストークン応答と更新トークン応答の両方で ID トークンコンテンツを制御するセカンダリ設定を構成します。次の設定を指定します。

  トークンの有効期間

  ID トークンの発行後、ID トークンが有効な期間。指定できる期間は 1 ～ 720 分です。デフォルトは 2 分です。

  ID トークンの利用者

  ID トークンの対象コンシューマ。たとえば、ID トークンを使用する対象サービス (https://your_service.com など) です。

  標準要求を含める

  ユーザの名前、プロファイル、電話番号、住所など、ユーザに関する情報を含む標準要求を含めます。「OpenID Connect の仕様」では、ID トークンで返される、一連の標準要求が定義されます。

  カスタム属性を含める

  アプリケーションでカスタム属性を指定した場合は、そのカスタム属性を ID トークンに含めます。

  カスタム権限を含める

  アプリケーションでカスタム権限を指定した場合は、そのカスタム権限を ID トークンに含めます。

• 次の設定を指定します。

  トークンの有効期間

  アセットトークンの発行後、アセットトークンが有効な期間。

  アセット署名証明書

  アセットトークンを署名するためにすでに作成している自己署名証明書。

  アセット利用者

  アセットトークンの対象コンシューマ。例: 接続デバイスのバックエンドサービス (https://your_device_backend.com など)。

  カスタム属性を含める

  アプリケーションでカスタム属性を指定した場合は、そのカスタム属性をアセットトークンに含めます。

  カスタム権限を含める

  アプリケーションでカスタム権限を指定した場合は、そのカスタム権限をアセットトークンに含めます。

• コールバック URL (エンドポイント) を指定します。たとえば、https://your_device_backend.com/callback です。
• アセットトークンで必要とされる OAuth 範囲を選択したことを確認します。
  • データへのアクセスと管理 (api)
  • 一意の識別子へのアクセスを許可 (openid)

• 署名付き要求 (POST) — OAuth 認証を使用しますが、Salesforce システム管理者がキャンバスアプリケーションをインストールする場合、キャンバスアプリケーションはユーザのアクセスを暗黙的に許可します。ユーザ情報へのアプリケーションのアクセスを許可するよう求めるプロンプトはユーザに表示されません。このアクセス方法を使用する場合、認証はキャンバスアプリケーションの URL に直接 post 送信されます。

  キャンバスアプリケーションで署名付き要求認証を使用する場合は、[ユーザに代わっていつでも要求を実行] を [選択した OAuth 範囲] に選択しないでください。

• OAuth Webflow (GET) — OAuth 認証が使用され、ユーザはユーザ情報へのアプリケーションのアクセスを許可するように求められます。このアクセス方法を使用する場合、キャンバスアプリケーションで OAuth 認証フローが開始されるようにする必要があります。

• ID プロバイダによる開始 — Salesforce が SSO フローを開始する最初の要求を行います。
• サービスプロバイダによる開始 — キャンバスアプリケーションは呼び出された後に SSO フローを開始します。

• Chatter フィード — キャンバスアプリケーションをフィードに表示します。このオプションを選択すると、CanvasPost フィード項目を作成して現在のユーザがキャンバスアプリケーションにアクセスできるようにします。
• Chatter タブ — キャンバスアプリケーションを Chatter タブのアプリケーションナビゲーションリストに表示します。このオプションを選択すると、キャンバスアプリケーションが自動的に表示されます。
• コンソール — キャンバスアプリケーションを Salesforce コンソールのフッターまたはサイドバーに表示します。このオプションを選択した場合、キャンバスアプリケーションをカスタムコンソールコンポーネントとして追加して、コンソールのどこにキャンバスアプリケーションを表示するのかを選択する必要があります。
• レイアウトおよびモバイルカード — キャンバスアプリケーションをページレイアウトまたはモバイルカードに表示できます。このオプションを選択した場合、キャンバスアプリケーションをページレイアウトに追加して、表示する場所を選択します。
• モバイルナビゲーション — キャンバスアプリケーションを Salesforce アプリケーションのナビゲーションメニューからアクセス可能にします。

  キャンバスアプリケーションは、Salesforce for Android のアプリケーションナビゲーションメニューには表示されません。キャンバスアプリケーションをナビゲーションメニューに表示するには、Salesforce モバイル Web にログインします。

  メモ

• Open CTI — キャンバスアプリケーションを通話制御ツールに表示します。このオプションを選択した場合、キャンバスアプリケーションを表示するにはコールセンターの定義ファイルにキャンバスアプリケーションを指定します。
• パブリッシャー — キャンバスアプリケーションをパブリッシャーに表示します。このオプションを選択した場合、キャンバスカスタムクイックアクションを作成して、グローバルレイアウトまたはオブジェクトレイアウトに追加します。
• Visualforce ページ — キャンバスアプリケーションを Visualforce ページに表示できます。Visualforce ページにキャンバスアプリケーションを公開するために <apex:canvasApp> コンポーネントを追加する場合は、キャンバスアプリケーションの表示場所にこの場所を必ず選択してください。これ以外の場所を選択するとエラーになります。