データの非公開処理

Vonageの通信APIを使用すると、そのアクティビティに関するサーバーログおよびトランザクション記録が生成されます。このアクティビティのトランザクション記録は、通信詳細記録または通話詳細記録(CDR)と呼ばれます。

サーバーログは15日から30日間保存され、CDRは13か月間保存されます。サーバーログとCDRは、テストやデバッグ、ユーザーの問題の診断、およびCDRとお客様の取引記録との照合など、さまざまな目的で当社のサポートスタッフによって閲覧される場合があります。

「自動マスキング」サービスおよび「Redact API」を使用すると、CDRやサーバーログから個人データを削除することができます(「高度な自動マスキング」のみ)。Accountで「Redact API」または「自動マスキング」サービスを有効にする方法の詳細については、以下をご覧ください。 個人データには、一般的に、発信メッセージや発信通話における受信者の電話番号、および着信メッセージや着信通話における発信者の電話番号が含まれます。メッセージの場合、個人データにはメッセージ本文も含まれ、発信SMSの場合はIPアドレスも含まれます。サーバーログには、CDRと同じ個人データが保存されます。

編集処理が行われると、編集対象のフィールドに含まれる実際の個人データは、次の文字列で上書きされます。 [REDACTED]. 伏せられた個人データは完全に削除されます。

顧客は、次のいずれかを使用して冗長化されたCDRを表示できます。 Vonage Reports API リファレンス、あるいは 顧客ダッシュボード にアクセスして 過去ログ

「自動マスキング」サービスは、シンプルで包括的なソリューションを提供し、有効化するとすべてのサービスにわたるすべてのスコープを自動的にマスキングします。よりきめ細かな制御を行い、対象となる製品を選択したい場合は、無料の「Redact API」をご利用いただけます。

Redact API

Redact API は、Vonage のお客様に、Vonage プラットフォームに保存されている CDR(13 か月間保存)の消去をプログラムでリクエストするためのエンドポイントを提供します。Redact API には、サーバーログ(約 15 日間保存)を消去する機能はありません。

Redact API を使用するには、お客様が Vonage 通信 API に送信した API リクエストのレスポンスに返されるトランザクション (メッセージまたはコール) ID を提供する必要があります。各IDに対して Vonage Redact API.

トランザクション ID を受け取った直後に Redact API へのリクエストを行うことはできません。これは、Redact API が情報を削除する対象となる長期保存ストレージに CDR が反映されるまでに時間がかかる(最大で数分)ためです。 したがって、返されたトランザクション(CDR)IDを後で参照できるようデータベースに保存するか、Reports API を使用して、Account の CDR とその ID を取得する必要があります。詳細については以下をご覧ください。

Redact APIの編集範囲は、使用していたVonage通信APIによって異なります。詳しい説明は以下の通りです。

Redact APIへのアクセス権を申請するには、以下のページにアクセスしてください。 Vonage API サポートポータル.

Redact APIの詳細については、以下を参照してください。 Vonage Redact API リファレンス.

自動伏字処理サービス

Vonageでは、「標準自動マスキングサービス」および「高度な自動マスキングサービス」を提供しており、お客様側での操作を一切必要とせずに、当社のシステムから個人データを自動的にマスキングします。 選択されたサービスに応じて、マスキングを即時に行うか(SMS API、Messages API、Verify、Number Insight APIにのみ適用)、数日間の遅延を設けて行うか(スタンダード版にのみ適用)を定義できます。 設定可能な値は、7日、15日、30日、60日、90日です。マスキングの対象範囲および設定可能な遅延期間は、ご利用のVonage通信APIによって異なります。一部の通信APIは「スタンダード自動マスキング」のみをサポートしていますが、他のAPIでは「アドバンスト自動マスキング」もサポートしています。 「標準自動マスキング」では、サーバーログをマスキングすることはできません。CDRのみをマスキングしますが、サーバーログ内の個人データは約15日間保持されます。「高度な自動マスキング」では、CDRとサーバーログの両方をマスキングします。詳細については、以下の段落で説明します。

「自動伏字処理」サービスの料金については、こちらをご覧ください: Messages API の料金体系.

