--- title: "接続情報 - Salesforce | TROCCO Docs" slug: "connection-configuration-salesforce" updated: 2026-10-06T09:34:53Z published: 2026-10-06T09:34:53Z canonical: "documents.trocco.io/connection-configuration-salesforce" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.trocco.io/llms.txt > Use this file to discover all available pages before exploring further. # 接続情報 - Salesforce ## 概要 Salesforceの接続情報を設定する際のDocsとなります。 ユーザー・パスワード認証・OAuth認証（従来方式）で接続情報を作成済みのお客様へ 既にユーザー・パスワード認証、またはOAuth認証（従来方式）で作成された接続情報は引き続き利用可能です。 新規に作成できる認証方式は「OAuth認証」（外部クライアントアプリ方式）のみです。従来の認証方式は、Salesforce側の仕様変更により将来的にサポート終了が予定されています。 - ユーザー・パスワード認証は、2027年夏にSalesforce側で廃止が予定されています。 - OAuth認証（従来方式）は、接続アプリケーション（Connected App）を利用します。接続アプリケーションは、Salesforce側の仕様変更により段階的に廃止が進められています。詳細は[Salesforce Platform: Spring '26 リリース以降、新規の接続アプリケーションは作成できなくなります](https://help.salesforce.com/s/articleView?id=005228017&type=1)を参照ください。 既存接続情報の編集画面では、「OAuth認証」「OAuth認証（従来方式）」「ユーザー・パスワード認証」を切り替えられます。サポート終了に備えて「OAuth認証」への切替を推奨します。 ## 入力項目 | 項目名 | 必須 | 内容 | | --- | --- | --- | | 名前 | Yes | TROCCO内部で利用する接続情報の名前を入力してください。 | | メモ | No | TROCCO内部で利用する接続情報のメモを入力してください。 | | 認証方式 | Yes | 外部クライアントアプリのインストールやアカウントの認証を行います。詳しくは[認証の手順](/docs/connection-configuration-salesforce#%E8%AA%8D%E8%A8%BC%E3%81%AE%E6%89%8B%E9%A0%86)を参照ください。 | ## 認証の手順（OAuth認証） 「OAuth認証」（外部クライアントアプリ方式）では、以下の手順で認証を進めてください。 ### 外部クライアントアプリのインストール インストールに必要な権限 外部クライアントアプリのインストールには、インストールを行うユーザーに、Salesforce組織の**「AppExchange パッケージのダウンロード」**権限が必要です。 権限が不足している場合、Salesforceのインストール画面に「このパッケージはインストールできません。」「アクセス権がありません」と表示されます。[権限が不足している場合](/docs/connection-configuration-salesforce#%E6%A8%A9%E9%99%90%E3%81%8C%E4%B8%8D%E8%B6%B3%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E5%A0%B4%E5%90%88)の手順で権限を付与してください。 詳しくは、[Salesforce ヘルプ](https://help.salesforce.com/s/articleView?id=xcloud.distribution_installing_packages.htm&language=ja&type=5)を参照ください。 1. Salesforceのサンドボックス環境に接続する場合、**サンドボックス環境を利用する**にチェックを入れてください。 - 設定を変更した場合は、Salesforceアカウントの認証をやり直してください。 2. **インストール**ボタンをクリックし、画面の指示に従って外部クライアントアプリをSalesforce組織にインストールしてください。 - 認証を別のユーザーで行う場合（[ユーザーの作成](/docs/connection-configuration-salesforce#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90)を参照）は、インストール時にそのユーザーのプロファイルがパッケージにアクセスできるよう設定してください。 #### 権限が不足している場合 権限セットを使って、インストールを行うユーザーに権限を付与してください。権限セットの作成や割り当てができない場合は、Salesforce組織のシステム管理者に依頼してください。 1. 権限セットを作成し、システム権限の**AppExchange パッケージのダウンロード**を有効にします。 2. 作成した権限セットを、インストールを行うユーザーに割り当てます。 権限セットの作成と割り当ての手順は、[Salesforce ヘルプ](https://help.salesforce.com/s/articleView?id=platform.perm_sets_overview.htm&language=ja&type=5)を参照ください。 ### Salesforceアカウントの認証 1. **Salesforceアカウントを連携する**ボタンをクリックし、Salesforceにログインして認証を完了してください。 認証時の権限選択について 認証時にアクセス権の選択画面が表示された場合は、[Salesforce ヘルプ](https://help.salesforce.com/s/articleView?id=xcloud.pkg_subscriber_determine_access.htm&language=ja&type=5)を参照して、適切なアクセス権を設定してください。 #### ユーザーの作成 OAuth認証を行うと、ユーザーの権限をすべてTROCCOが引き受けることになります。以下の手順に従いOAuth認証用の読み込み専用ユーザーを作成し、権限を絞ることをおすすめします。 Salesforceアカウントの認証に利用するユーザーに、外部クライアントアプリのインストール権限は不要です。インストールは、権限を持つ別のユーザーが行えます。 1. Salesforce にログインします。 2. 右上の歯車⚙️アイコンをクリックし、**設定**を選択してください。 3. 左サイドメニューの **管理** > **ユーザー** > **プロファイル** からプロファイル一覧画面を開きます。 4. **新規プロファイル** ボタンをクリックします。 5. 既存のプロファイルに **参照のみ**（Read Only）を選択し、適当な名前（例: trocco-read-only）を設定し、保存します。 - Spring '21 以降に作成された組織には、**参照のみ** プロファイルがありません。詳しくは、[Salesforce ヘルプ](https://help.salesforce.com/s/articleView?id=sf.standard_profiles.htm&language=ja&type=5)を参照ください。 6. プロファイルの編集をクリックし、**標準オブジェクト権限**、**カスタムオブジェクト権限**からTROCCOで参照するオブジェクトについて、**参照**にチェックを付け、保存します。 7. 左サイドメニューの **管理** > **ユーザー** > **ユーザー** からユーザー一覧画面を開きます。 8. **新規ユーザー** ボタンをクリックし、以下の情報を入力します。 1. **ユーザーライセンス**: Salesforce 2. **プロファイル**: 先程作成したプロファイル 3. **メールアドレス**: 確認メールが受取可能なメールアドレスを入力します 9. 保存し、作成は完了です。入力したメールアドレス宛に確認メールが届くので、初回ログインを行ってください。 ## ユーザー・パスワード認証の入力項目 既存の接続情報の編集画面で、ユーザー・パスワード認証を利用する場合の入力項目です。 | 項目名 | 必須 | 内容 | | --- | --- | --- | | ユーザーID | Yes | SalesforceのユーザーIDを入力してください。 | | パスワード | Yes | Salesforceのパスワードを入力してください。 | | セキュリティトークン | Yes | Salesforceのセキュリティトークンを入力してください。 ※作成手順は以下にまとまっております。 | | セールスフォースエンドポイント | No | 認証エンドポイントは環境に合わせて以下のいずれかを入力してください。 - 本番環境（推奨）： `https://<私のドメイン>.my.salesforce.com/services/Soap/u/` - 本番環境（デフォルト）： `https://login.salesforce.com/services/Soap/u/` - Sandbox（推奨）： `https://<私のドメイン>--<環境名>.sandbox.my.salesforce.com/services/Soap/u/` - Sandbox（デフォルト）： `https://test.salesforce.com/services/Soap/u/` SSO利用やセキュリティ制限により汎用URLでログインできない場合は、必ず「私のドメイン」のURLを入力してください。 | ### セキュリティトークンの作成方法 ユーザー・パスワード認証を利用する場合、以下の手順に従ってセキュリティートークンを発行してください。 1. Salesforceにログインしてください。 2. ログイン後、右上のユーザーアイコンをクリックしてください。 3. ユーザー名をクリックし、**設定**をクリックします。 ![image.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/connection-configuration-salesforce-2024-08-29-15-46-0.png) 4. 個人設定画面に遷移したら左メニューの**私の個人情報**から**私のセキュリティトークンのリセット**をクリックしてください。 ![image.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/connection-configuration-salesforce-2024-08-29-15-46-1.png) 5. **セキュリティトークンのリセット**をクリックすることで登録済みのメールアドレスにセキュリティトークンが送信されます。 ![image.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/connection-configuration-salesforce-2024-08-29-15-46-2.png) ## トラブルシューティング ### 無効なセッションIDのため接続に失敗 ``` Error: org.embulk.output.sf_bulk_api.AbortException: [UnexpectedErrorFault [ApiFault exceptionCode='INVALID_SESSION_ID' exceptionMessage='Invalid Session ID found in SessionHeader: Illegal Session. Session not found, missing session hash: ******** This error usually occurs after a session expires or a user logs out. Decoder: DataInDbSessionKeyDecoder' extendedErrorDetails='{[0]}']] ``` #### 考えられる原因 - 複数のジョブが同時に実行されている場合、一方のジョブが終了するタイミングでセッションが無効化され、接続に失敗します。 - 複数のツールから同一アカウントにログインしている場合、セッションが共有されます。そのため、いずれかのツールでログアウトを行うと、共有されている他のセッションも無効化され、接続に失敗します。 #### 対処法 - 同一の接続情報を使用しているタスクの同時実行を避ける - 複数のタスクを同時に実行する場合 - ワークフロー機能を利用して、タスク同時実行上限数を「1」に設定し、接続情報が同時に使用されないように制御してください。 - 異なるワークフロー内にSalesforceを使用しているタスクが含まれている場合 - それぞれのワークフローが同時に実行されないよう、実行時間を調整してください。 - TROCCO以外のツールから同一アカウントへのアクセスを避ける - TROCCO専用のアカウントを作成し、セッションが共有される状況を防いでください。