# 監査ログ

> [!WARNING]
> この機能は、Team & Enterprise プランの一部です。

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

  <img
    class="block dark:hidden m-0!"
    src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/enterprise/audit-logs.png"
    alt="screenshot of Hugging Face Audit Logs feature"
  />
  <img
    class="hidden dark:block m-0!"
    src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/enterprise/dark-audit-logs.png"
    alt="screenshot of Hugging Face Audit Logs feature"
  />

## 監査ログへのアクセス

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`フィールドであり、ログの検索やフィルタリングに使用します。

### 組織管理とセキュリティ

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

- **コア組織の変更** — 作成、削除、復元、名前の変更。
  - **イベント:** `org.create`、`org.delete`、`org.restore`、`org.rename`
- **設定の変更** — 組織設定の更新は、細粒度の`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`

  
- **セキュリティ管理**
  - 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によるログインと参加、およびメンバーによるアクセストークンとSSHキーの認可または認可解除。
  - **イベント:** `org.sso_login`、`org.sso_join`、`org.sso_credential.authorize`、`org.sso_credential.deauthorize`
- **参加設定** — ドメインベースのアクセスと自動参加の構成。
  - **イベント:** `org.update_join_settings`

### メンバーシップとアクセス制御

- **メンバーのライフサイクル** — メンバーの追加と削除、ロールの変更、組織からの退会。
  - **イベント:** `org.add_user`、`org.remove_user`、`org.change_role`、`org.leave`
- **アカウントの種類** — メンバーを[外部コラボレーター](./security-sso-user-management#external-collaborators)に変更するか、メンバーに戻すか。
  - **イベント:** `org.change_account_type`
- **招待** — 招待の送信、メールによる招待リンクの送信、ユーザーによる招待の受け入れ。
  - **イベント:** `org.invite_user`、`org.invite.accept`、`org.invite.email`
- **自動参加** — 検証済みメールドメインまたは「アクセス要求」による参加。
  - **イベント:** `org.join.from_domain`、`org.join.automatic`

### サービスアカウント

- **サービスアカウントのライフサイクル**: サービスアカウントの作成と削除。
  - **イベント:** `org.service_account.create`、`org.service_account.delete`
- **サービスアカウントトークン**: トークンの作成、削除、ローテーション、更新（名前、権限、ネットワークセキュリティの例外設定）、およびトークンに紐付けられた 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 アプリの管理** — 組織が所有する[OAuth アプリ](./oauth#organization-owned-oauth-apps)（[Token Exchange アプリ](./oauth#token-exchange-for-organizations-rfc-8693)を含む）の作成、更新（名前、URL、スコープ、またはトークンの有効期限）、削除、およびメンバーの個人アプリを組織への移管。ロゴの変更は記録されません。
  - **イベント:** `oauth.app.create`、`oauth.app.update`、`oauth.app.delete`、`oauth.app.move`
- **クライアントシークレット** — クライアントシークレットのローテーション（またはパブリックアプリへの追加）、削除、および Hugging Face によるシークレットの有効期限切れ。
  - **イベント:** `oauth.app.secret.rotate`、`oauth.app.secret.delete`、`oauth.app.secret.expire`
- **トークンの発行** — 組織の [Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) アプリを通じてメンバーに発行されるトークン。
  - **イベント:** `oauth.token`

### コンテンツとリソースの管理

- **リポジトリ管理** — 作成、削除、移動、無効化/再有効化、複製設定、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`
- **コレクション** — コレクションの作成と削除。
  - **イベント:** `collection.create`、`collection.delete`
- **リポジトリのセキュリティ** — シークレットと変数（個別および一括での追加・更新・削除）。
  - **イベント（シークレット）:** `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 の設定** — ストレージ階層の変更、ハードウェア（flavor）の更新、スリープ時間の調整。
  - **イベント:** `spaces.add_storage`、`spaces.remove_storage`、`spaces.update_hardware`、`spaces.update_sleep_time`

### リソースグループ

- **リソースグループの管理** — 作成、削除、設定の変更。
  - **イベント:** `resource_group.create`、`resource_group.delete`、`resource_group.settings`
- **リソースグループのメンバー** — ユーザーの追加と削除、およびロールの変更。
  - **イベント:** `resource_group.add_users`、`resource_group.remove_users`、`resource_group.change_role`
- **リソースグループへの招待** — 組織外からユーザーをリソースグループに招待し、その招待を取り消すこと。
  - **イベント:** `resource_group.invite_user`、`resource_group.invite.revoke`

### ジョブとスケジュールジョブ

- **ジョブ** — ジョブの作成（Space 上での作成など）とキャンセル。
  - **イベント:** `jobs.create`、`jobs.cancel`
- **スケジュールされたジョブ** — 実行の作成、削除、再開、停止、トリガー。
  - **イベント:** `scheduled_job.create`、`scheduled_job.delete`、`scheduled_job.resume`、`scheduled_job.suspend`、`scheduled_job.run`

### 請求とクラウド統合

- **支払いと顧客** — 支払い方法の更新、追加、削除、顧客アカウントの作成。
  - **イベント:** `billing.update_payment_method`、`billing.create_customer`、`billing.remove_payment_method`
- **クラウドマーケットプレイス** — AWSおよびGCPのマーケットプレイスへのリンク/リンク解除、およびマーケットプレイスの承認。
  - **イベント:** `billing.aws_add`、`billing.aws_remove`、`billing.gcp_add`、`billing.gcp_remove`、`billing.marketplace_approve`
- **サブスクリプション** — サブスクリプションの開始、更新、キャンセル、再開、および更新（プランと契約の詳細を含む）。
  - **イベント:** `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`として記録されますが、このイベントはデフォルトの監査ログビューには含まれません。