Prisma-Cloud-REST-Nachrichten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 1 Minute Lesedauer
  • Prisma-REST-Nachrichten werden verwendet, um Aufrufe an die Prisma-Anwendungsprogrammierschnittstelle (API) zu tätigen und die Compliance-Daten abzurufen.

    Die folgenden REST-Nachrichten sind im Lieferumfang des Basissystems enthalten.

    Prisma-Cloud-Integrationen

    Alle Prisma-Cloud-Integrationen verwenden das JSON Web Token (JWT) zur Authentifizierung und Autorisierung.

    Tabelle : 1. REST-Nachricht für Prisma-Anmeldung
    Endpunkt Beschreibung Methode Textkörper Link zur API-Dokumentation
    /login

    Ruft das JWT-Token zur Verwendung in allen nachfolgenden Integrationen ab.

    POST
    { "username": <<access key id >>, 
    "password": <<secret access key>>}
    https://pan.dev/prisma-cloud/api/cspm/app-login/
    Tabelle : 2. REST-Nachricht „Prisma Refresh Token“.
    Endpunkt Beschreibung Methode Textkörper Link zur API-Dokumentation
    /auth_token/extend Verlängert das JWT-Token bei Ablauf automatisch. Die Standarddauer für den Tokenablauf beträgt 60 Minuten. GET NA https://pan.dev/prisma-cloud/api/cspm/extend-session/
    Tabelle : 3. REST-Nachricht für Prisma-Richtlinie
    Endpunkt Beschreibung Methode Textkörper Link zur API-Dokumentation
    /v2/policy Ruft alle Richtliniendaten aus Prisma ab. GET NA https://pan.dev/prisma-cloud/api/cspm/get-policies/
    Tabelle : 4. REST-Nachricht der Prisma-Warnung
    Endpunkt Beschreibung Methode Textkörper Link zur API-Dokumentation
    /v2/alert Ruft alle Warnungen von Prisma ab. POST
    {
        "detailed": "false",
        "filters": [
    	{
    
    		"name": "timeRange.type",
                    "operator": "=",
                    "value": "ALERT_STATUS_UPDATED"
            }
        ],
        "sortBy": [
            "resource.id"
        ],
        "pageToken": "",
        "offset": 0,
        "limit": 2000,
        "timeRange": {
            "type": "absolute",
            "value": {
                "startTime": <<Import since at integration level>>,
                "endTime": << Current integration  run time>>
            }
        }
    }
    https://pan.dev/prisma-cloud/api/cspm/post-alerts/

    Für die Integration von Prisma Comprehension Alert müssen die Filter im obigen POST-Text wie folgt ersetzt werden:

    "filters": [
    	{
                        "name": "alert.status",
                        "operator": "=",
                        "value": "open"
                    },
                    {
                        "name": "alert.status",
                        "operator": "=",
                        "value": "dismissed"
                    },
                    {
                        "name": "alert.status",
                        "operator": "=",
                        "value": "snoozed"
                    },
                    {
                        "name": "alert.status",
                        "operator": "=",
                        "value": "pending_resolution"
                    },
                    {
                        "name": "timeRange.type",
                        "operator": "=",
                        "value": "ALERT_UPDATED"
                    }
     
        ],