Microsoft Azure Storageとのデータ同期を設定する

最終更新日:

Pendoのデータ同期機能を使用すると、Pendoのデータ(Pendo Feedbackのデータを除く)をMicrosoft Azure Storageのアカウントにエクスポートできます。この記事では、Microsoft Azure Storageとのデータ同期を設定する方法について説明します。

前提条件

  • データ同期は有料の機能です。この機能を利用するには、Pendoの担当者にお問い合わせください。
  • この作業においてクラウドストレージの保存先を設定するには、Pendoのサブスクリプション管理者である必要があります。
  • ユーザーはAzureでBLOBの書き込みおよびBLOBの追加コンテンツの権限を取得している必要があります。

設定の概要

Microsoft Azure Storageとのデータ同期の設定には、Pendo側での設定と、Microsoft Azure環境での構成が必要になります。具体的には、以下の手順で実施します。

  1. ストレージアカウントにアクセスするためのクライアントIDとクライアントシークレットを作成します。
  2. Azure Storageのアカウントを作成します。
  3. 権限を設定します。
  4. ストレージアカウント内にAzureコンテナを作成します。
  5. Pendoでプロバイダーを選択します。
  6. Pendoにストレージアカウントの保存先を設定します。

ステップ1. クライアントキーを生成する

Azureで認証するには、Microsoft Azure StorageアカウントにPendoをアプリケーションとして登録し、クライアントシークレット(キー)を作成する必要があります。このキーを生成するには、Azure Active Directoryに移動し、以下の手順を実施します。

  1. 左側のメニューの[管理(Manage)]の下にある [アプリの登録(App registrations)]を選択します。
  2. ページ上部の[+新規登録(+ New registration)]を選択して、新しいアプリケーションの登録プロセスを開始します。
  3. フォームに記入し、下部にある[登録(Register)]を選択してアプリケーションを作成します。すると、アプリケーションの詳細ページに移動します。移動しない場合は、左側のメニューの[管理(Manage)]の下にある[アプリの登録(App registrations)]に戻り、追加したアプリケーションを開きます。
  4. アプリケーションの詳細ページで、[概要(Essentials)] セクションの [アプリケーション(クライアント)ID(Application (client) ID)][ディレクトリ(テナント)ID(Directory (tenant) ID)] の値をメモします。これらのIDは、この記事のステップ6で、Pendo側で必要になります。
  5. アプリケーションの詳細ページの左側のメニューから[証明書とシークレット(Certificates & secrets)]を選択し、[クライアント シークレット(Client secrets)]タブを開き、 [+新しいクライアント シークレット(+ New client secret)]を選択します。
  6. Pendoデータ同期での用途を要約した説明を入力し、社内ポリシーと一致する有効期限ポリシーを選択します。
  7. フォームの下部にある[追加(Add)]を選択します。
  8. [値(Value)]列の文字列をメモします。この文字列は、この記事のステップ6で、Pendo側で必要になります。値は限られた時間内のみ表示されます。

ステップ2. Azure Storageアカウントを作成する

Pendoのデータは、BLOBとしてAzure Storageアカウントにコピーされます。Azure Storageアカウントを作成するには、Microsoft Azureの[ストレージアカウント(Storage accounts)]に移動して、次の操作を行います。

  1. ページの左上にある[+作成(+ Create)]を選択します。
  2. [基本(Basics)]タブから、ワークフローに従ってストレージアカウントの適切な設定を行います。
  3. [確認(Review)]を選択し、フォームの下部にある[作成(Create)]を選択します。

ステップ3. 権限を設定する

ステップ2で作成したストレージアカウントで以下の手順を実施します。

  1. 左側のメニューから[アクセスコントロール(IAM)(Access Control (IAM))] を選択します。
  2. [+追加(+ Add)]を選択し、[役割の割り当てを追加(Add role assignment)]を選択します。
  3. [役割(Role)]タブで[ストレージBLOBデータ投稿者(Storage Blob Data Contributor)]を探して選択します。
  4. [メンバー(Members)]タブを開きます。
  5. [アクセス権の割り当て先(Assign access to)]の横にある[ユーザー、グループ、またはサービスプリンシパル(User, group, or service principal)]を選択します。
  6. [+メンバーを選択(+ Select members)]を選択し、クライアントを探します。

設定内容は[役割の割り当て(Role assignments)]タブで確認できます。

