メインコンテンツまでスキップ

Zendesk監査Logs

Lakewatchは、Zendesk Supportからアカウント監査ログを取り込むためのAPIコネクタを提供します。このページでは、前提条件、設定手順、コネクタスキーマ、およびセキュリティ観測対象について説明します。

前提条件​

コネクタには以下が必要です:

  1. ワークスペースで Serverless LakeFlow Pipelines がオンになっています。
  2. Unity Catalog および Unity Catalog 接続を作成または使用する権限。接続の権限を参照してください。
  3. ワークスペースのServerlessネットワークポリシーが制限付きアクセスを使用している場合、ソースのAPIドメインはポリシーの「 許可されたドメイン 」リストに存在する必要があります。ネットワークポリシーでソースAPIドメインを許可するを参照してください。
  4. OAuthクライアントを作成する権限を持つZendeskサポートアカウント。アプリケーションでのOAuth認証の使用を参照してください。
  5. Zendeskサポート監査Logs APIへのアクセス。監査Logsを参照してください。

既知の制限事項​

  • Slowly changing dimension (SCD) type 2はサポートされていません。
  • コネクタは、OAuth ユーザーマシン間 (U2M) 認証のみをサポートしています。OAuth マシン間認証および基本認証はサポートされていません。
  • audit_logs テーブルの最初の同期は、データソースの起動時刻に起動します。これは過去 30 日以内でなければなりません。起動時刻を設定しない場合、インジェクションはデータソースを作成したときに開始されます。それ以降の同期は、最後にインジェストされた time 値から再開されます。インジェストする期間の選択をご覧ください。

インジェストのための Zendesk Support の構成​

Zendesk Supportで機密性の高いOAuthクライアントを作成します。 一意の識別子 は、Databricksに入力するクライアントIDです。

  1. https://<subdomain>.zendesk.com/admin/homeの管理センターに移動します。

  2. [アプリと統合] > [APIs] > [OAuth クライアント] をクリックします。

  3. OAuthクライアントリストの右側にある「 OAuthクライアントの追加 」をクリックします。

  4. クライアントを作成するために必要なフィールドを完成させます:

    • クライアント名: Zendesk Support インスタンスにアクセスできるアプリのリストに表示される名前を入力します。

    • 一意の識別子: フィールドをクリックして、クライアント名を自動的に入力します。必要に応じて変更できます。この値は、Databricks の クライアント ID です。

    • クライアントの種類: 機密 を選択します。

    • リダイレクトURL: https://<your_workspace_domain>/login/oauth/lakehousefederation.htmlを入力します。

      <your_workspace_domain> を 1234567890123456.7.gcp.databricks.comのような ワークスペース インスタンス名 に置き換えます。

  5. 保存 をクリックします。表示される新しい、事前入力された シークレット 値をコピーします。これは、接続を作成するときに使用するクライアントシークレットです。Zendeskはそれを一度だけ表示します。

  6. 保存 を再度クリックします。

  7. Zendeskのサブドメインを控えてください(例:https://your-company.zendesk.comのyour-company)。

ヒント

Lakewatch UIから接続を作成するときに、前のステップの サブドメイン 、 クライアントID (一意の識別子)、および クライアントシークレット を入力します。 Sign in with Zendesk Support をクリックし、アプリケーションを承認します。

OAuth用にZendeskサポートを構成するを参照してください。

次のステップ​

Zendeskサポートを構成した後、Lakewatch UIのZendeskコネクタでデータソースを作成します。手順については、API コネクタを参照してください。


コネクタとLakewatchのスキーマ​

コネクタは、default ソーススキーマから以下のソーステーブルを取り込みます。

ソーステーブル

Zendesk データ

組み込みLakewatchパーサー

audit_logs

アカウントレベルの管理操作および変更

zendesk_audit

ソーステーブル

Zendesk データ

組み込みLakewatchパーサー

audit_logs

アカウントレベルの管理操作および変更

zendesk_audit

コネクタは、各ソーステーブルを組み込みパーサー用に構成された宛先に直接書き込みます。defaultでは、宛先テーブル名は <parser>_<datasource> になります。<datasource> はデータソース名です。たとえば、defaultのデータソース名 zendesk の場合、テーブルは zendesk_audit_zendesk になります。データソースの作成時に異なる宛先を設定できます。個別の未処理ステージングテーブルや後の解析ステップはありません。

Lakewatch管理カラム​

コネクタは、各出力行に次の列を追加します。

  • lw_id: Lakewatchが主キーとして使用するnull以外の文字列。コネクタは、ソースの created_at フィールドと id フィールドから、安定した時間順に並べ替え可能なIDを生成します。
  • time: ソースcreated_at値から変換された非null UTC Timestamp。このコネクタは、増分取り込みのカーソル列としてtimeを使用します。

コネクタはソース id フィールドを宛先テーブルに書き込みません。

Lakewatchデータソースの場合、コネクタは lw_meta と lw_observables も追加します。lw_meta には、データソースと接続ID、パーサー名とバージョン、および取り込み時間が含まれます。lw_observables には、コネクタによって抽出されたセキュリティ監視対象が含まれます。コネクタ出力テーブルを参照してください。

コネクタの出力テーブルスキーマ​

宛先には、以下のソース列とイベント列が含まれ、上記で説明したlw_meta列とlw_observables列も含まれます。

次のスキーマには、Zendesk Support 監査ログフィールドが含まれています。フィールド定義については、 Zendesk Support コネクターリファレンスおよび Zendesk 監査Logs APIを参照してください。

スキーマ

列

データ型

lw_id

STRING

time

TIMESTAMP

action

STRING

action_label

STRING

actor_id

BIGINT

actor_name

STRING

change_description

STRING

created_at

STRING

ip_address

STRING

source_id

BIGINT

source_label

STRING

source_type

STRING

url

STRING

列

データ型

lw_id

STRING

time

TIMESTAMP

action

STRING

action_label

STRING

actor_id

BIGINT

actor_name

STRING

change_description

STRING

created_at

STRING

ip_address

STRING

source_id

BIGINT

source_label

STRING

source_type

STRING

url

STRING

セキュリティ可観測項目​

コネクタは、次のフィールドを lw_observables に抽出します。

可観測項目

フィールド

インジケーター

actor_name

username

ip_address

ip

url

url

フィールド

インジケーター

actor_name

username

ip_address

ip

url

url