API d'application Self Serve

Utilisez l'API d'application IBM® QRadar® on Cloud Self Serve pour effectuer par programmation des tâches d'administration liées à la mise à disposition et à la configuration de votre instance QRadar on Cloud .

Pour accéder à la page d'API interactive dans l'API de l'application Self Serve, cliquez sur ? > API Doc.

Vous pouvez utiliser la page de l'API Swagger pour envoyer des demandes. Vous pouvez également envoyer des demandes en dehors de la page d'API.

Envoi de demandes à l'aide de la page de l'API Swagger

Important: avant de pouvoir envoyer des demandes POST, PUT, or DELETE , vous devez d'abord envoyer une demande GET /security_api/get_csrf_token pour obtenir un jeton d'autorisation valide.
Pour obtenir un jeton CSRF et envoyer des demandes POST/PUT/DELETE , procédez comme suit:
  1. Sur la page d'API interactive, dans le noeud final GET /security_api/get_csrf_token , cliquez sur GET.
  2. Cliquez sur Try it out, puis sur Execute.
  3. Copiez la valeur du jeton, puis cliquez sur Authorize.
  4. Collez le jeton dans la zone Valeur et cliquez sur Autoriser.

Envoi de demandes en dehors de la page d'API

Pour envoyer une demande d'API GET/POST/PUT/DELETE aux noeuds finaux d'application en dehors de la page d'API interactive, vous devez transmettre un jeton de service autorisé dans un en-tête de demande. Utilisez l'application QRadar on Cloud Self Serve pour créer un jeton de service autorisé.

Exemple :

Calling API endpoints using external services:
Requests to these endpoints from external sources should have Authorized Service Token passed to request header e.g.

 curl -X POST \ 
 'https://< console_hostname >/console/plugins/< app_id >/app_proxy/authorizedservices_api/authorized_services?label=test1&user_role_id=3&security_profile_id=1' \ 
 -H 'SEC: < *Auth Service Token with Security Administrator user role* > ' \ 
 -H 'accept: application/json'

Réponse attendue :

{"security_profile_id": 1, "last_used_date": null, "created_by": "QRoC Self Serve", "tenant_id": null, "label": "test1", "id": 26, "user_role_id": 3, "creation_date": 1673373549079, "expiration_date": null, "token": "2b5547bb-f2e1-4aad......"}