Self-Service-App-API

Verwenden Sie die IBM® QRadar® on Cloud Self Serve-App-API, um Verwaltungstasks, die sich auf die Bereitstellung und Konfiguration Ihrer QRadar on Cloud -Instanz beziehen, programmgesteuert auszuführen.

Um auf die interaktive API-Seite in der API der Self-Serve-App zuzugreifen, klicken Sie auf ? > API Doc.

Sie können die Swagger-API-Seite verwenden, um Anforderungen zu senden. Sie können Anforderungen auch außerhalb der API-Seite senden.

Anforderungen über die Swagger-API-Seite senden

Wichtig: Bevor Sie POST, PUT, or DELETE -Anforderungen senden können, müssen Sie zuerst eine GET-Anforderung /security_api/get_csrf_token senden, um ein gültiges Berechtigungstoken abzurufen.
Gehen Sie wie folgt vor, um ein CSRF-Token abzurufen und POST/PUT/DELETE -Anforderungen zu senden:
  1. Klicken Sie auf der interaktiven API-Seite auf dem Endpunkt GET /security_api/get_csrf_token auf GET.
  2. Klicken Sie auf Ausprobierenund anschließend auf Ausführen.
  3. Kopieren Sie den Tokenwert und klicken Sie anschließend auf Berechtigen.
  4. Fügen Sie das Token in das Feld Wert ein und klicken Sie auf Berechtigen.

Anforderungen außerhalb der API-Seite senden

Zum Senden einer API- GET/POST/PUT/DELETE -Anforderung an die App-Endpunkte außerhalb der interaktiven API-Seite müssen Sie ein autorisiertes Service-Token in einem Anforderungsheader übergeben. Verwenden Sie die App " QRadar on Cloud Self Serve", um ein Token für einen autorisierten Service zu erstellen.

Beispiel:

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'

Erwartete Antwort:

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