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

​
前提条件

これらのロールは同一の担当者が兼任することもできます。Living Securityで認証情報を入力する担当者は、連携の管理を許可する管理者ロールを持っている必要があります。限定的なスコープのセットアップ用ロールが存在するという想定のもとで、ソースシステムの管理者をLiving Securityに招待することは避けてください。 開始する前に、次の点を確認してください。
  • 接続を配置するLiving Securityの組織と環境を選択します。
  • プロバイダーのカタログガイドを開き、必要なスコープ、リダイレクトURL、許可リストの要件を確認します。
  • 認証情報を作成する担当者と入力する担当者が異なる場合は、組織で承認されているシークレット共有プロセスを使用します。
  • パスワード、クライアントシークレット、秘密鍵、アクセスキーの値をメールやサポートチケットで送信しないでください。

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

設定 → 連携 → カタログ を開き、プロバイダーを見つけて、認証情報を作成する前にそのセットアップガイドをお読みください。 プロバイダーの認証には、OAuthの同意、APIトークン、クライアントIDとシークレット、サービスアカウント、またはプロバイダーがサポートするその他の方法を使用できます。そのプロバイダーのガイドに記載されている認証情報とスコープのみを作成してください。
別のプロバイダーの権限をコピーしたり、「念のため」広範な書き込みアクセスを付与したりしないでください。権限が不足している場合は、通常、修正可能な明確な401または403が返されます。過剰な権限は、回避できるリスクを生みます。

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

1

カタログを開く

設定 → 連携 → カタログ に移動し、プロバイダーを選択します。
2

接続を開始する

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

認証を完了する

該当する場合は、プロバイダーの同意画面で承認します。認証が成功すると、Living Securityは新しい接続を開くか、接続されました の下に一覧表示します。
プロバイダーが認証を拒否した場合は、先に進まず、認証情報、テナント、リージョン、リダイレクトURL、またはソースシステムの権限を修正してください。

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

設定 → 連携 → 接続されました の下で接続を開きます。Living Securityは、そのプロバイダーで利用可能な同期テンプレートを検出し、ストリームとして一覧表示します。
  1. 各ストリームの名前と目的を確認します。
  2. プログラムに必要なストリームのみを有効にします。
  3. 関係のないストリームは一時停止のままにします。
  4. 利用可能な場合は、今すぐ同期 を使用して最初の実行を要求します。
すべてのプロバイダーが同じストリームやスケジュール制御を提供しているわけではありません。頻度、スコープ、フィールドマッピング、下書き、有効化のウィザードが共通して用意されていると想定せず、接続に表示されるコントロールに従ってください。

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

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

接続の正常性を確認する

接続が正常であり、再認可が要求されていないことを確認します。
2

ストリームの状態を確認する

必要なストリームが一時停止ではなく有効になっていることを確認します。
3

最新の実行を確認する

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

下流のデータを確認する

関連するLiving Securityの画面を開きます。IDデータからは、従業員に想定どおりの人物とIDが作成されているはずです。セキュリティソースのデータは、そのプロバイダーについて文書化されている機能に表示されるはずです。
オンボーディングでは、ジャーニーマップの Verify Identity Data Flowing タスクと Verify Integration Data Flowing タスクは、取り込まれたデータに基づいて完了します。保存された接続をこれらの確認結果の代わりにしないでください。

​
同期の詳細ページ

設定 → 連携 → 同期 から任意の同期を開くと、その構成と実行履歴を一か所で確認できます。 詳細ページには次の内容が表示されます。 同期が有効な場合は、今すぐ同期 を使用して即時に実行できます。一時停止中の同期は、スケジュール実行または手動実行が開始される前に再開する必要があります。 連携にアクティブなストリームが一覧表示されている場合は、接続の詳細ページから同期を開くこともできます。

​
接続の操作

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

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

システムがカタログコネクターによってポーリングされるのではなく、Living Securityにデータを送信する場合は、カスタムプッシュソース を使用します。
  1. カタログ の下部からソースを作成します。
  2. カスタムプッシュ領域の下にあるその詳細ページを開きます。
  3. 宛先のストリームを選択します。
  4. 手動バッチの場合は CSVをアップロード、自動送信の場合は API経由でプッシュ を使用します。
  5. 送信後、ファイルまたはペイロードをプレビューし、ソースの実行履歴を確認します。
エンドポイント、認証、ペイロード、リトライ、検証に関する完全な仕様については、カスタムプッシュソースAPIを参照してください。これらの詳細を、以前のUnify連携ガイドから推測しないでください。 ソース詳細のアップローダーは、最大100 MBのソースCSVファイルを受け付けます。アップロードの前に、ダッシュボードがクライアント側でファイルを、それぞれ10 MB以下かつ10,000行以下のリクエストに分割します。このソース専用のアップローダーは、IDおよびアクティビティのテンプレート用の一般的な 連携 → アップロード ページとは別のものです。

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

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

​
関連情報

連携の概要

接続されました、カタログ、同期、アクション、アップロードのリファレンスです。

データマッピング

サポートされている属性と、利用可能な場合のマッピングについて説明します。

連携のライフサイクル

再認可や削除を含め、既存の連携を運用します。

管理者オンボーディング

IDおよびセキュリティデータの確認タスクを完了します。