Журналы аудита

Эта функция входит в планы Team & Enterprise.

Audit Logs позволяют администраторам организации легко просматривать действия, выполненные участниками, включая изменения в членстве организации, настройках репозиториев и биллинге.

Доступ к журналам аудита

Журналы аудита доступны в настройках вашей организации. Каждая запись журнала содержит:

• Кто выполнил действие
• Какой тип действия был предпринят
• Описание изменения
• Местоположение и анонимизированный IP-адрес
• Дата и время действия

Вы также можете скачать полный журнал аудита в формате JSON для дальнейшего анализа.

Экспорт через API

Программный экспорт доступен по адресу:

GET https://huggingface.co/api/organizations/{org}/audit-log/export

Авторизуйтесь с помощью токена доступа пользователя или токена сервисного аккаунта, имеющего разрешение Экспорт журнала аудита (org.auditLog.write) для организации. Ответ представляет собой JSON-массив записей журнала, идентичный файлу, скачанному со страницы настроек. Как и при ручном экспорте, вызов API фиксируется как org.audit_log.export.

Эндпоинт также описан в справочнике OpenAPI.

Какие события отслеживаются?

Каждое действие имеет имя события в формате scope.action (например, repo.create, collection.delete). Это поле type в каждой записи журнала и в экспортированном JSON — используйте его при поиске или фильтрации журналов.

Управление организацией и безопасность

События Settings changes, перечисленные ниже, доступны только для действий, выполненных после 16 июня 2026 года. Для событий, произошедших до этой даты, используется уникальный тип события org.update_settings. Любая интеграция, которая фильтрует или парсит поле type события для организаций, созданных до 16 июня 2026 года, должна обрабатывать оба варианта.

• Core organization changes — Создание, удаление, восстановление и переименование.
  • События: org.create, org.delete, org.restore, org.rename
• Settings changes — Изменения в настройках организации фиксируются в виде детализированных org.settings.* событий, что позволяет точно определить, какое именно изменение было внесено.
  • Общие настройки — профиль, регионы хранения, группы ресурсов и управление издателями.
  • События: org.settings.profile, org.settings.regions, org.settings.resource_groups, org.settings.publisher_gating
  • Поставщики инференса — конфигурация поставщика, добавление/удаление API-ключа и настройки использования.
  • События: org.settings.inference_providers, org.settings.inference_providers.keys.add, org.settings.inference_providers.keys.remove, org.settings.inference_providers.usage
  • SSO — обновления конфигурации SSO, а также включение или отключение SSO.
  • События: org.settings.sso, org.settings.sso.enable, org.settings.sso.disable
  • Безопасность — видимость репозитория по умолчанию, а также включение или отключение обязательного использования 2FA, автоматического присоединения и конфиденциальности участников.
  • События: org.settings.security.repo_visibility, org.settings.security.2fa.enable, org.settings.security.2fa.disable, org.settings.security.auto_join.enable, org.settings.security.auto_join.disable, org.settings.security.members_privacy.enable, org.settings.security.members_privacy.disable
  • Network — обновления конфигурации сети, а также включение или отключение ограничения доступа по IP и принудительной аутентификации.
  • События: org.settings.network, org.settings.network.ip_restriction.enable, org.settings.network.ip_restriction.disable, org.settings.network.auth_enforcement.enable, org.settings.network.auth_enforcement.disable
• Security management
  • Ротация токена API организации.
  • Событие: org.rotate_token
  • Система одобрения токенов — Включение или отключение политики, запросы на авторизацию, одобрения, отказы и отмены.
  • События: org.token_approval.enabled, org.token_approval.disabled, org.token_approval.authorization_request, org.token_approval.authorization_request.authorized, org.token_approval.authorization_request.revoked, org.token_approval.authorization_request.denied
  • SSO — вход и регистрация через SSO.
  • События: org.sso_login, org.sso_join
• Join settings — Доступ на основе домена и автоматическая настройка присоединения.
  • Событие: org.update_join_settings

Членство и управление доступом

• Member lifecycle — Добавление и удаление участников, изменение ролей и выход участников из организации.
  • События: org.add_user, org.remove_user, org.change_role, org.leave
• Account type — Преобразование участника в внешнего соавтора, или обратно в участника.
  • Событие: org.change_account_type
• Invitations — Отправка приглашений, ссылок на приглашения по электронной почте и принятие приглашений пользователями.
  • События: org.invite_user, org.invite.accept, org.invite.email
