SIEM API

SIEM API 以分页 JSON 流的形式公开 Workspace 审计事件，与通用事件格式 (CEF) 标准兼容。使用它可将 Altium 365 审计日志摄取到安全信息和事件管理 (SIEM) 系统或任何外部合规性工具中。

查找端点和凭证

每个工作区都有自己的审计端点 URL 和凭证。要找到它们

1. 转到 Admin → Settings → Audit Export工作区。

2. 复制图标 Endpoint URL, Client ID和 Secret Key.

您可以随时从该页面重新生成或撤销秘钥。重新生成密钥后，先前的密钥立即失效。

身份验证

每个请求都需要两个自定义标头：

事件检索

GET {your-audit-endpoint}?offset=0&limit=500
客户端 ID：{您的客户端 ID}
ClientSecret : {your-secret-key} 客户端密钥

请求参数

Curl 示例

curl -G '{your-audit-endpoint}' （你的审计端点\H 'ClientId' : 'ClientId' : 'ClientId
  -H 'ClientId : {your-client-id}' \N- H 'ClientId : {your-client-id\H 'ClientSecret : {your-secret-key}' （客户密钥\H
  -H 'ClientSecret : {your-secret-key}' \N- 'ClientSecret : {your-secret-key\N- 'ClientSecret : {your-secret-key}' H -data-urlencode 'Offset=0
  --data-urlencode "Offset=0" \N -data-urlencode "Offset=0" \N
  --data-urlencode "限制=500

响应格式

{
  "TotalCount" : 2、
  "事件"：[
    {
      "CefVersion" : "1"、
      "DeviceVendor" : "Altium"、
      "DeviceProduct" : "365 Platform"、
      "DeviceVersion" : "Cloud"、
      "DeviceEventClassId": ""、
      "名称"："用户登录
      "扩展"：{
        "dvchost" : "host.domain.com"、
        "msg": "用户登录成功"、
        "rt"："2024-01-10T14:30:00Z"、
        "dtz"："UTC+00:00"、
        "suser": "sampleuser"、
        "行为"："登录"、
        "externalId" : "45678"、
        "cat" : "身份验证
      }
    }
  ]
}

顶级字段

事件字段

扩展字段

分页

使用 TotalCount来确定要检索的页数。递增 Offset递增 Limit递增，直到检索完所有事件。

第 1 页：偏移=0，限制=500 → 事件 1-500
第 2 页：偏移=500，限制=500 → 事件 501-1000
...

HTTP 状态代码

了解更多信息

Altium 365 中的审计导出- 工作区管理员设置和配置。