将服务日志或审计日志发布到外部服务

MinIO 支持使用 环境变量 指定 minio server 日志 HTTP Webhook 端点及其相关配置项。

下面的示例代码设置了配置日志 HTTP Webhook 端点所需的 全部 环境变量。 其中最少 必须 配置的变量为：

• MINIO_LOGGER_WEBHOOK_ENABLE

• MINIO_LOGGER_WEBHOOK_ENDPOINT

   export MINIO_LOGGER_WEBHOOK_ENABLE_<IDENTIFIER>="on"
   export MINIO_LOGGER_WEBHOOK_ENDPOINT_<IDENTIFIER>="https://webhook-1.example.net"
   export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_<IDENTIFIER>="TOKEN"

• 将 <IDENTIFIER> 替换为该 HTTP Webhook 端点的唯一描述字符串。 与新日志 HTTP Webhook 相关的所有环境变量都应使用同一个 <IDENTIFIER>。

  如果指定的 <IDENTIFIER> 与现有日志端点匹配， 新设置将 覆盖 该端点的现有设置。 可使用 mc admin config get logger_webhook 查看当前已配置的日志 HTTP Webhook 端点。

• 将 https://webhook-1.example.net 替换为 HTTP Webhook 端点的 URL。

• 将 TOKEN 替换为适用于该端点的认证令牌类型。 对于无需认证的端点，可省略该项。

  为支持多种令牌类型，MinIO 会按 原样 使用该值创建请求认证头。 根据端点不同，你可能需要包含额外信息。

  例如，对于 Bearer token，请在前面加上 Bearer：

  export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_myendpoint="Bearer 1a2b3c4f5e"
  

  请根据端点要求调整该值。 自定义认证格式可能类似如下：

  export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_xyz="ServiceXYZ 1a2b3c4f5e"
  

  详情请参阅目标服务的文档。

重启 MinIO server 以应用新的配置项。 你必须在部署中的 所有 MinIO server 上指定相同的环境变量和设置。

MinIO 支持在 MinIO 部署上使用 mc admin config set 命令和 logger_webhook 配置键新增或更新日志 HTTP Webhook 端点。 应用任何新增或更新后的配置项都需要重启 MinIO 部署。

下面的示例代码设置了配置日志 HTTP Webhook 端点相关的 全部 配置项。 其中最少 必须 配置的项为 logger_webhook endpoint：

mc admin config set ALIAS/ logger_webhook:IDENTIFIER  \
   endpoint="https://webhook-1.example.net"           \
   auth_token="TOKEN"

• 将 <IDENTIFIER> 替换为该 HTTP Webhook 端点的唯一描述字符串。 与新日志 HTTP Webhook 相关的所有环境变量都应使用同一个 <IDENTIFIER>。

  如果指定的 <IDENTIFIER> 与现有日志端点匹配， 新设置将 覆盖 该端点的现有设置。 可使用 mc admin config get logger_webhook 查看当前已配置的日志 HTTP Webhook 端点。

• 将 https://webhook-1.example.net 替换为 HTTP Webhook 端点的 URL。

• 将 TOKEN 替换为适用于该端点的认证令牌类型。 对于无需认证的端点，可省略该项。

  为支持多种令牌类型，MinIO 会按 原样 使用该值创建请求认证头。 根据端点不同，你可能需要包含额外信息。

  例如，对于 Bearer token，请在前面加上 Bearer：

   mc admin config set ALIAS/ logger_webhook    \
      endpoint="https://webhook-1.example.net"  \
      auth_token="Bearer 1a2b3c4f5e"
  

  请根据端点要求调整该值。 自定义认证格式可能类似如下：

  mc admin config set ALIAS/ logger_webhook    \
     endpoint="https://webhook-1.example.net"  \
     auth_token="ServiceXYZ 1a2b3c4f5e"
  

  详情请参阅目标服务的文档。

MinIO 支持使用 环境变量 指定审计日志 HTTP Webhook 端点及其相关配置项。

下面的示例代码设置了配置审计日志 HTTP Webhook 端点所需的 全部 环境变量。 其中最少 必须 配置的变量为：

• MINIO_AUDIT_WEBHOOK_ENABLE

• MINIO_AUDIT_WEBHOOK_ENDPOINT

