pachca-security

https://api.pachca.com/api/shared/v1

Authorization: Bearer <ACCESS_TOKEN>

Когда использовать

• аудит
• журнал событий
• безопасность
• DLP
• логи
• подозрительные входы
• история входов

Когда НЕ использовать

• получить профиль, мой профиль, установить статус → pachca-profile
• найти сотрудника, создать пользователя, список сотрудников → pachca-users
• создать канал, создать беседу, создать чат → pachca-chats
• отправить сообщение, ответить в тред, прикрепить файл → pachca-messages
• настроить бота, вебхук, webhook → pachca-bots
• показать форму, интерактивная форма, модальное окно → pachca-forms
• создать задачу, список задач, напоминание → pachca-tasks

Пошаговые сценарии

Получить журнал аудита событий

1. GET /audit_events с фильтрами (

   event_key

   , период, пагинация)
2. Доступные типы событий: входы, изменения прав, действия с чатами и т.д.

curl "https://api.pachca.com/api/shared/v1/audit_events?created_at[from]=$DATE_FROM&created_at[to]=$DATE_TO&limit=50" \
  -H "Authorization: Bearer $TOKEN"

Доступно только владельцу пространства.

Мониторинг подозрительных входов

1. GET /audit_events с фильтром

   "event_key": "user_2fa_fail"

   (или

   "user_signed_in"

   ) за нужный период
2. Пагинируй с

   cursor

   до получения всех записей
3. Если найдены аномалии (много неудачных 2FA с одного аккаунта) — отправь уведомление администратору через POST /messages

Фильтрация по

event_key

— строковое совпадение. Доступные ключи — в документации Аудит событий.

Экспорт логов за период

1. GET /audit_events с параметрами

   created_at[from]

   и

   created_at[to]

   (ISO 8601)
2. Пагинируй с

   cursor

   до получения всех записей (

   limit

   до 50)
3. Собери все события в массив → сохрани в файл или отправь во внешнюю систему (SIEM, таблицы)

Обработка ошибок

insufficient_scope

Доступные операции

Журнал аудита событий

GET /audit_events

скоуп:

audit_events:read

· тариф: Корпорация

Ограничения и gotchas

• limit

  : максимум 50
• Пагинация: cursor-based (limit + cursor), НЕ page-based

Подробнее