Prisma Cloud REST Messages

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture
  • Les messages REST Prisma sont utilisés pour passer des appels à l’interface de programmation d’application (API) Prisma afin d’extraire les données de conformité.

    Les messages REST suivants sont fournis avec le système de base.

    Intégrations dans le cloud Prisma

    Toutes les intégrations Prisma Cloud utilisent le jeton Web JSON (JWT) pour l’authentification et l’autorisation.

    Tableau 1. Message REST de connexion Prisma
    Point de terminaison Description Méthode Corps Lien vers la documentation de l’API
    /connectez-vous

    Obtient le jeton JWT pour une utilisation dans toutes les intégrations ultérieures.

    POST
    { "username": <<access key id >>, 
    "password": <<secret access key>>}
    https://pan.dev/prisma-cloud/api/cspm/app-login/
    Tableau 2. Jeton d’actualisation Prisma Message REST
    Point de terminaison Description Méthode Corps Lien vers la documentation de l’API
    /auth_token/extend Renouvelle automatiquement le jeton JWT à son expiration. La durée par défaut de l’expiration du jeton est de 60 minutes. GET N/A https://pan.dev/prisma-cloud/api/cspm/extend-session/
    Tableau 3. Politique Prisma Message REST
    Point de terminaison Description Méthode Corps Lien vers la documentation de l’API
    /v2/politique Récupère toutes les données de police de Prisma. GET N/A https://pan.dev/prisma-cloud/api/cspm/get-policies/
    Tableau 4. Message REST d’alerte Prisma
    Point de terminaison Description Méthode Corps Lien vers la documentation de l’API
    /v2/alerte Récupère toutes les alertes de Prisma. 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/

    Pour l’intégration de l’alerte de compréhension Prisma, les filtres de l’auto-test de démarrage (POST) ci-dessus doivent être remplacés comme suit :

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