API de SIEM

La API de SIEM expone los eventos de auditoría del Workspace como un feed JSON paginado, compatible con el estándar Common Event Format (CEF). Úsela para ingerir los registros de auditoría de Altium 365 en su sistema de Security Information and Event Management (SIEM) o en cualquier herramienta externa de cumplimiento.

Cómo encontrar su endpoint y credenciales

Cada Workspace tiene su propia URL de endpoint de auditoría y sus propias credenciales. Para encontrarlas:

1. Vaya a Admin → Settings → Audit Export en su Workspace.

2. Copie el Endpoint URL, Client ID y Secret Key.

Puede regenerar o revocar la Secret Key desde esta página en cualquier momento. Al regenerar una clave, la anterior se invalida de inmediato.

Autenticación

Cada solicitud requiere dos encabezados personalizados:

Obtención de eventos

GET {your-audit-endpoint}?Offset=0&Limit=500
ClientId: {your-client-id}
ClientSecret: {your-secret-key}

Parámetros de consulta

Ejemplo de curl

curl -G '{your-audit-endpoint}' \
  -H 'ClientId: {your-client-id}' \
  -H 'ClientSecret: {your-secret-key}' \
  --data-urlencode 'Offset=0' \
  --data-urlencode 'Limit=500'

Formato de respuesta

{
  "TotalCount": 2,
  "Events": [
    {
      "CefVersion": "1",
      "DeviceVendor": "Altium",
      "DeviceProduct": "365 Platform",
      "DeviceVersion": "Cloud",
      "DeviceEventClassId": "",
      "Name": "User Login",
      "Extension": {
        "dvchost": "host.domain.com",
        "msg": "User successful login",
        "rt": "2024-01-10T14:30:00Z",
        "dtz": "UTC+00:00",
        "suser": "sampleuser",
        "act": "login",
        "externalId": "45678",
        "cat": "authentication"
      }
    }
  ]
}

Campos de nivel superior

Campos del evento

Campos de extensión

Paginación

Use TotalCount de la primera respuesta para determinar cuántas páginas se deben recuperar. Incremente Offset según su Limit en cada solicitud posterior hasta recuperar todos los eventos.

Page 1: Offset=0,   Limit=500   → events 1–500
Page 2: Offset=500, Limit=500   → events 501–1000
...

Códigos de estado HTTP

Lecturas adicionales

Audit Export en Altium 365 – configuración y ajuste de Workspace admin.