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

# 連携のセットアップ

> プロバイダーの認証情報を準備し、対応システムを接続して、データストリームを有効化し、最初の同期が成功したことを確認します。

このガイドでは、**設定 → 連携 → カタログ** に表示される連携の一般的なセットアップ手順について説明します。プロバイダー固有のフィールド、権限、認証手順については、そのプロバイダーのカタログカードからリンクされているセットアップガイドを参照してください。

## 前提条件

| ロール | 責任範囲 |
| - | - |
| [**プログラムオーナー**](/ja/reference/glossary#%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%A0%E3%82%AA%E3%83%BC%E3%83%8A%E3%83%BC) | ソースを選択し、Living Securityで接続して、ストリームを有効化し、結果を確認します |
| [**システム管理者**](/ja/reference/glossary#%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E7%AE%A1%E7%90%86%E8%80%85) | ソースシステムで認証情報とスコープを作成または承認します |

これらのロールは同一の担当者が兼任することもできます。Living Securityで認証情報を入力する担当者は、連携の管理を許可する管理者ロールを持っている必要があります。限定的なスコープのセットアップ用ロールが存在するという想定のもとで、ソースシステムの管理者をLiving Securityに招待することは避けてください。

開始する前に、次の点を確認してください。

* 接続を配置するLiving Securityの組織と環境を選択します。
* プロバイダーのカタログガイドを開き、必要なスコープ、リダイレクトURL、許可リストの要件を確認します。
* 認証情報を作成する担当者と入力する担当者が異なる場合は、組織で承認されているシークレット共有プロセスを使用します。
* パスワード、クライアントシークレット、秘密鍵、アクセスキーの値をメールやサポートチケットで送信しないでください。

## 1. プロバイダーの認証情報を準備する

**設定 → 連携 → カタログ** を開き、プロバイダーを見つけて、認証情報を作成する前にそのセットアップガイドをお読みください。

プロバイダーの認証には、OAuthの同意、APIトークン、クライアントIDとシークレット、サービスアカウント、またはプロバイダーがサポートするその他の方法を使用できます。そのプロバイダーのガイドに記載されている認証情報とスコープのみを作成してください。

<Warning>
  別のプロバイダーの権限をコピーしたり、「念のため」広範な書き込みアクセスを付与したりしないでください。権限が不足している場合は、通常、修正可能な明確な401または403が返されます。過剰な権限は、回避できるリスクを生みます。
</Warning>

## 2. プロバイダーを接続する

<Steps>
  <Step title="カタログを開く">
    **設定 → 連携 → カタログ** に移動し、プロバイダーを選択します。
  </Step>

  <Step title="接続を開始する">
    **接続** を選択します。OAuthフローを完了するか、接続ダイアログで要求されたフィールドを入力します。各値の入手先については、プロバイダーのガイドで説明されています。
  </Step>

  <Step title="認証を完了する">
    該当する場合は、プロバイダーの同意画面で承認します。認証が成功すると、Living Securityは新しい接続を開くか、**接続されました** の下に一覧表示します。
  </Step>
</Steps>

プロバイダーが認証を拒否した場合は、先に進まず、認証情報、テナント、リージョン、リダイレクトURL、またはソースシステムの権限を修正してください。

## 3. データストリームを有効にする

**設定 → 連携 → 接続されました** の下で接続を開きます。Living Securityは、そのプロバイダーで利用可能な同期テンプレートを検出し、ストリームとして一覧表示します。

1. 各ストリームの名前と目的を確認します。
2. プログラムに必要なストリームのみを有効にします。
3. 関係のないストリームは一時停止のままにします。
4. 利用可能な場合は、**今すぐ同期** を使用して最初の実行を要求します。

すべてのプロバイダーが同じストリームやスケジュール制御を提供しているわけではありません。頻度、スコープ、フィールドマッピング、下書き、有効化のウィザードが共通して用意されていると想定せず、接続に表示されるコントロールに従ってください。

## 4. 最初の実行を確認する

接続の認証だけでは、データが流れていることは証明されません。

<Steps>
  <Step title="接続の正常性を確認する">
    接続が正常であり、再認可が要求されていないことを確認します。
  </Step>

  <Step title="ストリームの状態を確認する">
    必要なストリームが一時停止ではなく有効になっていることを確認します。
  </Step>

  <Step title="最新の実行を確認する">
    ストリーム、接続の同期リンク、または **設定** → **連携** → **同期** を開きます。正常終了の結果が表示されるまで待ち、利用可能な場合はプロバイダーのエラーとレコード数を確認します。
  </Step>

  <Step title="下流のデータを確認する">
    関連するLiving Securityの画面を開きます。IDデータからは、従業員に想定どおりの人物とIDが作成されているはずです。セキュリティソースのデータは、そのプロバイダーについて文書化されている機能に表示されるはずです。
  </Step>
</Steps>

オンボーディングでは、ジャーニーマップの **Verify Identity Data Flowing** タスクと **Verify Integration Data Flowing** タスクは、取り込まれたデータに基づいて完了します。保存された接続をこれらの確認結果の代わりにしないでください。

## 同期の詳細ページ

**設定** → **連携** → **同期** から任意の同期を開くと、その構成と実行履歴を一か所で確認できます。

詳細ページには次の内容が表示されます。

| セクション | 内容 |
| - | - |
| **ヘッダー** | 同期名、ステータスバッジ、連携プロバイダー |
| **統計** | モデル、最終同期、完了した実行数、合計レコード数 |
| **実行履歴** | ステータス、所要時間、レコード数を含む最近の実行 |
| **アクション** | **リフレッシュ**、**一時停止** / **履歴書**、**今すぐ同期** |

同期が有効な場合は、**今すぐ同期** を使用して即時に実行できます。一時停止中の同期は、スケジュール実行または手動実行が開始される前に再開する必要があります。

連携にアクティブなストリームが一覧表示されている場合は、接続の詳細ページから同期を開くこともできます。

## 接続の操作

接続の詳細ページには、その連携でサポートされている操作が表示されます。

| 操作 | 効果 |
| - | - |
| **今すぐ同期** | 選択したストリームの即時実行を要求します |
| **ストリームの一時停止** | 接続を維持したまま、そのストリームの新しい実行を停止します |
| **接続の一時停止** | 構成を削除せずに、サポートされている接続のアクティビティを停止します |
| **履歴書** | 一時停止中のストリームまたは接続を再開します |
| **再認可** | 認証情報または同意の変更後に認証を再度実行します |
| **削除** | 確認後に接続の構成を削除します |

接続を削除することは、そこからすでに取り込まれたデータを削除することと同じではありません。データ保持の動作が判断に影響する場合は、プロバイダーのガイドを確認するか、サポートにお問い合わせください。

## カスタムプッシュソース

システムがカタログコネクターによってポーリングされるのではなく、Living Securityにデータを送信する場合は、**カスタムプッシュソース** を使用します。

1. **カタログ** の下部からソースを作成します。
2. カスタムプッシュ領域の下にあるその詳細ページを開きます。
3. 宛先のストリームを選択します。
4. 手動バッチの場合は **CSVをアップロード**、自動送信の場合は **API経由でプッシュ** を使用します。
5. 送信後、ファイルまたはペイロードをプレビューし、ソースの実行履歴を確認します。

エンドポイント、認証、ペイロード、リトライ、検証に関する完全な仕様については、[カスタムプッシュソースAPI](/ja/integrations/custom-push-source)を参照してください。これらの詳細を、以前のUnify連携ガイドから推測しないでください。

ソース詳細のアップローダーは、最大100 MBのソースCSVファイルを受け付けます。アップロードの前に、ダッシュボードがクライアント側でファイルを、それぞれ10 MB以下かつ10,000行以下のリクエストに分割します。このソース専用のアップローダーは、IDおよびアクティビティのテンプレート用の一般的な **連携 → アップロード** ページとは別のものです。

## トラブルシューティング

| 症状 | 確認事項 |
| - | - |
| `401 Unauthorized` | 認証情報の値、有効期限、失効、プロバイダーのテナント、再認可の状態 |
| `403 Forbidden` | 必要なプロバイダーのロール、スコープ、管理者の同意、ソースシステムのアクセスポリシー |
| 接続がすぐに失敗する | リダイレクトURL、リージョン、ソースURL、ネットワークまたはIPの許可リストの要件 |
| 接続は正常だが実行が行われない | 必要なストリームが有効になっており、プロバイダーがそのストリームを公開していること |
| 実行は成功したがレコードが返されない | ソースアカウントが想定される対象者を参照でき、プロバイダー側のフィルターが正しいこと |
| データが誤った人物の下に表示される | 接続済みのソース間で、ID属性とエイリアスが一貫していること |
| データが更新されなくなった | ストリームまたは接続が一時停止されている、認証情報が期限切れである、または最新の実行が失敗した |

[Living Securityサポート](mailto:support@livingsecurity.com)にお問い合わせの際は、組織、プロバイダー、接続名、ストリーム、最新の実行時刻、表示されているエラーを含めてください。シークレットは含めないでください。

## 関連情報

<CardGroup cols={2}>
  <Card title="連携の概要" icon="grid-2" href="/ja/integrations/overview">
    接続されました、カタログ、同期、アクション、アップロードのリファレンスです。
  </Card>

  <Card title="データマッピング" icon="arrows-left-right" href="/ja/integrations/managing/data-mapping">
    サポートされている属性と、利用可能な場合のマッピングについて説明します。
  </Card>

  <Card title="連携のライフサイクル" icon="route" href="/ja/integrations/managing/lifecycle">
    再認可や削除を含め、既存の連携を運用します。
  </Card>

  <Card title="管理者オンボーディング" icon="circle-check" href="/ja/getting-started/onboarding">
    IDおよびセキュリティデータの確認タスクを完了します。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.