Salesforce と dejiren AI の接続設定方法

このページでは、Salesforce と dejiren AI の接続設定方法について説明します。

前提条件・必要な権限

サービス名必要な権限権限が必要な場面
Salesforceシステム管理者権限Salesforce での API 利用許可設定
Salesforce一般利用者権限外部ユーザー割り当て
作業用PC管理者権限SSL 証明書の発行
dejiren AIVA編集権限
（VA管理者、もしくはVA編集者）		接続設定の新規作成
dejiren AI利用者権限外部ユーザー割り当て

※ 作業用 PC として WindowsPC をご利用の場合
　標準状態では SSL 証明書を発行するための機能がインストールされていません。
　あらかじめ OpenSSL 等をインストールした上で作業を実施してください。

設定作業の流れ

設定手順

手順1. SSL 電子証明書ファイルの発行

Windows をご利用の方は [コマンドプロンプト] を、 macOS をご利用中の方は [ターミナル]
などのコマンド実行環境を用いて、 SSL証明書を作成します。

1. ターミナルソフトウェアを管理者権限で起動します。

2. ターミナルの編集画面に、SSL 証明書発行のコマンドを下記の通り入力して実行します。
◆改行せず、一つのつながった文字列としてコピーし、
　 ターミナルソフトウェアに転記して Enter キーを押下します。

openssl req -x509 -sha256 -nodes -days 3650 -newkey rsa:2048 -subj /CN=localhost -keyout server.key -out server.crt

3. コマンドを実行した領域に、[ server.crt ]と[ server.key ]のファイルが生成されます。

※ WindowsPC の場合、コマンドの実行結果は表示されません。
※ WindowsPC で管理者権限でコマンドの初期実行領域は
　[ C:￥Windows￥System32 ]です。
※ macOS での初期ディレクトリは、ユーザーのホーム
　[ username@Mac ~ % ]です。

コマンド実行結果の出力先を指定されない場合には上記の領域にファイルが生成されます。
保存先を指定されている場合や、コマンド実行前に領域を移動されている場合にはこの限りではありません。
◆ これらのファイルは、Salesforce アプリケーション作成、dejiren AI 接続設定作成の手順でそれぞれ利用します。

手順2. Salesforce に新規接続アプリケーションを作成

※ すでに接続アプリケーションでオンライン認証が完了している接続はそのままご利用いただけます。
　 PKCE のチェックをオンにし直す作業もdejiren AI 側の再設定も不要です。
　 PKCE のチェックがオフのままでも接続できます。

※ 新しくアプリを作成する場合は「接続アプリケーション」ではなく「外部クライアントアプリケーション」を作成してください。接続アプリケーションの新規作成は、Salesforce 側で停止されています。

1. ご利用中の Salesforce 環境に、Salesforce の管理者権限を保有するアカウントでログインし、
　 Lightning Experienceアプリケーションマネージャーのページにアクセスしてください。
　 (⚙ 設定 → アプリケーション → 外部クライアントアプリマネージャ)

2. [新規]をクリックし、外部クライアントアプリケーションの新規作成画面を開きます。

3. 各項目の値を設定し、最後に[保存]をクリックします。

設定項目設定値
外部クライアントアプリケーション名任意の識別名称を文字入力します。
API参照名（◆アプリケーション名を入力すると同一文字列が自動的に補完されます）
取引先責任者メール接続設定を管理するVA管理者のメールアドレスを入力します。
OAuth設定の有効化チェックを付けます。
コールバックURLhttps://www.dejiren.com/api/va/v1/oauth-callback　を転記入力します。
選択した OAuth 範囲・フルアクセス（full）
・いつでも要求を実行（refresh_token, offline_access）
の2つを追加します。
（※ 画面に「フルアクセス（full）」が表示されない場合は、「API を使用してユーザーデータを管理（api）」を選択してください。）
JWT ベアラーフローを有効化チェックを付けます。
証明書のアップロード手順1で作成した [server.crt] をアップロードします。
指定ユーザー向けに JWT ベースのアクセストークンを発行チェックを付けません。
（オフのままにします。）
サポートされる認証フローに Proof Key for Code Exchange (PKCE) 拡張を要求チェックは付けたままにします。
（※初期状態でチェックが付いています。2026年7月以降に作成したアプリでは、このチェックは外せません。）
PKCE のチェックはオンのままにしてください。オフの既存アプリでも、チェックをオンにせず接続できます。
Webサーバーフローの秘密が必要チェックを付けます。（オンのまま変更しません。）
（※初期状態でチェックが付いています。）
更新トークンフローの秘密が必要チェックを付けます。
（※初期状態でチェックが付いています。）
配布状態[ローカル] を選択します。

4. 作成後、アプリケーションの詳細画面に移動して、
　 設定の[コンシューマー鍵と秘密]を開きます。

5. [ID を検証]画面が表示されます。
　 同時に、管理者宛に認証コードを記載したメールが送信されるので、
　 本文に記載された値を転記して、[検証]をクリックします。

6. [コンシューマー鍵と秘密]画面に遷移します。
　 表示された[コンシューマー鍵]と[コンシューマーの秘密]の文字列を控えます。

7. アプリの[ポリシー]タブを開き、[編集]をクリックします。
　 [OAuth ポリシー]－[許可されているユーザー]を[管理者が承認したユーザーは事前承認済み]に変更します。
　 確認ダイアログが表示された場合は、[はい]をクリックします。

8. [ポリシー]タブで、VAを使用するユーザーについて、
　 Salesforceから付与されているものと同じプロファイル（もしくは権限セット）にチェックを付けます。

9. [保存]をクリックします。
※ [ポリシー]タブの保存は、設定タブとは別に行います。

手順3. dejiren AI に接続設定を作成

1. dejiren AI のバーチャルアシスタント (VA) 管理画面にアクセスします。
　 https://www.dejiren.com/va

2. 画面上部の[接続設定]をクリックします。

3. [接続設定]ページで[新規作成]をクリックします。

4. [新しい接続設定をつくる]ダイアログが表示されるので、
　 [Salesforce]を選択して、[つぎへ]をクリックします。

5. 接続設定の各項目を設定します。

設定項目設定値備考
接続名この接続設定を識別する任意の名称を文字入力します。必須入力
X509証明書の非公開鍵手順1で発行した[server.key]をアップロードします。必須入力
コンシューマ鍵手順2-6
[コンシューマー鍵と秘密]で控えた
[コンシューマー鍵]の値を転記します。		必須入力
コンシューマの秘密手順2-6
[コンシューマー鍵と秘密]で控えた
[コンシューマーの秘密]の値を転記します。		必須入力
認証サーバーのURL接続するSalesforceのURLを転記します。
標準URLである[https://login.salesforce.com]が初期入力されます。		必須入力
ユーザー名（入力不要）オンライン認証後に自動補完されます。
組織ID（入力不要）オンライン認証後に自動補完されます。
組織名（入力不要）オンライン認証後に自動補完されます。
APIバージョン設定時点で最新のものを選択します。
個人認証 － ユーザーごとに認証が必要チェックを付けます。Salesforceは個人認証必須です。

6. すべての項目の入力が完了したら、[作成後にオンライン認証]をクリックします。

7. 接続確認ダイアログが表示されるので、[連携先につなぐ]をクリックします。

8. Salesforce のログイン画面が表示されるので、
　 API利用可能な Salesforce アカウントのIDとパスワードを入力します。

9. 正常に接続できると、[接続完了しました]というメッセージが表示されるので、[閉じる]をクリックします。

10. 設定が完了し、接続設定一覧画面に戻ります。

以上で設定は完了です。 これで Salesforce が dejiren AI から利用できる状態となりました。Salesforce と連携する VA を作成してください。

#Salesforce #sf #SFA #セールスフォース #接続設定 #コネクタ

前の説明
一覧に戻る
次の説明