> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce Data 360

export const title_4 = "Salesforce Data 360";

export const title_3 = "Salesforce Data 360";

export const title_2 = "Salesforce Data 360";

export const title_1 = "Salesforce Data 360";

export const title_0 = "Salesforce Data 360";

## 前提条件

### OAuth、OAuthPKCE、および OAuthJWT

OAuth、OAuthPKCE、または OAuthJWT 認証を使用するには、Salesforce で Connected App を作成する必要があります：

<Steps>
  <Step>
    Salesforce Data 360 にログインし、**Setup** をクリックします。
  </Step>

  <Step>
    **Quick Find** ボックスで **App Manager** を検索し、**New Connected App** をクリックします。
  </Step>

  <Step>
    アプリの名前と E メールアドレスを入力します。次に、以下を選択します：

    * **Enable OAuth Settings**
    * **Enable Authorization Code and Credentials Flow**
    * **Enable Token Exchange Flow**
  </Step>

  <Step>
    **Callback URL** を *[https://oauth.cdata.com/oauth/](https://oauth.cdata.com/oauth/)* に設定します。
  </Step>

  <Step>
    以下の OAuth スコープを追加します：

    * Manage user data via APIs (`api`)
    * Perform requests at any time (`refresh_token`, `offline_access`)
    * Manage Data 360 profile data (`cdp_profile_api`)
    * Perform ANSI SQL queries on Data 360 data (`cdp_query_api`)
    * Manage Data 360 Identity Resolution (`cdp_identityresolution_api`)
    * Manage Data 360 Calculated Insight data (`cdp_calculated_insight_api`)
  </Step>

  <Step>
    **Save and Continue** をクリックします。**Consumer Key** と **Consumer Secret** をメモしておきます。Connect AI では、これらは **OAuth Client Id** と **OAuth Client Secret** として入力します。
  </Step>
</Steps>

### OAuthClient

OAuthClient 認証を使用するには、クライアント認証情報フローを有効にした Connected App を作成する必要があります：

<Steps>
  <Step>
    Salesforce Data 360 にログインし、**Setup** をクリックします。
  </Step>

  <Step>
    **Quick Find** ボックスで **App Manager** を検索し、**New Connected App** をクリックします。
  </Step>

  <Step>
    アプリの名前と E メールアドレスを入力します。次に、以下を選択します：

    * **Enable OAuth Settings**
    * **Enable Client Credentials Flow**
    * **Enable Token Exchange Flow**
  </Step>

  <Step>
    フローの実行ユーザーを選択します。
  </Step>

  <Step>
    以下の OAuth スコープを追加します：

    * Manage user data via APIs (`api`)
    * Perform requests at any time (`refresh_token`, `offline_access`)
    * Manage Data 360 profile data (`cdp_profile_api`)
    * Perform ANSI SQL queries on Data 360 data (`cdp_query_api`)
    * Manage Data 360 Identity Resolution (`cdp_identityresolution_api`)
    * Manage Data 360 Calculated Insight data (`cdp_calculated_insight_api`)
    * Manage user data via Web browsers (`web`)
  </Step>

  <Step>
    **Save and Continue** をクリックします。
  </Step>

  <Step>
    Connected App の詳細ページで **Manage** をクリックし、次に **Edit Policies** をクリックします。
  </Step>

  <Step>
    **Client Credentials Flow** の下で、**Run As** の横の検索アイコンをクリックし、実行ユーザーを選択します。Enterprise Edition の組織の場合、**API Only User** 権限を持つユーザーを選択します。
  </Step>

  <Step>
    変更を保存します。**Consumer Key** と **Consumer Secret** をメモしておきます。Connect AI では、これらは **OAuth Client Id** と **OAuth Client Secret** として入力します。
  </Step>
</Steps>

## セットアップガイド

以下の手順で、Salesforce Data 360 を Connect AI アカウントに接続します：

<Steps>
  <Step>
    Connect AI のナビゲーションメニューから **Sources** ページを開きます。
  </Step>

  <Step>
    右上の **+ Add Connection** をクリックします。
  </Step>

  <Step>
    検索フィールドに *Salesforce Data 360* と入力し、データソース名をクリックします。
  </Step>

  <Step>
    新しいコネクションの **Basic Settings** タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。
  </Step>

  <Step>
    （オプション）Salesforce インスタンスでの認証に使用される **Salesforce Access Token** を入力します。
  </Step>

  <Step>
    **Auth Scheme** を選択し、該当するセクションに進んで手順に従います。
  </Step>
</Steps>

## 認証方式

<Tabs>
  <Tab title="OAuthPKCE">
    <Steps>
      <Step>
        Salesforce Connected App から取得した **OAuth Client Id** と **OAuth Client Secret** を入力します。
      </Step>

      <Step>
        OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、Salesforce のサインインページが新しいタブで開かれます。
      </Step>

      <Step>
        Salesforce アカウントにログインし、リクエストされた権限を設定します（該当する場合）。
      </Step>

      <Step>
        Connect AI **Add {title_0} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="OAuth">
    <Steps>
      <Step>
        Salesforce Connected App から取得した **OAuth Client Id** と **OAuth Client Secret** を入力します。
      </Step>

      <Step>
        OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、Salesforce のサインインページが新しいタブで開かれます。
      </Step>

      <Step>
        Salesforce アカウントにログインし、リクエストされた権限を設定します（該当する場合）。
      </Step>

      <Step>
        Connect AI **Add {title_1} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="OAuthClient">
    このメソッドは、ブラウザによる対話的なサインインなしで認証を行うサービス間コネクション向けです。

    <Steps>
      <Step>
        Salesforce Connected App から取得した **OAuth Client Id** と **OAuth Client Secret** を入力します。
      </Step>

      <Step>
        Connect AI **Add {title_2} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="OAuthPassword">
    <Warning>
      OAuthPassword は非推奨です。代わりに OAuthJWT または OAuthPKCE を使用してください。**Security Token** プロパティも非推奨で、このスキームでのみ適用されます。
    </Warning>

    <Steps>
      <Step>
        Salesforce の **User** と **Password** を入力します。
      </Step>

      <Step>
        （オプション）**Security Token** を入力します。Salesforce の Trusted IP Addresses に IP アドレスが追加されていない限り、これは必須です。
      </Step>

      <Step>
        Connect AI **Add {title_3} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="OAuthJWT">
    <Steps>
      <Step>
        以下の情報を入力します：

        * **OAuth JWT Cert**–PEM 形式の証明書の内容。
        * **OAuth JWT Cert Type**–証明書を含むキーストアのタイプ。デフォルトの証明書タイプは **PEMKEY\_BLOB** です。
        * **OAuth JWT Issuer**–Java Web Token の発行者。
        * **OAuth JWT Cert Password**–（オプション）証明書が暗号化されている場合にのみ必要です。
        * **OAuth JWT Cert Subject**–（オプション）ストア内の証明書のサブジェクトを識別します。
        * **OAuth JWT Subject**–（オプション）委任アクセス用のユーザーサブジェクト。
      </Step>

      <Step>
        Connect AI **Add {title_4} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Note>
  このコネクタを試してみませんか？[Connect AI の無料アカウントを作成](https://jp.cdata.com/ai/signup/)して、最初のコネクションを数分でセットアップします。
</Note>
