Skip to main content

Login​

Returns a JWT auth token for accessing the Prisma Cloud APIs. To generate a token, you must have an access key and include the following values in the request body parameter — access key ID as the username and your secret key as the password. Prisma Cloud requires this JWT in the request header to authorize API access. Note that access keys maintain the same level of permissions as the permission group of the account that created them.

If you are a multi-tenant user and the body parameters of your login request include a user name and password instead of an access key ID and secret key. You will also need to provide the prismaId or the customerName. Specifying just the prismaId is preferred, but specifying customerName is an acceptable alternative. Your prismaId is available from the license information in the Prisma Cloud console. It's unnecessary to specify both prismaId and customerName, but if you do specify both, the parameters must indicate the same tenant.

Note that you should specify not only the URL and required headers, but also the request body or payload in any POST /login request. See Use Curl to Generate JWT Tokens in Prisma Cloud for a detailed example.

Request Body required

Model used for authentication

    customerName string

    Customer Name

    password string required

    Secret key

    prismaId string

    Unique Prisma Identifier

    username string required

    Access key ID

Responses

successful operation

Schema
    customerNames object[]

    Customer names and property list

  • Array [
  • ]
    • message string

    Authentication status

    roles string[]

    List of user permissions based on user role type. This attribute is populated only for the refresh token response.

    token string

    JSON Web Token (JWT)

Loading...