pachca-security

pachca-security

クイックスタート

Pachca トークンをユーザーに尋ねます（ボットの場合：Integrations → Bots にあるボットの API タブ、ユーザーの場合：Integrations → API）。

--token フラグを付けて、npx -y @pachca/cli 経由でコマンドを実行します。

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

または、PACHCA_TOKEN 環境変数を設定します。

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

ヘルプ：npx -y @pachca/cli --help | ワークフロー：npx -y @pachca/cli guide

正常に使用できたら、CLI のグローバルインストールを提案してください：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

開始する前に

1. ユーザーに保存済みのプロファイルがある場合は、確認します。

   npx -y @pachca/cli auth status
   

   問題がなければ、--token を付けずにコマンドを実行します。

2. プロファイルが設定されていない場合は、トークンを尋ねて --token を使用します。

   npx -y @pachca/cli auth status --token $PACHCA_TOKEN
   

3. パラメーターがわからない場合は、pachca <command> --help を実行します。

ワークフロー

イベント監査ログを取得する

1. 監査ログを取得します。

   pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601>
   

   start_time と end_time は省略可能です（ISO-8601。オフセットのない時刻は UTC として扱われます）。指定しない場合は、すべてのイベントがページごとに返されます。フィルター：event_key、actor_id、actor_type、entity_id、entity_type

スペースのオーナーのみが利用できます。

不審なログインを監視する

1. 指定期間の 2FA 失敗イベントを取得します。

   pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601> --event-key=user_2fa_fail --all
   

2. --event-key=user_2fa_disabled を指定してリクエストを再実行し、従業員の二要素認証が無効になっていないか確認します。

   pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601> --event-key=user_2fa_disabled --all
   

3. 異常が見つかった場合は、管理者に通知を送信します。

   pachca messages create --entity-type=user --entity-id=<admin_id> --content="Обнаружены подозрительные входы"
   

指定期間のログをエクスポートする

1. ページネーションを使用して、指定期間のすべてのイベントを取得します。

   pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601> --all
   

2. すべてのイベントを配列にまとめ、ファイルに保存するか、外部システムに送信します。

利用可能な event_key の値

カテゴリー	キー
認証	user_login, user_logout, user_2fa_fail, user_2fa_success, user_2fa_disabled, login_grant_created, login_grant_approved, login_grant_denied
従業員	user_created, user_deleted, user_role_changed, user_updated
タグ	tag_created, tag_deleted, user_added_to_tag, user_removed_from_tag
チャット	chat_created, chat_renamed, chat_permission_changed
チャットメンバー	user_chat_join, user_chat_leave, tag_added_to_chat, tag_removed_from_chat
メッセージ	message_updated, message_deleted, message_created
リアクションとスレッド	reaction_created, reaction_deleted, thread_created
トークン	access_token_created, access_token_updated, access_token_destroy, bot_token_recreated, bot_token_created, bot_token_updated, bot_token_reissued, bot_token_deleted, oauth_token_revoked
ボット	bot_scopes_updated, bot_webhook_settings_updated, bot_deleted, bot_oauth_client_updated, bot_oauth_client_disabled, bot_oauth_client_secret_rotated, bot_oauth_client_secret_issued
アプリの認証	oauth_authorization_granted, oauth_authorization_revoked, oauth_device_authorization_approved, oauth_device_authorization_denied
暗号化	kms_encrypt, kms_decrypt
セキュリティ	audit_events_accessed, company_chats_accessed, company_bots_accessed, dlp_violation_detected
検索（API）	search_users_api, search_chats_api, search_messages_api
ビデオ通話	video_call_started, video_call_finished, video_call_recording_ready
インテグレーション	exchange_disabled

制限事項

• レート制限：約 50 req/sec。429 が返された場合は、待ってから再試行してください。
• limit：最大 50
• ページネーション：カーソルベース（limit + cursor）
• start_time と end_time は省略可能です（ISO-8601。範囲の開始と終了を含み、オフセットのない時刻は UTC として扱われます）。指定しない場合、このメソッドはすべてのイベントをページごとに返します。

エンドポイント

メソッド	パス	説明
GET	/audit_events	イベント監査ログ

タスクの進め方がわからない場合は、references/ から該当するファイルを読んでください。