OpenAI 監査Logs
ベータ版
Lakewatchはベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。ワークスペースレベルのプレビューを管理するを参照してください。
Lakewatch APIコネクタを使用して、OpenAI API Platformから組織の監査ログイベントを取り込みます。このページでは、前提条件、設定手順、コネクタスキーマ、およびセキュリティ・オブザーバブルについて説明します。
前提条件
コネクタには以下が必要です:
- ワークスペースでServerless Lakeflow pipelinesが有効になっています。
- Unity Catalog、Unity Catalog接続を作成または使用する権限。接続権限を参照してください。
- ワークスペース管理者がワークスペースで有効にした Lakeflow Connect for OpenAI のプレビュー。コネクタのプレビューを有効にするを参照してください。
- ワークスペースのServerlessネットワークポリシーが制限付きアクセスを使用している場合、ソースのAPIドメインをポリシーの「 許可されたドメイン 」リストに追加する必要があります。ネットワークポリシーでソースAPIドメインを許可するを参照してください。
- OpenAI組織で監査ログがオンになっています。監査ログがオンになった後、それをオフにできるのはOpenAIサポートのみです。OpenAIの管理者および監査Logs APIのドキュメントを参照してください。
- OpenAI組織内の組織所有者ロール。コネクタを認証する管理者APIキーを作成するために必要です。OpenAIの管理者APIsガイドをご覧ください。
既知の制限事項
- slowly changing dimensions(SCD)タイプ2はサポートされていません。
- このコネクタは、OpenAI管理者APIキー認証をサポートしています。標準のプロジェクトAPIキーとOAuthはサポートされていません。
audit_log_entriesテーブルの最初の同期は、データソースの起動時刻に起動されます。これは過去365日以内でなければなりません。起動時刻を設定しない場合、データソースの作成時に取り込みが開始されます。その後の同期は、最後に実行されたeffective_at値から再開されます。取り込みの開始日を選択するを参照してください。
インジェスト用の OpenAI を構成する
コネクタは、管理APIキーを使用してOpenAI管理APIに対して認証を行います。このキーはBearerトークンとして送信されます。管理APIキーは、管理APIのEndpointでのみ動作します。完全なステップについては、OpenAIへの認証の構成を参照してください。
- 組織の所有者として OpenAI プラットフォームにサインインします。
- 組織の 管理者キー ページを開きます。
- 管理APIキーを作成し、アクセス許可を 読み取り専用 に設定します。読み取り専用アクセスで取り込みには十分です。APIキーのアクセス許可の割り当てに関するOpenAIのガイドをご覧ください。
- Admin APIキーをコピーします。OpenAIは、フルキーを1回のみ表示します。
Lakewatch UI を使用して接続を作成するときに、前のステップでコピーした Admin API Key を入力します。
次のステップ
OpenAIを構成した後、Lakewatch UIでOpenAIコネクタを使用してデータソースを作成します。手順についてはAPIコネクタを参照してください。
コネクタとLakewatchスキーマ
Lakewatch は、OpenAI 組織の監査ログ イベントを audit_log_entries という名前の 1 つのテーブルに取り込みます。
ソーステーブル | OpenAIデータ | 組み込みのLakewatchパーサー |
|---|---|---|
| APIキー、ユーザー、プロジェクト、組織設定の変更などの組織の監査Logsイベント |
|
コネクタは、各ソーステーブルをその組み込みパーサーに対して構成された宛先に直接書き込みます。defaultでは、宛先テーブルの名前は <parser>_<datasource> です。ここで <datasource> はデータソース名です。たとえば、default のデータソース名 openai の場合、テーブルは openai_audit_openai です。データソースの作成時に別の宛先を設定できます。別のrawステージングテーブルや後のパーシングステップはありません。
Lakewatch で管理される列
このコネクターは、ソース id フィールドを NULL でない主キーとして使用し、ソース effective_at フィールドを増分インジェストのカーソルとして使用します。Lakewatch ID を合成するコネクターとは異なり、このコネクターは lw_id または time カラムを追加しません。クエリーまたは検出ルールを時間枠に制限するには、effective_at カラムを IN_TIMERANGE() に渡します。
Lakewatch データソースの場合、コネクタは次も追加します。
lw_meta:データソースと接続の識別情報、パーサー名とバージョン、取り込み時刻。lw_observables:コネクタによって抽出されたセキュリティ観測対象。
コネクタ出力テーブルをご覧ください。
コネクタの出力テーブルスキーマ
宛先には、以下のソース列とイベント列が含まれ、さらに上記で説明したlw_meta列とlw_observables列が含まれます。
audit_log_entries テーブルには、監査ログ イベントごとに 1 行が書き込まれます。各行には、イベントの ID、型、および時間が含まれ、さらにイベントのスコープとなるアクターとプロジェクトも含まれます。data 列には、イベント type にちなんで名付けられた詳細オブジェクト (例: project.updated) を含む、VARIANT としての元の監査ログ レコード全体が格納されます。
スキーマ
Column | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
フィールドの定義については、OpenAI の監査ログ オブジェクト ドキュメントを参照してください。
セキュリティ可観測項目
コネクタはこれらのフィールドを lw_observables に抽出します:
可観測項目
Field | Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
data のフィールドは、イベント type に依存します。コネクタは data をスキャンし、サブフィールド名を一致させることで lw_observables に値を抽出します。一致では大文字と小文字が区別されません。
データの可観測項目
| Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|