Atlassian監査Logsのオンボード
ベータ版
Lakewatchはベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。ワークスペース レベルのプレビューを管理するを参照してください。
Lakewatchは、Atlassianから組織の監査ログイベントを取り込むためのAPIコネクターを提供します。この記事では、前提条件、設定手順、コネクタースキーマ、およびセキュリティ観測対象について説明します。
前提条件
コネクターには次のものが必要です:
- Serverless LakeFlow Pipelinesがワークスペースでオンになっていること。
- Unity Catalog。Unity Catalog 接続を作成または使用する権限が必要です。接続パーミッションを参照してください。
- ワークスペース管理者によってワークスペースでオンにされた Lakeflow Connect for Atlassian Audit Logs プレビュー。「コネクタのプレビューをオンにする」を参照してください。
- ワークスペースの Serverless ネットワークポリシーで制限付きアクセスを使用している場合、ソースの API ドメインはポリシーの「 許可されたドメイン 」リストに登録されている必要があります。「ネットワークポリシーでソース API ドメインを許可する」を参照してください。
- Atlassian Guard Standard、Atlassian Guard Premium、またはクラウド Enterpriseのサブスクリプション。これらのいずれかがないと、Atlassianの組織監査Logsにデータは記録されません。Atlassianの監査ログアクティビティに関するドキュメントを参照してください。
- コネクタを認証するAPIキーを作成するための組織管理者権限。AtlassianのOrganizations REST API ドキュメントを参照してください。
既知の制限事項
- SCDタイプ2はサポートされていません。
- コネクタは、Atlassian組織のAPIキー認証をサポートしています。OAuthおよび基本ユーザー名とパスワード認証はサポートされていません。
- Atlassian APIキーの有効期限は最大1年です。現在のキーの有効期限が切れる前に、新しいキーを作成し、Unity Catalog接続を更新してください。
- 履歴のルックバックは180日を超えてはなりません。取り込む期間を選択するを参照してください。
取り込み用にAtlassianを構成する
Atlassianは、コネクタがベアラートークンとして送信するAPIキーで管理者APIリクエストを認証します。情報については、 管理者APIsを使用して組織を管理するためのAtlassianのガイドを参照してください。
- 組織管理者権限を持つユーザーとしてAtlassian管理にサインインします。複数の組織を管理している場合は、組織を選択します。
- 組織設定 を選択し、 APIキー を選択します。
- スコープ付き API キー を選択し、 API キーの作成 を選択します。
- キーの 名前 を入力し、有効期限を選択してください。キーの有効期限は1年以内にする必要があります。
read:events:admin範囲を選択します( イベント に対して 読み取り として表示されます)。これは、コネクタが必要とする唯一のスコープです。AtlassianのOrganizations REST APIイベントのドキュメントを参照してください。- キーを確認してから、 作成 を選択します。
- 組織ID と APIキー をコピーします。Atlassianはこれらの値を再度表示しません。それらを使用して、Databricksで Unity Catalog接続を作成します。
Atlassian APIキーは最大1年で有効期限が切れるため、自動更新されません。キーの有効期限が切れる前に、新しい組織APIキーを作成し、既存のUnity Catalog接続の APIキー を更新してください。新しい接続を作成しないでください。
Lakewatch UIを通じて接続を作成するときに、収集した 組織ID と APIキー を入力します。
情報については、「Atlassian への認証を構成する」を参照してください。
次のステップ
上記の構成が完了したら、Lakewatch UIのAtlassianコネクタでデータソースを作成します。手順については、 API コネクター を参照してください。
コネクタとLakewatchスキーマ
コネクタは、default ソーススキーマから次のソーステーブルを取り込みます:
ソーステーブル | アトラシアンのデータ | 組み込みLakewatchパーサー |
|---|---|---|
| 組織ユーザー、セキュリティ、および構成の変更イベント |
|
コネクタは、各ソーステーブルを、その組み込みパーサー用に構成された宛先に直接書き込みます。defaultでは、宛先テーブル名は <parser>_<datasource> となります。ここで <datasource> はデータソース名です。たとえば、defaultのデータソース名 atlassian_audit_logs の場合、テーブルは atlassian_audit_atlassian_audit_logs になります。データソースの作成中に別の宛先を設定できます。別の生ステージングテーブルや後の解析ステップはありません。
Lakewatch管理列
コネクタは、ソースidフィールドをNULL不可の主キーとして使用し、ソースtimeフィールドを増分インジェストのカーソルとして使用します。Lakewatch IDを合成するコネクタとは異なり、このコネクタはlw_id列を追加しません。
Lakewatchデータソースの場合、コネクタは以下も追加します。
lw_meta:データソースと接続 ID、パーサー名とバージョン、およびインジェクション時間。lw_observables: コネクタによって抽出されたセキュリティ観測値。
情報については、「 コネクタ出力テーブル」を参照してください。
コネクター出力テーブルスキーマ
宛先には、上記の lw_meta および lw_observables 列に加えて、以下のソースおよびイベント列が含まれています。
次のスキーマには、Atlassian組織の監査イベントフィールドが含まれています。フィールドの定義については、「Atlassian Audit Logsコネクターのリファレンス」を参照してください。
スキーマ
列 | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
セキュリティ可観測項目
コネクターは、以下のフィールドをlw_observablesに抽出します。
可観測項目
フィールド | 可観測 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|