1Password

備考

プレビュー

Lakewatchは プライベート プレビュー段階です。アクセスをリクエストするには、Databricksアカウントチームにお問い合わせください。

Lakewatchは、1Passwordからデータを取り込むためのAPIコネクタを提供します。コネクタは、監査イベント、アイテムの使用状況、サインイン試行の3つのイベントタイプをサポートしています。このページでは、前提条件、構成手順、コネクタのスキーマ、およびLakewatchパーサーの観測可能なプロパティについて説明します。

前提条件

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

1. ワークスペースでServerless Lakeflow Spark Declarative Pipelinesが有効になっています。
2. Unity Catalog。Unity Catalog接続を作成または使用する権限が必要です。「接続のパーミッション」を参照してください。
3. イベントレポート統合を作成し、ベアラートークンを発行する権限を持つ1Passwordアカウント。1Passwordイベントレポートを参照してください。
4. アカウントリージョンのEvents APIへのアクセス。1Password Events APIを参照してください。

既知の制限事項

• 履歴のルックバックは180日を超えることはできません。取り込む期間を選択する方法を参照してください。

取り込み用に1Passwordを構成する

1Passwordは、コネクターがAuthorizationヘッダーで送信するベアラートークンでEvents APIリクエストを認証します。コネクターはトークンを更新しません。有効期間の長いトークンを発行し、取り消した場合はUnity Catalog接続でローテーションします。

1. 所有者または管理者として1Passwordアカウントにサインインします。
2. サイドバーで、 統合 をクリックします。
3. 「 ディレクトリ 」tabを開きます。 イベントレポート で、 その他 をクリックします。
4. システム名 を入力し、 統合の追加 をクリックします。
5. トークン名 を入力します。セキュリティポリシーと一致する有効期限を設定してください。 レポートするイベント で、コネクタがaudit_events、item_usages、およびsign_in_attemptsを取り込めるようにすべてのイベントタイプをオンにします。
6. トークンの発行 をクリックします。
7. アクセストークンをコピーします。1Passwordはトークンの全体を再度表示することはありません。Databricksで接続を作成する際に、この値を ベアラートークン として入力します。

ヒント

Lakewatch UIを使用して接続を作成する場合、上記で収集した アクセストークン と ベースURL が必要です。ベースURLは Events API ドキュメントを使用して識別できます。

次のステップ

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

---

コネクタとLakewatchのスキーマ

コネクタは、default ソーススキーマから次のソーステーブルを取り込みます。

ソーステーブル	1Password データ	組み込みのLakewatchパーサー
audit_events	ユーザー、ボルト、項目の変更を含むアカウントアクション	onepassword_audit_event
item_usages	共有ボールトからのアイテムアクセスイベント	onepassword_item_usage
sign_in_attempts	認証の試行	onepassword_sign_in_attempt

ソーステーブル	1Password データ	組み込みのLakewatchパーサー
audit_events	ユーザー、ボルト、項目の変更を含むアカウントアクション	onepassword_audit_event
item_usages	共有ボールトからのアイテムアクセスイベント	onepassword_item_usage
sign_in_attempts	認証の試行	onepassword_sign_in_attempt

コネクターは、ソーステーブルをデータソースの未加工の宛先に書き込みます。データソースを構成するときに解析された宛先を設定しない限り、各組み込みパーサーは、パーサー名で始まる別々の解析済みテーブルを書き込みます。

Lakewatch管理列

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

• lw_id: Lakewatchがプライマリ・キーとして使用する、null以外の文字列。このコネクターは、1Passwordの「timestamp」フィールドと「uuid」フィールドから、安定した時間順のIDを取得します。このIDは、増分同期全体で重複排除をサポートします。
• time: 1Password timestamp フィールドから RFC 3339 Timestamp として解析された非 Null Timestamp。コネクタは、増分取り込みのカーソル フィールドとして time を使用します。

解析された各テーブルはlw_idを前方に運びます。パーサーは解析されたtimeカラムも割り当て、以下を追加します。

• lw_meta: 標準のLakewatch処理メタデータ。
• lw_observables: パーサー内のセキュリティ監視対象としてマークされたフィールドから抽出された値。

情報については、 パーサー リファレンスを参照してください。

RAWコネクタテーブルスキーマ

次のスキーマには、1Password Events API フィールドと Lakewatch 管理コネクタ列が含まれています。

audit_events

スキーマ

列	データ型
lw_id	STRING
time	TIMESTAMP
uuid	STRING
timestamp	STRING
actor_uuid	STRING
actor_details	STRUCT<uuid: STRING, name: STRING, email: STRING>
actor_type	STRING
actor_account_uuid	STRING
account_uuid	STRING
action	STRING
object_type	STRING
object_uuid	STRING
object_details	STRUCT<uuid: STRING, name: STRING, email: STRING>
aux_id	INT
aux_uuid	STRING
aux_details	STRUCT<uuid: STRING, name: STRING, email: STRING>
aux_info	STRING
session	STRUCT<uuid: STRING, login_time: STRING, device_uuid: STRING, ip: STRING>
location	STRUCT<country: STRING, region: STRING, city: STRING, longitude: DOUBLE, latitude: DOUBLE>

