> ## 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.

# Paylocity

export const title_0 = "Paylocity";

## 前提条件

OAuth 経由で Paylocity に認証するには、まず API アクセスを取得し、希望するコールバック URL を Paylocity に登録する必要があります。Connect AI のコールバック URL は *[https://oauth.cdata.com/oauth/](https://oauth.cdata.com/oauth/)* です。

登録するには、[service@paylocity.com](mailto:service@paylocity.com) または [sales@paylocity.com](mailto:sales@paylocity.com) にお問い合わせください。

アクセスが審査・承認されると、Paylocity から OAuth 認証情報と、Sandbox または Production アカウントへのアクセスが提供されます。このアクセスは API リクエストの認証に必要です。

Paylocity は以下の OAuth 認証情報を提供します。

* **client\_id**：Paylocity 開発者ポータルで登録した OAuth アプリケーションに割り当てられた client\_id。この値は **OAuthClientId** の設定に使用します。
* **secret**：Paylocity 開発者ポータルで登録した OAuth アプリケーションに割り当てられたシークレット。この値は **OAuthClientSecret** の設定に使用します。Paylocity ではシークレットを 365 日ごとにローテーションする必要があります。シークレットの有効期限の 10 日前と 5 日前にメールでリマインダーが送信されます。

## セットアップガイド

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

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

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

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

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

  <Step>
    以下の情報を入力します：

    * **OAuth Client Id**–前提条件で取得したクライアント Id を設定します。
    * **OAuth Client Secret**—前提条件で取得したクライアントシークレットを設定します。
    * **RSA Public Key**—Paylocity アカウントに関連付けられた RSA キー。Insert および Update ステートメントを実行する場合のみ必要です。
    * **Key**—コンテンツの暗号化に使用する Base64 エンコードされた AES 対称キーを設定します。IV が設定されている場合のみ必要です。
    * **IV**—コンテンツの暗号化に使用する Base64 エンコードされた AES 初期化ベクター（IV）を設定します。Key も設定されている場合のみ必要です。
    * **Authentication Model**—他のユーザーがこのデータソースのデータにアクセスする方法を、共有認証か、ユーザー自身の認証情報（ユーザーごとの認証）のいずれかから選択します。
  </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>

## 詳細について

Connect AI とPaylocity の連携の詳細動作については、[こちらのページ](https://cdn.cdata.com/help/KPM/jp/cloud/default.htm#default)を参照してください。