• Automatic joins — Присоединение через проверенный домен электронной почты или запрос доступа.
  • События: org.join.from_domain, org.join.automatic

Служебные учётные записи

• Service account lifecycle: Создание и удаление служебных учётных записей.
  • События: org.service_account.create, org.service_account.delete
• Service account tokens: Создание, удаление, ротация и обновление токенов (имя, разрешения, исключение из сетевой безопасности), а также генерация и отзыв S3-учётных данных, связанных с токеном.
  • События: org.service_account.token.create, org.service_account.token.delete, org.service_account.token.rotate, org.service_account.token.update, org.service_account.token.s3_credential.create, org.service_account.token.s3_credential.delete

OAuth-приложения

• OAuth app management — создание, обновление (имя, URL, области действия или срок действия токена) и удаление OAuth-приложений принадлежащих организации, включая её приложение Token Exchange, и передачу личного приложения участника в организацию. Изменения логотипа не фиксируются.
  • События: oauth.app.create, oauth.app.update, oauth.app.delete, oauth.app.move
• Client secret — Ротация клиентского секрета (или добавление секрета к публичному приложению), его удаление и истечение срока действия секрета со стороны Hugging Face.
  • События: oauth.app.secret.rotate, oauth.app.secret.delete, oauth.app.secret.expire
• Token issuance — Токены, выдаваемые членам через Token Exchange приложение организации.
  • Событие: oauth.token

Управление контентом и ресурсами

• Repository administration — Создание, удаление, перемещение, отключение/включение, настройки дублирования, удаление DOI, назначение группы ресурсов и общие настройки репозитория (видимость, gating, обсуждения и т. д.). Также удаление файлов LFS.
  • События: repo.create, repo.delete, repo.move, repo.disable, repo.removeDisable, repo.duplication, repo.delete_doi, repo.update_resource_group, repo.update_settings, repo.delete_lfs_file
• Collections — Создание и удаление коллекций.
  • События: collection.create, collection.delete
• Repository security — Секреты и переменные (добавление, обновление и удаление по одному и массово).
  • События (секреты): repo.add_secret, repo.update_secret, repo.remove_secret, repo.add_secrets, repo.remove_secrets
  • События (переменные): repo.add_variable, repo.update_variable, repo.remove_variable, repo.add_variables, repo.remove_variables
• Spaces configuration — Изменения уровня хранения, обновления оборудования (flavor) и настройки времени сна.
  • События: spaces.add_storage, spaces.remove_storage, spaces.update_hardware, spaces.update_sleep_time

Группы ресурсов

• Resource group administration — Создание, удаление и изменение настроек.
  • События: resource_group.create, resource_group.delete, resource_group.settings
• Resource group members — Добавление и удаление пользователей, а также изменение ролей.
  • События: resource_group.add_users, resource_group.remove_users, resource_group.change_role
• Resource group invitations — Приглашение пользователей извне организации в группу ресурсов и отмена таких приглашений.
  • События: resource_group.invite_user, resource_group.invite.revoke

Задачи и запланированные задачи

• Jobs — Создание (например, в Space) и отмена задач.
  • События: jobs.create, jobs.cancel
• Scheduled jobs — Создание, удаление, возобновление, приостановка и запуск выполнения.
  • События: scheduled_job.create, scheduled_job.delete, scheduled_job.resume, scheduled_job.suspend, scheduled_job.run

Тарификация и интеграция с облаком

• Payment and customers — Обновление, привязка и удаление способов оплаты; создание клиентских учётных записей.
  • События: billing.update_payment_method, billing.create_customer, billing.remove_payment_method
• Cloud marketplaces — связывание и отвязание маркетплейсов AWS и GCP, а также утверждение маркетплейса.
  • События: billing.aws_add, billing.aws_remove, billing.gcp_add, billing.gcp_remove, billing.marketplace_approve
• Subscriptions — Создание, продление, отмена, повторная активация и обновление подписок (включая детали плана и контракта).
  • События: billing.start_subscription, billing.renew_subscription, billing.cancel_subscription, billing.un_cancel_subscription, billing.update_subscription, billing.update_subscription_plan, billing.update_subscription_contract_details

Справочник по событиям

Список выше охватывает все типы событий, отображаемые в интерфейсе журнала аудита и при экспорте. Имена событий следуют шаблону scope.action; области (scopes) включают org, repo, collection, spaces, resource_group, jobs, scheduled_job, oauth и billing. Само действие экспорта записывается как org.audit_log.export, но это событие не включается в стандартный вид журнала аудита.