概要
警告: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を選択します。
3)[接続ニックネーム(Connection Nickname)]フィールドに適切な名前を付け、ステップ4に従ってインテグレーションキーを生成します。
4)Pendo Adoptで、[設定(Settings)]>[インテグレーション(Integrations)]に移動し、[インテグレーションキーを生成(Generate Integration Key)]をクリックして、[書き込みアクセスを許可(Allow Write Access)]にチェックを入れます。インテグレーションキーが作成されたら、Oktaワークフローに戻り、値をコピーして[インテグレーションキー(Integration Key)]フィールドに貼り付け、[作成(Create)]をクリックします。
注:Pendoアプリケーションには、アプリケーションへの接続が機能していることを示す緑色のチェックマークが表示されます。
アクションカード
メタデータを使用して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)]オプションを選択した場合にのみ入力されます。 |