Zendesk監査Logs
Lakewatchは、Zendesk Supportからアカウント監査ログを取り込むためのAPIコネクタを提供します。このページでは、前提条件、設定手順、コネクタスキーマ、およびセキュリティ観測対象について説明します。
前提条件
コネクタには以下が必要です:
- ワークスペースで Serverless LakeFlow Pipelines がオンになっています。
- Unity Catalog および Unity Catalog 接続を作成または使用する権限。接続の権限を参照してください。
- ワークスペースのServerlessネットワークポリシーが制限付きアクセスを使用している場合、ソースのAPIドメインはポリシーの「 許可されたドメイン 」リストに存在する必要があります。ネットワークポリシーでソースAPIドメインを許可するを参照してください。
- OAuthクライアントを作成する権限を持つZendeskサポートアカウント。アプリケーションでのOAuth認証の使用を参照してください。
- Zendeskサポート監査Logs APIへのアクセス。監査Logsを参照してください。
既知の制限事項
- Slowly changing dimension (SCD) type 2はサポートされていません。
- コネクタは、OAuth ユーザーマシン間 (U2M) 認証のみをサポートしています。OAuth マシン間認証および基本認証はサポートされていません。
audit_logsテーブルの最初の同期は、データソースの起動時刻に起動します。これは過去 30 日以内でなければなりません。起動時刻を設定しない場合、インジェクションはデータソースを作成したときに開始されます。それ以降の同期は、最後にインジェストされたtime値から再開されます。インジェストする期間の選択をご覧ください。
インジェストのための Zendesk Support の構成
Zendesk Supportで機密性の高いOAuthクライアントを作成します。 一意の識別子 は、Databricksに入力するクライアントIDです。
-
https://<subdomain>.zendesk.com/admin/homeの管理センターに移動します。 -
[アプリと統合] > [APIs] > [OAuth クライアント] をクリックします。
-
OAuthクライアントリストの右側にある「 OAuthクライアントの追加 」をクリックします。
-
クライアントを作成するために必要なフィールドを完成させます:
-
クライアント名: Zendesk Support インスタンスにアクセスできるアプリのリストに表示される名前を入力します。
-
一意の識別子: フィールドをクリックして、クライアント名を自動的に入力します。必要に応じて変更できます。この値は、Databricks の クライアント ID です。
-
クライアントの種類: 機密 を選択します。
-
リダイレクトURL:
https://<your_workspace_domain>/login/oauth/lakehousefederation.htmlを入力します。<your_workspace_domain>を1234567890123456.7.gcp.databricks.comのような ワークスペース インスタンス名 に置き換えます。
-
-
保存 をクリックします。表示される新しい、事前入力された シークレット 値をコピーします。これは、接続を作成するときに使用するクライアントシークレットです。Zendeskはそれを一度だけ表示します。
-
保存 を再度クリックします。
-
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パーサー |
|---|---|---|
| アカウントレベルの管理操作および変更 |
|
コネクタは、各ソーステーブルを組み込みパーサー用に構成された宛先に直接書き込みます。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_observables に抽出します。
可観測項目
フィールド | インジケーター |
|---|---|
|
|
|
|
|
|