ご自身のアカウントで「自動伏字」サービスの有効化をご希望の場合は、担当のAccountマネージャーまでお問い合わせいただくか、 サポートリクエストを送信する 必要事項をフォームに入力してください。これにより、サポートチームにチケットが作成され、担当者が社内の関連チームと連携して、お客様のAccountで本サービスを有効化いたします。お客様の安全を確保するため、Accountで自動マスキングサービスを有効化する前に、お客様の事業内容について初期審査を行います。その際、詳細を確認するため、弊社からご連絡させていただく場合がございます。

自動リダクト vs Redact API

特徴 Redact API オートリダクト・スタンダード 高度な自動再編集
使用方法 編集したい各レコードについて、レコードIDを知る必要があります。 Redact API. 自動。顧客の介入を必要としない。 自動。顧客の介入を必要としない。
再編集の範囲 CDRのみ CDRのみ サーバーログとCDR
再編集オプション 商品ごとに1件のリクエスト 修正済み(対応製品すべて) 修正済み(対応製品すべて)
呼び出し遅延 CDRが長期ストレージに伝搬された後にのみ、正常に呼び出すことができる。 7日、15日、30日、60日、90日 即時
プロビジョニング 必須 必須 必須
対応製品 SMS、Number Insight API、Messages API*、音声、Verify、ネットワークAPI**、Vonage QoD SMS、Number Insight、Messages API*、音声、Verify SMS、Number Insight、Messages API*、Verify
価格 無料 有料 有料

*対応チャネル:SMS、WhatsApp、RCS、メール、Messenger、Viber、MMS

**既存および将来のすべてのネットワークAPIが含まれます**

APIごとの編集範囲の詳細説明

SMS API

特徴 説明
個人データ 個人データには、メッセージの内容、送信メッセージの受信者の電話番号およびIPアドレス、ならびに受信メッセージの送信者の電話番号が含まれます。個人データは、CDR、サーバーログ、およびデータパイプラインログの長期保存領域に保存されます。 SMS APIでは、データパイプラインソフトウェアを使用してCDRを各種データベースへ転送しています。データパイプラインでは、CDRを受信者および送信者の電話番号とともに7日間保持します。長期保存先に保存された個人データは、上記の表に示されている通り、13ヶ月間保持されます。サーバーログに保存されたデータは10日間保持されます。
対応している自動伏字の種類 アドバンスまたはスタンダード
詳細の自動伏せ書き SMS向け高度な自動マスキング機能は、CDR、サーバーログ、およびデータパイプラインのログをマスキングします。自動マスキングの対象範囲には、メッセージ本文および電話番号のマスキングが含まれます。 送信時 — 受信者の電話番号およびIPアドレス。受信時 — 送信者の電話番号。即時マスキングの場合、メッセージ内容はサーバーログやデータパイプラインログにも一切書き込まれません。電話番号は、サーバーログやデータパイプラインログに書き込まれる前に、SMS APIによって暗号化されます。 CDRがCDRの長期保存領域に転送されると、暗号化された電話番号フィールドはIPアドレスとともに自動的にマスキングされます。暗号化された電話番号およびIPアドレスを含むログは、自動的に有効期限が切れます。Secret Managerに保存されている前述の復号鍵にアクセスできるのは、権限を持つ限られた数のVonageエンジニアのみです。 高度な自動マスキング機能は、Vonage SMS APIを介して送信されるメッセージでのみ利用可能です。Vonage SMS APIを通じて受信される着信メッセージについては、HIPAAに基づく業務提携契約(BAA)が締結されていない限り、お客様は標準の自動マスキング機能をご利用いただけます。

Number Insight API

特徴 説明
個人データ 個人データには、電話番号および電話番号の所有者の詳細(名、姓、発信者名、加入者ID)が含まれます。NI APIは、データパイプラインソフトウェアを使用して、CDRをさまざまなデータベースに転送します。 個人データは、CDR、サーバーログ、およびデータパイプラインログの長期保存領域に保存されます。データパイプラインは、個人データを含むログを7日間保持します。長期保存領域に保存された個人データは、上記の表に示されているとおり、13か月間保持されます。サーバーログに保存されたデータは、13日間保持されます。
対応している自動伏字の種類 アドバンスまたはスタンダード
詳細の自動伏せ書き NI向けの高度な自動マスキング機能は、サーバーログ、CDR、およびデータパイプラインのログをマスキングします。自動マスキングの対象範囲には、電話番号および所有者の詳細情報のマスキングが含まれます。即時マスキングが設定されている場合、マスキング対象のフィールドの内容は、サーバーログやデータパイプラインのログにも一切書き込まれません。

