Rechercher Rechercher dans la documentation

API SIEM

Updated: July 06, 2026

L’API SIEM expose les événements d’audit du Workspace sous forme de flux JSON paginé, compatible avec la norme Common Event Format (CEF). Utilisez-la pour ingérer les journaux d’audit d’Altium 365 dans votre système de Security Information and Event Management (SIEM) ou dans tout autre outil externe de conformité.

Enterprise license required. L’option Audit Export n’apparaît dans les paramètres d’administration du Workspace que lorsqu’une licence de niveau Enterprise est active.

Trouver votre endpoint et vos identifiants

Chaque Workspace possède sa propre URL d’endpoint d’audit et ses propres identifiants. Pour les trouver :

Accédez à Admin → Settings → Audit Export dans votre Workspace.
Copiez le Endpoint URL, le Client ID et le Secret Key.

Vous pouvez régénérer ou révoquer la Secret Key depuis cette page à tout moment. La régénération d’une clé invalide immédiatement la précédente.

Authentification

Chaque requête nécessite deux en-têtes personnalisés :

Header	Value
`ClientId`	Votre Workspace Client ID
`ClientSecret`	Votre Workspace Secret Key

Récupération des événements

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

Paramètres de requête

Paramètre	Obligatoire	Description
`Offset`	Non	Position de départ dans l’ensemble de résultats. Par défaut : `0`
`Limit`	Non	Nombre maximal d’événements à renvoyer. Ne peut pas dépasser le maximum de l’API ; si cette limite est dépassée, `400` est renvoyé.

Exemple Curl

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

Format de réponse

{
  "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"
      }
    }
  ]
}

Champs de premier niveau

Champ	Type	Description
`TotalCount`	integer	Nombre total d’événements disponibles sur l’ensemble des pages
`Events`	array	Événements sur la page actuelle

Champs d’événement

Champ	Type	Description
`CefVersion`	string	Version CEF
`DeviceVendor`	string	Toujours `"Altium"`
`DeviceProduct`	string	Toujours `"365 Platform"`
`DeviceVersion`	string	Toujours `"Cloud"`
`DeviceEventClassId`	string	Identifiant de classe de l’événement
`Name`	string	Nom de l’événement lisible par un humain (par ex. `"User Login"`)
`Extension`	object	Données détaillées de l’événement – voir ci-dessous

Champs d’extension

Champ	Type	Description
`dvchost`	string	Nom de domaine pleinement qualifié du Workspace
`msg`	string	Description de l’événement lisible par un humain
`rt`	string	Horodatage de l’événement (ISO 8601)
`dtz`	string	Fuseau horaire (par ex. `"UTC+00:00"`)
`suser`	string	Nom d’utilisateur associé à l’événement
`act`	string	Action effectuée (par ex. `"login"`, `"create"`, `"delete"`)
`externalId`	string	ID de l’entité d’origine
`cat`	string	Catégorie de l’événement (par ex. `"authentication"`, `"design"`)

Pagination

Utilisez TotalCount de la première réponse pour déterminer combien de pages récupérer. Incrémentez Offset de votre Limit à chaque requête suivante jusqu’à ce que tous les événements aient été récupérés.

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

Codes d’état HTTP

Code	Signification
`200 OK`	Événements renvoyés avec succès
`400 Bad Request`	`Limit` dépasse le maximum de l’API
`401 Unauthorized`	Identifiants invalides, ou licence Enterprise non active

Pour en savoir plus

Audit Export dans Altium 365 – configuration et paramétrage de l’administration du Workspace.

Version imprimable

Localisé par IA

Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Entréepour nous envoyer vos commentaires.