mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
0d52a48ff2
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
137 lines
6.4 KiB
Plaintext
137 lines
6.4 KiB
Plaintext
---
|
||
title: "审计日志"
|
||
description: "查看审计日志，追踪组织成员执行的操作，包括部署、配置更改和权限更新。"
|
||
keywords: ["监控", "活动追踪", "安全", "合规", "SIEM"]
|
||
---
|
||
|
||
<Info>
|
||
审计日志适用于 [Enterprise 方案](https://mintlify.com/pricing?ref=audit-logs)。
|
||
</Info>
|
||
|
||
使用审计日志来监控和跟踪组织成员执行的操作。审计日志为安全、合规和故障排查提供完整的活动记录。
|
||
|
||
- **监控安全**：跟踪认证尝试和权限变更。
|
||
- **确保合规**：维护所有组织活动的记录。
|
||
- **排查问题**：调查失败的操作及其原因。
|
||
- **跟踪变更**：查看是谁在何时做出了特定更改。
|
||
|
||
<div id="view-audit-logs">
|
||
## 查看审计日志
|
||
</div>
|
||
|
||
只有组织管理员可以查看和导出审计日志。
|
||
|
||
前往 dashboard 的 [Audit log](https://app.mintlify.com/settings/organization/audit-logs) 页面查看审计日志。Mintlify 会将审计日志条目保留两年。将日志导出为 CSV，以便长期保存记录。
|
||
|
||
点击任意日志条目以展开并查看详细信息，包括：
|
||
|
||
| 字段 | 说明 |
|
||
| ----- | ----------- |
|
||
| Timestamp | 操作发生的日期和时间 |
|
||
| Actor | 执行该操作的用户的电子邮箱地址 |
|
||
| Action | 用户执行的操作内容 |
|
||
| Category | 受影响的资源类型 |
|
||
| Outcome | 操作是成功还是失败 |
|
||
| Metadata | 有关该操作的其他上下文信息 |
|
||
|
||
<div id="filter-logs">
|
||
### 筛选日志
|
||
</div>
|
||
|
||
筛选审计日志以查找特定活动。
|
||
|
||
**日期范围**：选择预设的日期范围，以查看特定时间段内的日志。
|
||
|
||
**类别**：按操作类型筛选日志。
|
||
|
||
| Category | Description |
|
||
|------------------|--------------------------------------------------------------------|
|
||
| Organization | 组织设置更新和删除请求。 |
|
||
| Member | 团队成员邀请、移除、角色变更以及撤销凭证。 |
|
||
| Deployment | 部署配置更改，包括自定义域名、认证、Git 源、MCP 客户端凭证、回滚和构建提升。 |
|
||
| Preview deployment | 预览部署的创建、更新和认证更改。 |
|
||
| API key | API key 和 Discovery API key 的创建和删除。 |
|
||
| Assistant | Assistant 设置更新，例如分流邮件、网页搜索站点和初始问题。 |
|
||
| PDF export | PDF 导出的生成和删除。 |
|
||
| Integration | GitHub 和 Slack 的安装与移除。 |
|
||
| Billing | 订阅更新、附加组件购买和发票查看。 |
|
||
| Quota | 超额策略和告警配置更改。 |
|
||
| User | 个人用户通知设置。 |
|
||
| Automations | 自动化配置和存储库管理。 |
|
||
| Audit log | 审计日志的查看和导出。 |
|
||
| Auth | 登录尝试、登出、会话创建和应急访问登录。 |
|
||
| SSO | SSO 连接更改、登录策略更新、应急访问更新以及已验证域名的更改。 |
|
||
| SCIM | 来自身份提供商的自动化用户配置、更新和取消配置，以及组角色映射的更改。 |
|
||
|
||
<div id="stream-audit-logs">
|
||
## 流式传输审计日志
|
||
</div>
|
||
|
||
以近乎实时的方式将审计日志流式传输到 Amazon S3 或 Datadog。使用流式传输将审计事件发送到你现有的安全监控和长期保留系统，无需反复导出 CSV 文件。
|
||
|
||
组织管理员可以添加多个目标，并选择要发送的类别。默认情况下，所有类别都会进行流式传输，且类别选择会应用于所有已配置的目标。
|
||
|
||
<div id="add-a-destination">
|
||
### 添加目标
|
||
</div>
|
||
|
||
1. 前往 dashboard 的 [Audit log](https://app.mintlify.com/settings/organization/audit-logs) 页面。
|
||
2. 在 **Audit log streaming** 部分，点击 **Configure**。
|
||
3. 点击 **Add destination**，然后选择 **Amazon S3** 或 **Datadog**。
|
||
4. 输入用于标识该目标的可选标签，然后提供所需的连接详细信息：
|
||
|
||
| 目标 | 必填详细信息 | 可选详细信息 |
|
||
| --- | --- | --- |
|
||
| Amazon S3 | Bucket、AWS 区域、access key ID 和 secret access key | Key 前缀 |
|
||
| Datadog | Datadog 站点和 API key | 无 |
|
||
|
||
5. 点击 **Add destination**。
|
||
|
||
<AccordionGroup>
|
||
<Accordion title="准备 Amazon S3 凭证">
|
||
创建一个 IAM 用户（或具有编程访问凭证的角色），其策略允许写入目标 bucket。至少要为你计划使用的 bucket 和 key 前缀授予 `s3:PutObject` 权限。例如：
|
||
|
||
```json
|
||
{
|
||
"Version": "2012-10-17",
|
||
"Statement": [
|
||
{
|
||
"Effect": "Allow",
|
||
"Action": ["s3:PutObject"],
|
||
"Resource": "arn:aws:s3:::your-bucket-name/audit-logs/*"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
在添加目标时，请使用该 IAM 用户的 access key ID 和 secret access key。key 前缀是可选的，会作为前缀添加到 Mintlify 写入的每个对象。
|
||
</Accordion>
|
||
<Accordion title="准备 Datadog 凭证">
|
||
在 Datadog 账户的 **Organization Settings > API Keys** 中创建一个 Datadog API key。请勿使用 application key。
|
||
|
||
将 Datadog 站点设置为与你的 Datadog 账户所在区域相匹配，例如 `datadoghq.com`（US1）、`us3.datadoghq.com`、`us5.datadoghq.com`、`datadoghq.eu`（EU1）、`ap1.datadoghq.com` 或 `ddog-gov.com`。使用错误的站点将导致事件被拒绝。
|
||
</Accordion>
|
||
</AccordionGroup>
|
||
|
||
要停止向某个目标进行流式传输，打开流式传输配置，然后点击该目标旁边的 <Icon icon="trash-2" /> 移除图标。
|
||
|
||
<div id="select-streamed-categories">
|
||
### 选择要流式传输的类别
|
||
</div>
|
||
|
||
1. 前往 dashboard 的 [Audit log](https://app.mintlify.com/settings/organization/audit-logs) 页面。
|
||
2. 在 **Audit log streaming** 部分，点击 **Configure**。
|
||
2. 在 **Streamed categories** 下，选择你想要发送的类别。清除某个类别以将其事件从流中排除。
|
||
3. 点击 **Save changes**。
|
||
|
||
<div id="export-audit-logs">
|
||
## 导出审计日志
|
||
</div>
|
||
|
||
将审计日志导出为 CSV，用于分析、合规报告或长期归档。
|
||
|
||
1. 前往 dashboard 的 [Audit log](https://app.mintlify.com/settings/organization/audit-logs) 页面。
|
||
2. （可选）应用筛选条件以缩小要导出的日志范围。
|
||
3. 点击 **Export CSV**。
|
||
4. 当导出完成后，Mintlify 会向你发送一封包含下载链接的电子邮件。
|