Messages API

特徴 説明
個人データ 個人データには、メッセージの内容に加え、発信メッセージの場合は受信者の電話番号、着信メッセージの場合は発信者の電話番号が含まれます。個人データは、CDR、サーバーログ、およびデータパイプラインログの長期保存領域に保存されます。 Messages APIは、データパイプラインソフトウェアを使用してCDRをさまざまなデータベースに転送します。データパイプラインでは、CDRと受信者/送信者の電話番号を7日間保持します。長期保存領域に保存された個人データは、上記の表に示されているとおり、13ヶ月間保持されます。サーバーログに保存されたデータは、約10日間保持されます。
対応している自動伏字の種類 アドバンスまたはスタンダード
詳細の自動伏せ書き Messages API の標準的な自動マスキング機能は、CDR の長期保存データ内の CDR のみをマスキングします。自動マスキングの対象範囲は以下の通りです。メッセージの内容および電話番号のマスキング。発信メッセージ — 受信者の電話番号。着信メッセージ — 発信者の電話番号。

Voice API

Voice API を使用して通話を行うと、1 つ以上の通話リソースと、通話詳細記録(CDR)が作成されます。 Auto-redact サービスや Redact API を使用して CDR から個人データ(この場合は電話番号)を削除することは可能ですが、電話番号を含む通話リソースは引き続き存在し続けます。

呼リソースは「レグ」として格納される。たとえば、仮想番号Vと他の2つの電話番号AおよびBとの間でプロキシ呼が設 定された場合、AとVの間と、BとVの間の2つのレグが存在することになる。

レッグ・リソースの識別子を決定するには List Legs エンドポイント でフィルタリングするクエリパラメータを追加します。 conversationUuid 通話中

識別子がわかれば、各レッグ・リソースは 「Leg」エンドポイントを削除.

通話録音が有効になっている音声アプリケーションの場合、たとえば、次のように使用します。 レコードアクション NCCO に対して、その録画を格納するメディアリソースが作成されます。これは、の DELETE メソッドを使用して削除できます。 メディアアイテムの削除エンドポイント.

特徴 説明
個人データ 個人データには、発信時の着信先電話番号および着信時の発信元電話番号が含まれます。
対応している自動伏字の種類 スタンダード
詳細の自動伏せ書き Voice API の標準自動マスキング機能は、CDR の長期保存データ内の CDR のみをマスキングします。マスキングの対象範囲は以下の通りです:発信者および着信者の電話番号。

ベリファイAPI

特徴 説明
個人データ 個人データには、メッセージや通話に関する電話番号やメールアドレス、および顧客番号が含まれます。
対応している自動伏字の種類 アドバンスまたはスタンダード
詳細の自動伏せ書き Verify API の標準的な自動マスキング機能は、CDR の長期保存データ内の CDR のみをマスキングします。マスキングの対象範囲は、宛先の電話番号またはメールアドレス、およびクライアント参照番号です。

消去請求

GDPR(およびその他のプライバシー関連法規)に基づき、個人は、企業が自身に関して保持しているデータの削除を企業に請求する権利を有しています。

ユーザーから個人データの削除依頼があった場合、Redact API を使用して、当社のシステム内のすべての通信記録(「CDR」と呼ばれる)から当該ユーザーの個人データを削除するか、または自動削除サービスをご利用いただけます。

顧客ダッシュボード

データのマスキングを行ったことを証明する必要がある場合は、顧客ダッシュボードの「ログ」セクションからその証明を行うことができます。

