Zendesk監査Logs

Lakewatchは、Zendeskサポートからアカウント監査Logsを取り込むためのAPIコネクタを提供します。このページでは、前提条件、構成手順、コネクタスキーマ、およびLakewatchパーサーインジケーターについて説明します。

前提条件

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

1. ワークスペースで Serverless LakeFlow Pipelines がオンになっています。
2. Unity Catalog および Unity Catalog 接続を作成または使用する権限。接続の権限を参照してください。
3. OAuthクライアントを作成する権限を持つZendeskサポートアカウント。アプリケーションでのOAuth認証の使用を参照してください。
4. 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

コネクタはソーステーブルをデータソースのRAW宛先に書き込みます。データソースを構成する際に解析済み宛先を設定しない限り、組み込みパーサーはパーサーの名前に基づく別個の解析済みテーブルを書き込みます。

Lakewatch管理カラム

コネクタは、ソースの各未加工行に次の列を追加します：

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

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

解析されたテーブルは lw_id を引き継ぎ、 lw_meta と lw_observables を追加します。lw_meta には標準の Lakewatch 処理メタデータが含まれています。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

パーサーインジケーター

zendesk_auditパーサーは、以下のフィールドを lw_observablesに抽出します。

インジケーター

フィールド	インジケーター
actor_name	username
ip_address	ip
url	url

フィールド	インジケーター
actor_name	username
ip_address	ip
url	url