Workiva サポートセンター

Salesforce® コネクターを使用すると、コマンド を使用して、チェーンの一部として Salesforce と対話することができます。例えば、このコネクターを使えば、次のことができる：

• SOQLおよび一括操作によるSalesforceへのデータのアップロード、抽出、削除
• Salesforceオブジェクトの作成と管理
• Salesforceのレコードの更新と作成

このコネクターは、Salesforce Sales Cloudのすべてのバージョンと相互作用します：

• セールスフォース・エッセンシャル
• セールスフォース・ネット・ゼロ・クラウド
• ライトニング®プロフェッショナル
• ライトニング・エンタープライズ
• ライトニング・アンリミテッド

メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。

要件

組織でコネクターを使用できるようにするには、組織のセキュリティ管理者がまずコネクターを有効にする必要があります 。

次に、次のいずれかの方法で Salesforce への接続を保護します：

• クライアントID、シークレット、スコープを使用したSalesforce OAuth認証
• ユーザー名とパスワードを使った基本認証
• クライアントの認証情報（クライアント ID とシークレットのみを使用）
   

セールスフォースOAuth認証

Workiva に接続するには、Salesforce のクライアント ID およびシークレット と、接続アプリのOAuth スコープが必要です。

OAuth 認証を行うには、Salesforce 接続アプリの使用が別途必要となります。Salesforce でこのアプリを作成するには、 にアクセスし、アプリを設定して、以下の必須設定を行ってください。

• 「」のコールバック URL（ ）には、お使いの AppSpot に合わせて、以下のいずれかを入力してください：
  • 米国、中米、南米： https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC： https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • カナダ： https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EMEA： https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
• Selected OAuth Scopesの下に、Perform requests on your behalf at any time (refresh_token, offline_access)とat least one other scopeを含みます。
   

基本認証

Workiva に接続するには、統合ユーザーのユーザー名、パスワード、および Salesforce からのセキュリティトークン が必要です。

基本認証には、コネクターが実行するタスクに関連する権限に加えて、API を有効にする権限を持つ統合ユーザーが必要です。

メモ: Salesforce で統合ユーザーの権限を設定するには、Administer 、Manage Users 、Profiles を選択し、プロファイルを選択します。

1. 「」の「管理権限」 で、「API を有効にする」を選択します。
2. コネクターがコマンドを実行できるようにするには、ユーザーはその関連データに対して少なくともRead 権限が必要です。 
3. Salesforce オブジェクトの一括更新を実行するには、ユーザはオブジェクトに対して編集 権限が必要です。
    

クライアント・クレデンシャル認証

Workiva に接続するには、Salesforce のクライアント ID とシークレット が必要です。

クライアント認証情報による認証を行うには、Salesforce 接続アプリの使用が必要です。Salesforce でこのアプリを作成するには、にアクセスし、のクライアント認証情報フロー（ ）を使用して、アプリ を設定してください。

OAuth認証用のSalesforceコネクターの設定

OAuth 認証では、クライアント ID とシークレットを使用して Salesforce に使用することができます。クライアント認証によるログインとは異なり、OAuth認証は更新トークンを含み、スコープを必要とします。

この方法は、クライアント認証情報を使う方法では時間切れになってしまうような、実行時間の長いコマンドに推奨される。

1. の「Chain Builder」 から、左側のサイドバーにある「compare_arrows Connections」 をクリックし、次に右上の「compare_arrows Create」 をクリックします。
2. コネクタ接続 で、Salesforce とデフォルトの CloudRunner を選択します。
3. 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。

4. 「のプロパティ」 で、接続先のSalesforceインスタンスまたはカスタムドメインを入力します：

   プロパティ	詳細
   インスタンス	接続先のSalesforceインスタンスを入力します。組織でSalesforceのカスタムドメインを使用している場合は、このフィールドを空白のままにしてください。 メモ: Salesforce の URL では、salesforce.comの前の文字 (na73など) がインスタンスを表します。
   カスタムドメイン	接続先のカスタム Salesforce ドメインを使用する場合は入力します。 メモ： Salesforce でカスタマイズドメインをビューするには、会社設定 、マイドメイン を選択します。カスタムドメインは通常、.my.salesforce.com で終わります。

5. 認証タイプ」は、Salesforce OAuth を選択します。

6. の「Authentication」（ ）で、クライアントID、シークレット、スコープを入力し、の「Connect」（ ）をクリックします。
   

   注： Salesforceへの接続に成功すると、コネクタのの「リフレッシュトークン」（ ）およびの「アクセストークン」（）が自動的に入力されます。接続に失敗した場合は、Stop をクリックし、再接続を待つ。

   メモ： すべての機密情報は自動的に暗号化され、AES-256暗号化で保存されます。

7. 接続に使用する環境を選択し、保存します。
8. 接続をテストするには、 コネクターのList Reportsコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。

ベーシック認証用のSalesforceコネクターの設定

基本認証では、統合ユーザのユーザ名とパスワードを使用して Salesforce にログインできます。