の中で Vonageカスタマーダッシュボード, ユーザーインターフェースを介してレコードを検索することができます。通常、検索を行うには、以下のページにアクセスします。 ログ > [該当する製品を選択]、および検索:

  • たとえば、トランザクションIDを指定することで、1通のSMSの詳細情報を確認できます。 message-id.
  • 例えば、電話番号と日付を指定して、特定の日付に特定の電話番号宛てに送信されたすべてのSMSを検索します。
  • 日付範囲:たとえば、特定の日付の間のすべてのメッセージ(上限4000件)をダウンロードする場合など。

クエリの対象期間が30日間に限定されているため、特定の1人宛てに送信されたメッセージを1件または数件検索したい場合には、この方法が適しているかもしれません。より長い期間のデータを検索する場合は、Reports APIをご利用ください。

ダッシュボードを使用すると、以下を検索できます。 SMSのログ, 音声通話, リクエストのVerify, SIMスワップ、QoDのリクエスト、および Numbersインサイト. 絶対日付または相対日付で検索できます。

Reports API

データのマスキングを行ったことを証明する必要がある場合は、Reports API を通じてその証明を行うことができます。

について Reports API は、あらゆる種類の通信APIのあらゆる種類のデータレコードを一括して検索するために使用できる。関連するモードは2つある:

Reports APIの使用方法については、以下を参照してください。 レポートAPIの概要.

技術サポートへの影響

データの再編集は、お客様固有のサービス低下のトラブルシューティングに悪影響を及ぼす可能性があることをご了承ください。お客様の成功へのコミットメントの一環として、Vonageサポートは可能な限りすべてのお客様にサポートを提供するよう努めます。

Redact API による情報マスキングは、Vonage サポートへの影響が限定的です。これは、マスキング処理前のサーバーログが有効期限(約 15 日)が切れるまでは引き続きアクセス可能であるためです。Auto-redact サービスによる遅延付き自動マスキングについても同様です。 「Advanced Auto-redact」は、即時黒塗り処理を行うように設定されているため、Vonageサポートがトラブルシューティングに利用できる未黒塗りのデータソースが一切残らないことから、Vonageサポートへの影響が最も大きくなります。

通常、Vonageサポートでは、問題の原因となっている特定のAPI呼び出しや、問題に関連する通信イベント、あるいは関連するイベント(メッセージや通話)のパターンを特定することで、問題の診断を行います。Vonageサポートでは、問題が発生した日付や電話番号、メッセージの本文などを基に、問題に関連するデータレコードを特定する必要がある場合がよくあります。その例としては、次のようなものがあります:

  • について to ユーザーの電話番号にSMSを送信します。
  • について from Vonageバーチャル番号へのインバウンドコール用の電話番号。

即時番号非表示機能を有効にしている場合、Vonageサポートでは、電話番号と時間帯の情報だけではサポートを行うことができません。データレコードやログに電話番号が記録されていないと、Vonageサポートでは差分分析を行い、特定の番号または番号範囲について、経時的な失敗・成功トランザクションの比較(パターン分析)を行うことができません。 その代わりに、APIのレスポンスで返された関連するトランザクションIDをご提供いただく必要があります。例えば、SMSの場合、これは message-id 値。お使いのシステムで、Vonage API から受信した応答をログに記録・保存していない場合、またはこの応答データへのアクセスが困難な場合は、Reports API またはカスタマーダッシュボードのいずれかを使用して、当社システム内のトランザクションデータレコードを確認し、問題に関連するレコードを特定した上で、その ID を当社に共有してトラブルシューティングを行ってください。

これらのIDがあれば、Vonageサポートは問題を即座に特定できる場合もありますが、場合によってはかなりの時間がかかることもあります。例えば、SMSに対して「即時高度自動編集」機能が有効になっている場合、通信サービスプロバイダーが、メッセージの内容に関する現地の規制や何らかの理由によりSMSを拒否した場合は、 Unicode エンコーディングに関する問題, その場合、メッセージ本文がわからないと、Vonageサポートは問題を即座に特定することができず、トラブルシューティングの過程で通信サービスプロバイダーの協力を仰ぐ必要さえ生じる可能性があります。

なお、すべての取引データレコードは13か月後に削除されますので、この期間が経過した後の取引に関する問題の診断については、お手伝いすることができません。