pachca-security

Original：🇺🇸 English
Translated

Журнал аудита событий и DLP-система. Используй когда нужно: получить журнал аудита, просмотреть события безопасности, настроить DLP. НЕ используй для: обычных API-запросов (→ другие скиллы). Требует тариф «Корпорация».

19installs
Sourcepachca/openapi
Added on

NPX Install

npx skill4agent add pachca/openapi pachca-security

Tags

Translated version includes tags in frontmatter
audit-loggingdlp-systempachca-apisecurity-monitoringlog-export

SKILL.md Content

View Translation Comparison →

pachca-security

Base URL: 
https://api.pachca.com/api/shared/v1
Авторизация: 
Authorization: Bearer <ACCESS_TOKEN>
Токен: бот (Автоматизации → Интеграции → API) или пользователь (Автоматизации → API). Если токен неизвестен — спроси у пользователя перед выполнением запросов.

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

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

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

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

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

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

  1. GET /audit_events с фильтрами (
    event_key
    , период, пагинация)
  2. Доступные типы событий: входы, изменения прав, действия с чатами и т.д.
bash
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, таблицы)

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

КодПричинаЧто делать
422Неверные параметрыПроверь обязательные поля, типы данных, допустимые значения enum
429Rate limitПодожди и повтори. Лимит: ~50 req/sec, сообщения ~4 req/sec
403Нет доступаНедостаточно скоупов (
insufficient_scope
), бот не в чате, или endpoint только для админов/владельцев
404Не найденоНеверный id. Проверь что сущность существует
401Не авторизованПроверь токен в заголовке Authorization

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

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

GET /audit_events
скоуп: 
audit_events:read
· тариф: Корпорация

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

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

Подробнее

см. references/endpoints.md