Prisma Cloud
Connect Prisma Cloud to Ploy to see every user and service account in your Prisma Cloud tenant, the user roles each one holds, and when they last signed in. Ploy can also add users, disable and re-enable them, change their roles and remove them.
This integration is in beta. It was built from Prisma Cloud's API documentation and has not yet been run against a live Prisma Cloud tenant. Everything works the same way as any other integration, but expect us to refine it as the first customers connect.
Before you start
You need:
A Prisma Cloud user who can create access keys, ideally a System Admin.
The API host of the cluster your tenant is hosted on. It matches the address you sign in at: if you sign in at app2.eu.prismacloud.io, your API host is api2.eu.prismacloud.io. It is also in the welcome email Prisma Cloud sent when your tenant was created.
Step 1: Create a service account and access key in Prisma Cloud
In Prisma Cloud, open Settings, then Access Control.
Create a service account for Ploy (recommended), or use an existing user.
Give it a role:
To scan users and roles only, a role that can view users and user roles is enough.
To add, disable, remove people and change their roles from Ploy, give it a System Admin role.
Create an access key for the service account. Copy the access key ID and the secret key. The secret key is shown only once.
If you set the key to expire, note the date: Ploy stops scanning when the key expires.
Step 2: Connect Prisma Cloud in Ploy
In Ploy, open Integrations and choose Prisma Cloud.
Tick the beta acknowledgement box. Because the integration is in beta, Ploy asks your permission to capture technical error details from this connection when a call to Prisma Cloud fails. That includes Prisma Cloud's error responses with personal information removed. Ploy uses them only to debug and improve the integration, and nothing is shared outside Ploy.
Select your Prisma Cloud API host from the list.
Paste the access key ID and the secret key.
Select Test connection. Ploy signs in with the key and reads your users. If the test fails, the message says what to check.
Ploy exchanges the access key for a short-lived session each time it scans. It never stores a password.
What Ploy shows
Users and service accounts: every user in the tenant, keyed on their email address, and every service account, keyed on its username.
Access: each person's access to Prisma Cloud, with one entry per user role they hold.
Disabled users: shown as blocked, and their access is removed in Ploy straight away.
Last sign-in: when each user last signed in.
Ploy scans every six hours.
What Ploy can change
Create user: adds an interactive user with a first name, last name and a role. Set the Role option in the flow to the role's name or ID. The time zone defaults to UTC.
Disable and enable: disables or re-enables a user or service account without deleting it.
Remove user: deletes the user or service account. Removing someone who is already gone counts as done.
Change roles: gives or removes one user role at a time from Ploy, or moves a user to a single role. A user must keep at least one role, so the last one cannot be removed.
Roles of service accounts, and service accounts themselves, are created and changed in Prisma Cloud.
Not covered yet
Permission groups, account groups, access keys and cloud identity permissions are not scanned.