export MINIO_AUDIT_WEBHOOK_ENABLE_<IDENTIFIER>="on"
export MINIO_AUDIT_WEBHOOK_ENDPOINT_<IDENTIFIER>="https://webhook-1.example.net"
export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_<IDENTIFIER>="TOKEN"
export MINIO_AUDIT_WEBHOOK_CLIENT_CERT_<IDENTIFIER>="cert.pem"
export MINIO_AUDIT_WEBHOOK_CLIENT_KEY_<IDENTIFIER>="cert.key"

• 将 <IDENTIFIER> 替换为该 HTTP Webhook 端点的唯一描述字符串。 与新审计日志 HTTP Webhook 相关的所有环境变量都应使用同一个 <IDENTIFIER>。

  如果指定的 <IDENTIFIER> 与现有日志端点匹配， 新设置将 覆盖 该端点的现有设置。 可使用 mc admin config get audit_webhook 查看当前已配置的审计日志 HTTP Webhook 端点。

• 将 https://webhook-1.example.net 替换为 HTTP Webhook 端点的 URL。

• 将 TOKEN 替换为适用于该端点的认证令牌类型。 对于无需认证的端点，可省略该项。

  为支持多种令牌类型，MinIO 会按 原样 使用该值创建请求认证头。 根据端点不同，你可能需要包含额外信息。

  例如，对于 Bearer token，请在前面加上 Bearer：

  export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_myendpoint="Bearer 1a2b3c4f5e"
  

  请根据端点要求调整该值。 自定义认证格式可能类似如下：

  export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_xyz="ServiceXYZ 1a2b3c4f5e"
  

  详情请参阅目标服务的文档。

• 将 cert.pem 和 cert.key 替换为要向 HTTP Webhook server 提交的 x.509 TLS 证书公钥与私钥。 对于不要求客户端出示 TLS 证书的端点，可省略该项。

重启 MinIO server 以应用新的配置项。 你必须在部署中的 所有 MinIO server 上指定相同的环境变量和设置。

MinIO 支持在 MinIO 部署上使用 mc admin config set 命令和 audit_webhook 配置键新增或更新审计日志 HTTP Webhook 端点。 应用任何新增或更新后的配置项都需要重启 MinIO 部署。

下面的示例代码设置了配置审计日志 HTTP Webhook 端点相关的 全部 配置项。 其中最少 必须 配置的项为 audit_webhook endpoint：

mc admin config set ALIAS/ audit_webhook:IDENTIFIER  \
   endpoint="https://webhook-1.example.net"          \
   auth_token="TOKEN"                                \
   client_cert="cert.pem"                            \
   client_key="cert.key"

• 将 <IDENTIFIER> 替换为该 HTTP Webhook 端点的唯一描述字符串。 与新审计日志 HTTP Webhook 相关的所有环境变量都应使用同一个 <IDENTIFIER>。

  如果指定的 <IDENTIFIER> 与现有日志端点匹配， 新设置将 覆盖 该端点的现有设置。 可使用 mc admin config get audit_webhook 查看当前已配置的审计日志 HTTP Webhook 端点。

• 将 https://webhook-1.example.net 替换为 HTTP Webhook 端点的 URL。

• 将 TOKEN 替换为适用于该端点的认证令牌类型。 对于无需认证的端点，可省略该项。

  为支持多种令牌类型，MinIO 会按 原样 使用该值创建请求认证头。 根据端点不同，你可能需要包含额外信息。

  例如，对于 Bearer token，请在前面加上 Bearer：

   mc admin config set ALIAS/ audit_webhook     \
      endpoint="https://webhook-1.example.net"  \
      auth_token="Bearer 1a2b3c4f5e"
  

  请根据端点要求调整该值。 自定义认证格式可能类似如下：

  mc admin config set ALIAS/ audit_webhook     \
     endpoint="https://webhook-1.example.net"  \
     auth_token="ServiceXYZ 1a2b3c4f5e"
  

  详情请参阅目标服务的文档。

• 将 cert.pem 和 cert.key 替换为要向 HTTP Webhook server 提交的 x.509 TLS 证书公钥与私钥。 对于不要求客户端出示 TLS 证书的端点，可省略该项。