監査ログ

この機能は、Team & Enterprise プランの一部です。

Audit Logsにより、組織管理者は、組織のメンバーシップ、リポジトリ設定、請求変更を含む、メンバーによって実行されたアクションを簡単に確認できます。

監査ログへのアクセス

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）があります。これは各ログエントリおよびエクスポートされた JSON 内のtypeフィールドであり、ログの検索やフィルタリングに使用します。

組織管理とセキュリティ

以下の設定変更イベントは、2026年6月16日以降に行われたアクションでのみ利用可能です。それ以前のイベントは、独自のorg.update_settingsイベントタイプを使用しています。2026年6月16日より前に作成された組織のイベントtypeフィールドをフィルタリングまたはパースする統合は、両方のタイプを処理する必要があります。

• 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
  • Organization 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 の削除、リソースグループの割り当て、および一般的なリポジトリ設定（可視性、ゲーティング、ディスカッションなど）。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 — ストレージ階層の変更、ハードウェア（フレーバー）の更新、およびスリープ時間の調整。
  • イベント: 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

イベント参照

上記のリストは、監査ログ UI およびエクスポートに表示されるすべてのイベントタイプを網羅しています。イベント名はscope.actionパターンに従っており、スコープにはorg、repo、collection、spaces、resource_group、jobs、scheduled_job、oauth、billingが含まれます。エクスポート操作自体はorg.audit_log.exportとして記録されますが、このイベントはデフォルトの監査ログビューには含まれません。