Pendo Oktaコネクタ認証

最終更新日:

概要

警告:Pendo Oktaコネクタは、Pendoが開発したメタデータのアップロードワークフローでの使用を目的としています。Pendoは、提供されたワークフローテンプレート内でのみこのコネクタを使用することをお勧めします。記事メタデータの同期にOktaワークフローを使用するの手順に従ってください。

このプロセスでは、Oktaワークフローを活用して、訪問者とそのメタデータをPendo Adoptにプッシュする方法を説明します。たとえば、このプロセスに従って、訪問者を毎週Pendoにプッシュできます。

Oktaワークフローによって訪問者のメタデータをスケジュールに基づいて自動的に更新できるため、Pendoではこの方法を推奨しています。

認証

前提条件

  • 管理者としてのPendo Adoptへのアクセス権。

  • スーパー管理者としてのOktaワークフローへのアクセス権。

1)Oktaの[接続(Connections)] タブに移動します。今回は、Okta用とPendo Launcher用の2つの接続アプリケーションを設定します。

2)[+新しい接続(+ New Connection)]をクリックし、 Pendoを選択します。

mceclip2__2_.png

3)[接続ニックネーム(Connection Nickname)]フィールドに適切な名前を付け、ステップ4に従ってインテグレーションキーを生成します。

mceclip3__2_.png

4)Pendo Adoptで、[設定(Settings)]>[インテグレーション(Integrations)]に移動し、[インテグレーションキーを生成(Generate Integration Key)]をクリックして、[書き込みアクセスを許可(Allow Write Access)]にチェックを入れます。インテグレーションキーが作成されたら、Oktaワークフローに戻り値をコピーして[インテグレーションキー(Integration Key)]フィールドに貼り付け、[作成(Create)]をクリックします。mceclip9__1_.png

注:Pendoアプリケーションには、アプリケーションへの接続が機能していることを示す緑色のチェックマークが表示されます。mceclip4__2_.png

アクションカード

メタデータを使用してOktaユーザーリストをプッシュする

Oktaユーザーオブジェクトのリストを指定すると、選択したIDに基づいてユーザーのメタデータ値を設定し、ユーザーが存在しない場合は必要に応じてユーザーを作成します。

オプション

  • 訪問者IDキー

  • 存在しないユーザーの作成

インプット

フィールド 説明 タイプ 必須である
訪問者IDキー Pendoの訪問者を識別するために使用されるキー。 テキスト はい
存在しないユーザーの作成 受信したOktaユーザーがPendoに存在しない場合は、新しい訪問者レコードを作成します。 ブール値(はい/いいえ) はい
ユーザーリスト Pendoにアップロードするユーザーのリスト JSONキーの配列。その後、各フィールドがPendoに送信されます。 はい
値キー ユーザーリストオブジェクトから値を識別して、Pendoにプッシュします。 文字列のリスト(空欄でも可) はい(文字列の配列は空欄でも可)

アウトプット

フィールド 説明
StatusCode HTTPエラーコード。statusCodeが200の場合、リクエストは成功しています。他のすべての値は失敗を示します。
message 要求が成功したか失敗したかどうかを示します。
recordsProcessed 処理のために送信された行の合計数。
usersUpdated 正常に処理された行の合計数。
usersFailed 処理されなかった行の合計数。
usersMissing Pendoで見つからなかったユーザーIDの配列。このフィールドは、[存在しないユーザーの作成(Create Non-existing User)]フィールドで[いいえ(No)]オプションを選択した場合にのみ入力されます。