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

OpenAI 監査Logs

備考

ベータ版

Lakewatchはベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。ワークスペースレベルのプレビューを管理するを参照してください。

Lakewatch APIコネクタを使用して、OpenAI API Platformから組織の監査ログイベントを取り込みます。このページでは、前提条件、設定手順、コネクタスキーマ、およびセキュリティ・オブザーバブルについて説明します。

前提条件​

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

  1. ワークスペースでServerless Lakeflow pipelinesが有効になっています。
  2. Unity Catalog、Unity Catalog接続を作成または使用する権限。接続権限を参照してください。
  3. ワークスペース管理者がワークスペースで有効にした Lakeflow Connect for OpenAI のプレビュー。コネクタのプレビューを有効にするを参照してください。
  4. ワークスペースのServerlessネットワークポリシーが制限付きアクセスを使用している場合、ソースのAPIドメインをポリシーの「 許可されたドメイン 」リストに追加する必要があります。ネットワークポリシーでソースAPIドメインを許可するを参照してください。
  5. OpenAI組織で監査ログがオンになっています。監査ログがオンになった後、それをオフにできるのはOpenAIサポートのみです。OpenAIの管理者および監査Logs APIのドキュメントを参照してください。
  6. 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への認証の構成を参照してください。

  1. 組織の所有者として OpenAI プラットフォームにサインインします。
  2. 組織の 管理者キー ページを開きます。
  3. 管理APIキーを作成し、アクセス許可を 読み取り専用 に設定します。読み取り専用アクセスで取り込みには十分です。APIキーのアクセス許可の割り当てに関するOpenAIのガイドをご覧ください。
  4. Admin APIキーをコピーします。OpenAIは、フルキーを1回のみ表示します。
ヒント

Lakewatch UI を使用して接続を作成するときに、前のステップでコピーした Admin API Key を入力します。

次のステップ​

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


コネクタとLakewatchスキーマ​

Lakewatch は、OpenAI 組織の監査ログ イベントを audit_log_entries という名前の 1 つのテーブルに取り込みます。

ソーステーブル

OpenAIデータ

組み込みのLakewatchパーサー

audit_log_entries

APIキー、ユーザー、プロジェクト、組織設定の変更などの組織の監査Logsイベント

openai_audit

ソーステーブル

OpenAIデータ

組み込みのLakewatchパーサー

audit_log_entries

APIキー、ユーザー、プロジェクト、組織設定の変更などの組織の監査Logsイベント

openai_audit

コネクタは、各ソーステーブルをその組み込みパーサーに対して構成された宛先に直接書き込みます。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

id

STRING

type

STRING

effective_at

TIMESTAMP

actor

VARIANT

project

STRUCT<id: STRING, name: STRING>

data

VARIANT

Column

Data type

id

STRING

type

STRING

effective_at

TIMESTAMP

actor

VARIANT

project

STRUCT<id: STRING, name: STRING>

data

VARIANT

フィールドの定義については、OpenAI の監査ログ オブジェクト ドキュメントを参照してください。

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

コネクタはこれらのフィールドを lw_observables に抽出します:

可観測項目

Field

Observable

actor.session.user.id

actor_id

actor.session.user.email

email

actor.session.ip_address

ip

actor.api_key.user.id

actor_id

actor.api_key.user.email

email

actor.api_key.service_account.id

actor_id

Field

Observable

actor.session.user.id

actor_id

actor.session.user.email

email

actor.session.ip_address

ip

actor.api_key.user.id

actor_id

actor.api_key.user.email

email

actor.api_key.service_account.id

actor_id

data のフィールドは、イベント type に依存します。コネクタは data をスキャンし、サブフィールド名を一致させることで lw_observables に値を抽出します。一致では大文字と小文字が区別されません。

データの可観測項目

data subfield name

Observable

email

email

allowed_ips

ip

principal_id, service_account_id

actor_id

role_arn

aws_arn

account_id

aws_account_id

data subfield name

Observable

email

email

allowed_ips

ip

principal_id, service_account_id

actor_id

role_arn

aws_arn

account_id

aws_account_id