列	データ型
lw_id	STRING
time	TIMESTAMP
uuid	STRING
timestamp	STRING
actor_uuid	STRING
actor_details	STRUCT<uuid: STRING, name: STRING, email: STRING>
actor_type	STRING
actor_account_uuid	STRING
account_uuid	STRING
action	STRING
object_type	STRING
object_uuid	STRING
object_details	STRUCT<uuid: STRING, name: STRING, email: STRING>
aux_id	INT
aux_uuid	STRING
aux_details	STRUCT<uuid: STRING, name: STRING, email: STRING>
aux_info	STRING
session	STRUCT<uuid: STRING, login_time: STRING, device_uuid: STRING, ip: STRING>
location	STRUCT<country: STRING, region: STRING, city: STRING, longitude: DOUBLE, latitude: DOUBLE>

item_usages

スキーマ

列	データ型
lw_id	STRING
time	TIMESTAMP
uuid	STRING
timestamp	STRING
used_version	INT
vault_uuid	STRING
item_uuid	STRING
action	STRING
user	STRUCT<uuid: STRING, name: STRING, email: STRING, user_type: STRING, user_account_uuid: STRING>
client	STRUCT<app_name: STRING, app_version: STRING, platform_name: STRING, platform_version: STRING, os_name: STRING, os_version: STRING, ip_address: STRING>
location	STRUCT<country: STRING, region: STRING, city: STRING, longitude: DOUBLE, latitude: DOUBLE>
account_uuid	STRING

列	データ型
lw_id	STRING
time	TIMESTAMP
uuid	STRING
timestamp	STRING
used_version	INT
vault_uuid	STRING
item_uuid	STRING
action	STRING
user	STRUCT<uuid: STRING, name: STRING, email: STRING, user_type: STRING, user_account_uuid: STRING>
client	STRUCT<app_name: STRING, app_version: STRING, platform_name: STRING, platform_version: STRING, os_name: STRING, os_version: STRING, ip_address: STRING>
location	STRUCT<country: STRING, region: STRING, city: STRING, longitude: DOUBLE, latitude: DOUBLE>
account_uuid	STRING

sign_in_attempts

スキーマ

列	データ型
lw_id	STRING
time	TIMESTAMP
uuid	STRING
session_uuid	STRING
timestamp	STRING
category	STRING
type	STRING
country	STRING
details	STRUCT<value: STRING>
target_user	STRUCT<uuid: STRING, name: STRING, email: STRING, user_type: STRING, user_account_uuid: STRING>
client	STRUCT<app_name: STRING, app_version: STRING, platform_name: STRING, platform_version: STRING, os_name: STRING, os_version: STRING, ip_address: STRING>
location	STRUCT<country: STRING, region: STRING, city: STRING, longitude: DOUBLE, latitude: DOUBLE>
account_uuid	STRING

列	データ型
lw_id	STRING
time	TIMESTAMP
uuid	STRING
session_uuid	STRING
timestamp	STRING
category	STRING
type	STRING
country	STRING
details	STRUCT<value: STRING>
target_user	STRUCT<uuid: STRING, name: STRING, email: STRING, user_type: STRING, user_account_uuid: STRING>
client	STRUCT<app_name: STRING, app_version: STRING, platform_name: STRING, platform_version: STRING, os_name: STRING, os_version: STRING, ip_address: STRING>
location	STRUCT<country: STRING, region: STRING, city: STRING, longitude: DOUBLE, latitude: DOUBLE>
account_uuid	STRING

パーサーのオブザーバブル

組み込みパーサーは、ネストされたオブジェクトをVARIANTとして書き込み、以下のフィールドをlw_observablesに抽出します。

onepassword_audit_event

可観測項目

フィールド	可観測項目
actor_uuid	actor_id
actor_details.uuid	actor_id
actor_details.name	username
actor_details.email	email
actor_account_uuid	actor_id
account_uuid	actor_id
object_details.uuid	actor_id
object_details.name	username
object_details.email	email
aux_details.uuid	actor_id
aux_details.name	username
aux_details.email	email
session.ip	ip

フィールド	可観測項目
actor_uuid	actor_id
actor_details.uuid	actor_id
actor_details.name	username
actor_details.email	email
actor_account_uuid	actor_id
account_uuid	actor_id
object_details.uuid	actor_id
object_details.name	username
object_details.email	email
aux_details.uuid	actor_id
aux_details.name	username
aux_details.email	email
session.ip	ip

onepassword_item_usage

可観測項目

フィールド	可観測項目
user.uuid	actor_id
user.email	email
client.ip_address	ip
account_uuid	actor_id

フィールド	可観測項目
user.uuid	actor_id
user.email	email
client.ip_address	ip
account_uuid	actor_id

onepassword_sign_in_attempt

可観測項目

フィールド	可観測項目
target_user.uuid	actor_id
target_user.email	email
client.ip_address	ip
account_uuid	actor_id

フィールド	可観測項目
target_user.uuid	actor_id
target_user.email	email
client.ip_address	ip
account_uuid	actor_id