Skip to main content

API Request Basics

Use the following guidelines to ensure that your Application Security API requests to Prisma Cloud are successful.

For more information and for directions to enable Application Security on Prisma Cloud, see Prisma Cloud Administrator’s Guide—Application Security. If you are upgraded to Darwin, see Prisma Cloud Application Security.

Prerequisites for a Application Security Request

To make a Application Security API request, you must have the right privileges and authorization for the request.

Application Security Access

To have the right privileges to make a Application Security API request, you must set up Administrator and Developer access. For more information, see - Manage Roles and Permissions. If you are upgraded to Darwin, see Administrator access.

Application Security API Authorization

To have the right authorization for a Application Security API request, follow the high-level steps below:

  1. Create and Manage Access Keys. If you are upgraded to Darwin, see Create and Manage Access Keys.
  2. Make a Cloud Security API request to log in . A successful request returns a JSON Web Token (JWT).

All the Application Security API requests use this JWT in the API request header for authorization. Note that for security, a JWT is valid for only ten minutes. If your session must be active beyond that limit, you can extend a session.

See Getting Started for detailed steps to obtain an access key and to log in to obtain a JWT token.

Components of a Application Security Request

The sections below note specific details about some of the components of a successful Cloud Security API request.

Base URL

The base URL of your Application Security API request depends on the region of your Prisma Cloud tenant and is similar to your Prisma Cloud administrative console URL. See the Prisma Cloud URLs for a list of Prisma Cloud console URLs and corresponding API base URLs.

HTTP Methods

The Application Security API uses standard HTTP methods, such as GET, POST, PUT, and DELETE.

Required Request Headers

See Headers for information about required request headers.