1. の「Chain Builder」 から、左側のサイドバーにある「compare_arrows Connections」 をクリックし、次に右上の「compare_arrows Create」 をクリックします。
2. コネクタ接続 で、Salesforce とデフォルトの CloudRunner を選択します。
3. 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。

4. 「のプロパティ」 で、接続先のSalesforceインスタンスまたはカスタムドメインを入力します：

   プロパティ	詳細
   インスタンス	接続先のSalesforceインスタンスを入力します。組織がカスタム Salesforce ドメインを使用している場合は、空白のままにします。 メモ: Salesforce の URL では、salesforce.comの前の文字 (na73など) がインスタンスを表します。
   カスタムドメイン	接続先のカスタム Salesforce ドメインを使用する場合は入力します。 メモ： Salesforce でカスタマイズドメインをビューするには、会社設定 、マイドメイン を選択します。カスタムドメインは通常、.my.salesforce.com で終わります。

5. 認証タイプは、Basic Auth を選択する。

6. 認証 で、統合ユーザーのユーザー名、パスワード、セキュリティトークンを入力します。

   注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。

7. 接続に使用する環境を選択し、保存します。
8. 接続をテストするには、 コネクターのList Reportsコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
    

クライアント認証情報用の Salesforce コネクターの設定

クライアント認証では、クライアント ID とシークレットを使用して Salesforce にアクセスします。これは OAuth ログイン方法とは異なり、スコープを必要としないため、Connect ボタンを使用して Salesforce に認証する必要はありません。 

警告 ：この認証方法には更新トークンが含まれていません。このため、長時間実行するコマンドには適しておらず、特定のチェーンではタイムアウトにつながる可能性がある。

1. の「Chain Builder」 から、左側のサイドバーにある「compare_arrows Connections」 をクリックし、次に右上の「compare_arrows Create」 をクリックします。
2. コネクタ接続 で、Salesforce とデフォルトの CloudRunner を選択します。
3. 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。

4. 「のプロパティ」 で、接続先のSalesforceインスタンスまたはカスタムドメインを入力します：

   プロパティ	詳細
   インスタンス	接続先のSalesforceインスタンスを入力します。組織がカスタム Salesforce ドメインを使用している場合は、空白のままにします。 注： SalesforceのURLにおいて、salesforce.com の前の文字（na73など）は、インスタンスを表しています。
   カスタムドメイン	接続先のカスタム Salesforce ドメインを使用する場合は入力します。 メモ： Salesforce でカスタマイズドメインをビューするには、会社設定 、マイドメイン を選択します。カスタムドメインは通常、.my.salesforce.com で終わります。

5. 認証タイプでは、Client Credentials を選択する。

6. Authentication で、クライアントIDとシークレットを入力する。

   メモ： すべての機密情報は自動的に暗号化され、AES-256暗号化で保存されます。

7. 接続に使用する環境を選択し、保存します。
8. 接続をテストするには、 コネクターのList Reportsコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。

トラブルシューティング

Salesforce への接続に失敗した場合は、認証タイプに応じていくつかの構成設定を確認できます。

 

OAuth2認証

最初にConnect をクリックしたときに Salesforce 接続アプリへの接続に失敗した場合は、Stop をクリックし、再度接続するのを待ちます。OAuth2認証を使用しても接続に失敗し続ける場合：

• コネクターに正しい Salesforce インスタンスまたはカスタマイズ ドメインが入力されていることを確認します。
• コネクターが使用する Salesforce 接続アプリのクライアント ID とシークレットを確認します。
• Salesforce接続アプリで：
  • コールバックURLが正しいことを確認してください：
  • 米国、中米、南米向け： https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC向け： https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • カナダ向け： https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EMEA地域向け： https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  • 選択した OAuth スコープにあなたの代わりにいつでもリクエストを実行する（refresh_token、offline_access） と少なくとも1つの他のスコープ が含まれていることを確認してください。

コネクターが Salesforce アプリへの接続を失った場合：

1. の「Chain Builder」（ ）から、左側のサイドバーにある「compare_arrows Connections」（ ）をクリックし、その接続の「Edit 」（鉛筆アイコン）をクリックします。
2. OAuth の下で、リセット をクリックする。
3. コネクタから Salesforce への接続を有効にするには、Allowをクリックします。
    

基本認証

ベーシック認証で接続に失敗した場合：

• 統合ユーザーのサインインする認証情報とセキュリティトークンを確認します。Salesforce で新規セキュリティトークンを依頼するには、統合ユーザとしてサインインし、設定 、個人情報 を選択し、セキュリティトークンのリセット をクリックします。
• コネクターに正しい Salesforce インスタンスまたはカスタマイズ ドメインが入力されていることを確認します。
• 統合ユーザーが、コネクターが実行するタスクに関連する権限に加えて、API Enabled の権限を持っていることを確認します。
   

クライアント・クレデンシャル認証

クライアント認証による接続に失敗した場合：

• コネクターに正しい Salesforce インスタンスまたはカスタマイズ ドメインが入力されていることを確認します。
• コネクターが使用する Salesforce 接続アプリのクライアント ID とシークレットを確認します。