Salesforce
SalesforceをSquadbaseに接続するための手順と必要情報の取得方法
必要情報
| 項目 | 説明 |
|---|---|
| Instance URL | Salesforce 組織の私のドメイン URL です（例：https://yourorg.my.salesforce.com）。設定 → 会社の設定 → 私のドメイン から確認できます。 |
| Consumer Key | 外部クライアントアプリケーションのコンシューマー鍵（client_id）です。OAuth 2.0 クライアントログイン情報フローを有効にし、実行ユーザーを設定する必要があります。 |
| Consumer Secret | 外部クライアントアプリケーションのコンシューマーの秘密（client_secret）です。 |
前提条件
- 利用中の Salesforce エディションが外部クライアントアプリケーションをサポートしていること。Starter・Pro Suite エディションでは利用できません。
- アプリに設定する実行ユーザーが API アクセス権を持っていること。
取得方法
Instance URL
Salesforce にログインし、右上の 歯車アイコン から 設定 を選択します。
左サイドバーの 会社の設定 → 私のドメイン を開き、現在の「私のドメイン」の URL をコピーしてください（例：https://yourorg.my.salesforce.com）。
Consumer Key / Consumer Secret
外部クライアントアプリケーションマネージャーを開く
設定の左サイドバーから アプリケーション → 外部クライアントアプリケーション → 外部クライアントアプリケーションマネージャー を開きます。
右上の 新規外部クライアントアプリケーション をクリックします。
メニューが見つからない場合は、左サイドバー上部のクイック検索ボックスに「外部クライアントアプリケーション」と入力してください。それでも候補が出ない場合は、利用中のエディションでこの機能が提供されていない可能性があります。
基本情報を入力する
必要な情報を入力します。
- 外部クライアントアプリケーション名：任意の名前（例：
Squadbase） - API 参照名：名前に応じて自動で入力されます
- 取引先責任者メール：メールアドレスを入力
OAuth 設定を行う（「設定」タブ）
OAuth 設定 セクションを展開し、以下を設定します。
- OAuth を有効化 にチェックを入れる
- コールバック URL：
https://app.squadbase.dev/を入力 - OAuth 範囲 の「選択した OAuth 範囲」に以下を追加：
- API を使用してユーザーデータを管理 (
api) - いつでも要求を実行 (
refresh_token, offline_access)
- API を使用してユーザーデータを管理 (
フローの有効化 セクションで：
- クライアントログイン情報フローを有効化 にチェックを入れる
セキュリティ セクションで：
- 「サポートされる認証フローに Proof Key for Code Exchange (PKCE) 拡張を要求」のチェックを外す
保存します。
「クライアントログイン情報フローを有効化」のチェックは「設定」タブで先に行い、保存する必要があります。 この手順を済ませておかないと、次の「ポリシー」タブに「（ユーザー名）として実行」欄が表示されません。
PKCE のチェックを必ず外してください。 チェックが入ったまま保存すると、Squadbase からの接続時に invalid_grant エラーが発生します。
ポリシーを設定する（「ポリシー」タブ）
「設定」タブを保存したら、ポリシー タブを開いて 編集 ボタンをクリックします。
OAuth フローおよび外部クライアントアプリケーションの機能強化 セクションで：
- クライアントログイン情報フローを有効化 にチェックが入っていることを確認する
- （ユーザー名）として実行：API アクセス権を持つ Salesforce ユーザーのメールアドレスを指定する（通常はシステム管理者のメールアドレスで問題ありません）
保存します。
「（ユーザー名）として実行」の設定は必須です。 空のまま保存してもエラーにはなりませんが、Squadbase からの API 接続時に失敗します。
コンシューマー鍵と秘密をコピーする
アプリの 設定 タブを開き、OAuth 設定 セクションを展開します。
コンシューマー鍵と秘密 ボタンをクリックします。メール確認画面が表示された場合は本人確認を行ってください。
表示された コンシューマー鍵 と コンシューマーの秘密 をコピーしてください。
よくあるエラーと対処法
「Client Credentials Flow 用のユーザーが有効化されていない」
- 原因：「設定」タブで「クライアントログイン情報フローを有効化」にチェックが入っていないか、「ポリシー」タブの「（ユーザー名）として実行」が空のまま。
- 対処：手順 3・4 を確認してください。「設定」タブを保存してから「ポリシー」タブを編集してください。
invalid_client_id
- 原因：コンシューマー鍵が誤っているか、アプリが無効になっている。
- 対処：ポリシータブで アプリケーションの状態 が 有効 であることを確認してください。
invalid_grant
- 原因：PKCE が必須に設定されている。
- 対処：「設定」タブの OAuth 設定 → セキュリティセクションで「サポートされる認証フローに PKCE 拡張を要求」のチェックを外してください。