API SIEM

La API SIEM expone los eventos de auditoría de Workspace como una fuente JSON paginada, compatible con el estándar Common Event Format (CEF). Utilícela para introducir registros de auditoría de Altium 365 en su sistema de información de seguridad y gestión de eventos (SIEM) o en cualquier herramienta de cumplimiento externa.

Cómo encontrar su punto final y sus credenciales

Cada espacio de trabajo tiene su propia URL de punto final de auditoría y sus propias credenciales. Para encontrarlas:

1. Vaya a Admin → Settings → Audit Export en su espacio de trabajo.

2. Copie el icono Endpoint URL, Client IDy Secret Key.

Puede regenerar o revocar la Clave Secreta desde esta página en cualquier momento. La regeneración de una clave invalida inmediatamente la anterior.

Autenticación

Cada solicitud requiere dos cabeceras personalizadas:

Obtención de eventos

GET {su-punto-final-de-auditoría}?Offset=0&Limit=500
ClientId: {su-id-de-cliente}
ClientSecret: {su clave secreta}

Parámetros de consulta

Ejemplo de Curl

curl -G '{su-punto-final-de-auditoría}' \
  -H 'ClientId: {su-id-cliente}' \
  -H 'ClientSecret: {su-clave-secreta}' \
  --data-urlencode 'Offset=0' \
  --data-urlencode 'Limit=500'

Formato de la respuesta

{
  "TotalCount" 2,
  "Eventos": [
    {
      "CefVersion": "1",
      "DeviceVendor": "Altium",
      "DeviceProduct": "365 Platform",
      "DeviceVersion": "Cloud",
      "DeviceEventClassId": "",
      "Name": "User Login",
      "Extension": {
        "dvchost": "host.dominio.com",
        "msg": "Usuario ha iniciado sesión con éxito",
        "rt": "2024-01-10T14:30:00Z",
        "dtz": "UTC+00:00",
        "suser": "sampleuser",
        "act": "login",
        "externalId": "45678",
        "cat": "authentication"
      }
    }
  ]
}

Campos de nivel superior

Campos de evento

Campos de extensión

Paginación

Utilice TotalCount de la primera respuesta para determinar cuántas páginas recuperar. Incremente Offset por su Limit en cada solicitud posterior hasta que se recuperen todos los eventos.

Página 1: Offset=0, Límite=500 → eventos 1-500
Página 2: Offset=500, Límite=500 → eventos 501-1000
...

Códigos de estado HTTP

Lecturas Adicionales

Exportación de Auditoría en Altium 365 - Instalación y configuración del administrador del espacio de trabajo.