お困りですか？

PendoのインサイトとガイダンスのCNAME

最終更新:

概要

CNAME機能を使用すると、お客様独自のアプリケーションのドメインの下にホスト名を作成できます。このホスト名は、イベントの送信でもガイドコンテンツのダウンロードでも、Pendoのホスト名の代わりに使用されます。これにより、イベントを確実に収集し、広告ブロックソフト、ファイアウォール、ウェブフィルターなどの対象となるエンドユーザーにガイドを提供することができます。

 

CNAMEとは何の略ですか？

正規名レコード（CNAMEレコードと略されます）は、ドメインネームシステム（DNS）で定義されるそのドメインについての情報の種類の1つで、あるドメイン名やホスト名の別名を定義するものです。別名は「エイリアス」（alias）と呼ばれます。

 

注：お客様のPendoサブスクリプションのCNAMEを設定するには、カスタマーサクセスマネージャーまたはcsm@pendo.ioにお問い合わせください。

 

設定

product.example.comのような、企業ドメインのサブドメインを指定してください（「example」はお客様の企業ドメインです）。

Pendoは、作成する必要のある一連の必須DNSエントリを提供します。これは次のようなものです。

ドメイン CNAME 説明
product.example.com 1234567812345678-txt.example.pendo.io このレコードは、PendoがGoogle App Engine経由でdata.product.example.comを提供できることをGoogleに検証するために使用されます。
data.product.example.com 1234567812345678-data.example.pendo.io このレコードは、app.pendo.ioのエイリアスです。
content.product.example.com 1234567812345678-content.example.pendo.io このレコードは、お客様のPendoサブスクリプションのカスタムCDN構成のエイリアスです。
_0123456789abcdef.content.product.example.com _fedcab987654321.acm-validations.aws このレコードは、Amazonに対してサブドメインの所有権を検証し、SSL証明書を自動生成できるようにするために使用されます。


上記の例はプレースホルダーであり、実際に作成されるDNSエントリのセットはPendoが提供します。

 

注：Pendoのサブスクリプションキーごとに、固有のコンテンツドメインが必要です。

 

DNSエントリが設定されると、Pendoはインフラの設定を完了します。これには新しいホスト名用のSSL証明書の自動生成が含まれます。

Pendoは、サブスクリプション設定の「データホスト」と「コンテンツホスト」を、それぞれdata.product.example.comとcontent.product.example.comを指すように更新します。

 

Pendoスニペットを更新する

Pendoアプリケーションは、新しい設定を使用して、サブスクリプションのPendoエージェントの書き換えをトリガーします。この時点から、Pendoとのコミュニケーションはすべて、提供されたエイリアスを介して行われます。

次に、新しい「コンテンツホスト」がインストールされている場所すべてでPendoスニペットを更新する必要があります。

 

ガイドを再保存する

既存のガイドのコンテンツが新しいエイリアスからプルされるように、各ガイドを再保存する必要があります。

以上の手順を、アクティブなガイドごとに繰り返します。

  1. ガイドの詳細で、［アプリ内の管理（Manage In-App）］をクリックします。
  2. Visual Design Studioで、ガイド管理バーの［保存（Save）］をクリックします。
  3. ［終了（Exit）］をクリックして、Visual Design Studioを終了します。
  4. CNAMEを有効にした後に公開される各ガイドにも同様の作業を行ってください。
  5. ガイドが再保存されると、そのコンテンツはエイリアスドメインからプルされます。

 

Pendo MobileのCNAME

要件：Mobile CNAMEには、AndroidおよびiOS SDKバージョン2.5.1以上が必要です。

 

注：以下に必要なハッシュ値は、証明書がインストールされた後にPendoから提供されます。

 

AndroidでのCNAMEの有効化

アプリのManifest.xmlの<application>タグ内に以下のエントリを追加します。

例：
<meta-data android:name="pnd_device_url" android:value="https://device_url.acme.com/"/> 
<meta-data android:name="pnd_app_url" android:value="https://app_url.acme.com/"/> 
<meta-data android:name="pnd_data_url" android:value="https://data_url.acme.com/"/> 
<meta-data android:name="pnd_device_hash" android:value="sha256/035gh43/1Df3aP/dh3j7iHFk23gs7Upuf8R4gd=" /> 
<meta-data android:name="pnd_data_hash" android:value="sha256/03gp63/3Da143/k64vr5df526d7=" />

 

iOSでのCNAMEの有効化

info.plistに以下のマッピングを追加します。

<key>PNDCNames</key> 
<dict> 
<key>PNDDeviceURL</key> 
<string>https://device_url.acme.com</string> 

<key>PNDAppURL</key> 
<string>https://app_url.acme.com</string> 

<key>PNDDataURL</key> 
<string>https://data_url.acme.com</string> 

<key>PNDDeviceHash</key> 
<string>6fSJ7nrsv8A/65FAOBoGr34q3Ar63gjFy88FA7C84Av=</string> 

<key>PNDDataHash</key> 
<string>Ga+fa/Rsv/Sfh4AFsEkhA895hsdg4654FHSfd5SgO+df4=</string> 
</dict>

 

よくある質問

Segment.ioでCNAMEを使うことはできますか？

いいえ。CNAMEを設定するにはsrc URLを置き換えるためのPendoインストールスニペットにアクセスする必要があります。Pendoのスニペットは、Segment.ioのインストールでは変更できません。

 

自分でSSL証明書を用意することはできますか？

データとコンテンツのホスト名の両方に適した単一のSSL証明書を提供することも、別々の証明書を提供することもできます。証明書を生成するには2つの方法があります。

  1. 鍵とCSRを生成し、CAから証明書を取得し、証明書チェーンと秘密鍵を含む暗号化されたアーカイブを弊社に送付してください。デフォルトでは、PGPで暗号化されたファイルをkeybase.io経由でhttps://keybase.io/a13mなどのOPSチームのメンバーに送信します。独自の安全なファイル転送メカニズムをご希望の場合は、そのメカニズムを使用することもできます。
  2. CSRの生成に適したテキストファイルを提供してください。Pendoが鍵とCSRを生成し、CSRをお客様に送り、お客様はそれを使ってCAから証明書を取得します。これにより、当事者間で秘密鍵をやり取りする必要がなくなり、証明書チェーンを平文の電子メールで送信しても安全になります。CSRの入力ファイルは以下のようになっています。
[ req ] default_bits = 2048 prompt = no encrypt_key = no default_md = sha256 distinguished_name = dn req_extensions = req_ext [ dn ] commonName = Common Name (server FQDN; data.product.example.com)organizationName = Organization Name (eg, company) localityName = Locality Name (eg, city) stateOrProvinceName = State or Province Name (full name) countryName = Country Name (2 letter code) organizationalUnitName = Organizational Unit Name (eg, section) [ req_ext ] subjectAltName = @alt_names [ alt_names ] DNS.1 = data.product.example.com DNS.2 = content.product.example.com

関連記事