Salesforce

Salesforce への接続は、OAuth 認証を使用して設定できます。
接続設定を行うには、事前に Salesforce で外部クライアントアプリケーションを作成し、コンシューマー鍵とコンシューマー秘密を取得する必要があります。

入力する項目

項目	必須	最初に入っている値	説明
接続情報の名前	○	`Salesforce接続情報`	一覧に出る名前
コンシューマー鍵	○	空	Salesforce の外部クライアントアプリケーションで発行する
コンシューマーの秘密	○	空	同上
環境		Production	Production か Sandbox（下記）。どちらかが必ず選ばれているので、必須の印は付きません

欄の下に認証を始めるボタンがあります。

接続環境について

Salesforce には 2 つの環境があります：

Production（本番環境）: 実際の業務で使用している環境です。本番データへのアクセスが必要な場合はこちらを選択します。
Sandbox（開発環境）: テストや開発用の環境です。本番環境の複製で、安全にテストやデータ確認を行いたい場合はこちらを選択します。

接続情報入手手順

nehan から Salesforce に接続するには、事前に Salesforce 側で外部クライアントアプリケーションを作成する必要があります。

Salesforce にログイン
右上の歯車アイコンから「設定」をクリック
左メニューの「アプリケーション」→「アプリケーションマネージャー」をクリック
右上の「新規外部クライアントアプリケーション」をクリック
基本情報を入力
- 外部クライアントアプリケーション名
- API 参照名
- 取引先責任者メール
下部の「API（OAuth 設定の有効化）」を開いて「OAuth の有効化」にチェック
アプリケーション設定を行う
- コールバック URL（nehan on 御社 AWS 環境ではnehan on 御社AWSを変更して入力ください）
  - https://sunfish.nehan.io/oauth/callback/salesforce
- OAuth 範囲（以下を選択して追加）
  - API を使用してユーザーデータを管理 (api)
  - いつでも要求を実行 (refresh_token, offline_access)
- フローの有効化（以下にチェック）
  - トークン交換フローを有効化
  - トークン交換フローの秘密が必要
- セキュリティ（以下にチェック）
  - Web サーバーフローの秘密が必要
  - 更新トークンフローの秘密が必要
「作成」をクリック
作成したアプリのページの「設定」タブをクリック
下部の「OAuth 設定」をクリック
「コンシューマー鍵と秘密」をクリック
コンシューマー鍵とコンシューマー秘密の値をコピー

操作

nehan での接続設定

Salesforce で取得したコンシューマー鍵とコンシューマー秘密を使用して、nehan で接続設定を行います。

「接続情報の新規作成」で「Salesforce」を選択
接続情報の名前を入力
Salesforce接続情報 が入った状態で開きます。この名前のまま接続情報が作られるので、先に分かりやすい名前に変えておきます。
認証情報を入力
- コンシューマー鍵：Salesforce で取得した値を入力
- コンシューマーの秘密：Salesforce で取得した値を入力
接続環境の選択
Production（本番環境）または Sandbox（開発環境）を選択します。
「認証を始める」をクリック
この時点で、入力した内容のまま接続情報が作られます。
Salesforce の認証画面でログインと同意を行う
Salesforce のログイン画面に遷移します。
お使いの Salesforce アカウントでログインし、アプリケーションへのアクセスを許可してください。
nehan の画面に戻る
認証が通ると、作られた接続情報の編集画面が自動で開きます。名前を直したいときは、ここで書き換えて保存をクリックします。

編集

接続名の変更や、認証情報（コンシューマー鍵・コンシューマーの秘密）の更新、接続環境の変更が可能です。

編集する項目を変更
- 接続名
- コンシューマー鍵：Salesforce で取得した値を入力
- コンシューマーの秘密：Salesforce で取得した値を入力
- 環境：Production（本番環境）または Sandbox（開発環境）を選択
再認証が必要な場合
認証情報や環境を変更した場合は、「認証を始める」ボタンから再度 Salesforce の認証を行ってください。
保存
変更内容を確認して、保存ボタンをクリックします。