ステップ4. Azureコンテナを作成する

ステップ2で作成したストレージアカウントで以下の手順を実施します。

  1. 左側のメニューの[データストレージ(Data storage)]の下にある[コンテナ(Containers)]を選択します。
  2. ページの右上から[+コンテナ(+ Container)]を選択します。
  3. コンテナにわかりやすい名前をつけます。
  4. ドロップダウンメニューから匿名アクセスレベル([プライベート(Private)][BLOB][コンテナ(Container)])を選択します。
  5. フォームの下部にある [作成(Create)]を選択します。

ステップ5:Pendoでプロバイダーを選択する

ストレージバケットにデータを送信する前に、Pendoでターゲットとなる送信先を設定する必要があります。

  1. Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。

  2. [宛先に接続(Connect to destination)]を選択します。
  3. 右側にスライドアウトするパネルで[Microsoft Azure Storage]タイルにカーソルを合わせます。
  4. [宛先を選択(Choose Destination)]を選択します。パネルには、次のステップがまとめられています。

ステップ6. Pendoでストレージアカウントの宛先を設定する

最後のステップとして、PendoでMicrosoft Azure Storageの保存先を設定します。

  1. ステップ2で作成したストレージアカウント名を入力します。
  2. ステップ4で作成したストレージアカウントのコンテナ名を入力します。
  3. 必要に応じて、ストレージパス(サブディレクトリ)を入力します。ファイルをエクスポートする場所としてメインディレクトリ、つまりコンテナで十分な場合は、このフィールドを空白のままにしておきます。
  4. ステップ1でメモしたテナントIDとクライアントIDを入力します。
  5. ステップ1で作成したシークレット(クライアントキー)を入力します。
  6. [宛先を検証(Validate Destination)]を選択し、入力した認証情報をテストします。
  7. 正常に検証されたら、[宛先を作成(Create Destination)]を選択します。

認証情報のローテーション

PendoでAzureの宛先を構成した後に認証情報を更新するには、以下の2つの方法があります。

公開APIのエンドポイントを使用してデータ同期の認証情報を更新するには、書き込み権限のあるインテグレーションキーが必要です。

Pendo UIを使う

  1. Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
  2. ページの右上にある[宛先を管理(Manage destination)]を選択します。
  3. 新しい認証情報を入力します。

公開APIを使う

  1. Pendoのインテグレーションキーの記事で説明されている手順に従って、新しいPendoインテグレーションキーを生成します。
  2. Pendoの公開API資料で、[データ同期(Data Sync)]に移動します。
  3. クラウドストレージの宛先に対応するPUTエンドポイントを選択します。
  4. 公開APIのエンドポイントを使用してクラウドストレージの認証情報を更新する手順に従います。

クラウドストレージの宛先を更新する

クラウドストレージの宛先を、あるAzureコンテナから別のコンテナに移動したり、クラウドストレージサービスをGoogle Cloud Storage(GCS)やAmazon S3などの別のプロバイダーに変更するオプションがあります。

Azureコンテナを更新する

あるAzureコンテナから別の既存のAzureコンテナに変更する場合は、Pendoでコンテナの名前を更新します。

  1. Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
  2. ページの右上にある[宛先を管理(Manage Destination)]を選択します。
  3. コンテナ名フィールドのエントリを、データ同期に使用する新しいAzureコンテナの名前で置き換えます。
  4. [宛先を更新(Update destination)]を選択します。

クラウドストレージプロバイダーを変更する

クラウドストレージの宛先をAzureからGoogle Cloud Storage(GCS)やAmazon S3などの別のサービスに変更したい場合は、既存の宛先を削除して新しい宛先を作成できます。

宛先を削除するには次の手順を実行します。

  1. Pendoで、[設定(Settings)]>[データ同期(Data Sync)]の順に進みます。
  2. ページの右上にある[宛先を管理(Manage destination)]を選択します。
  3. 宛先を削除(Delete destination)を選択します。
  4. 宛先を削除することを確定します。

宛先を削除すると、定期的なレポートと継続的なメタデータの更新は自動的にオフになります。

その後、以下の記事で説明されている手順に沿って、別のクラウドストレージを宛先として設定することができます。

あるいは、PendoがホストするGCSの宛先とのデータ同期を設定することもできます。詳細については、Pendoアカウントチームにお問い合わせください。

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています