Perimeter 81
Connect Perimeter 81 to Ploy to see every member of your Perimeter 81 workspace, their Perimeter 81 role, and whether their access has been terminated. Ploy can also add new members and delete members from a Ploy workflow. Perimeter 81 is now sold by Check Point as Harmony SASE; this integration uses the Perimeter 81 member API.
This integration is in beta
The Perimeter 81 integration is in beta. It was built from Perimeter 81's API documentation and has not yet been checked against a live Perimeter 81 workspace, so some details may need adjusting once customers connect it. Beta does not limit what the integration can do.
The first step of setup is a consent checkbox. Ticking it lets Ploy capture redacted error data when a request to Perimeter 81 fails: the error response Perimeter 81 sends back, with personal details, tokens and other secrets removed. Ploy uses it only to fix problems with this integration. You must tick the box to continue.
What Ploy reads
Every member of your Perimeter 81 workspace, with their name and email address
Each member's Perimeter 81 role
Whether each member's access has been terminated, and whether they have verified their email address
Ploy does not read your groups, networks, applications, gateways or firewall policies yet.
What Ploy can change
Add a member. Ploy creates the member with their name and email address, and Perimeter 81 sends them an invitation. Someone who is already a member is left as they are.
Delete a member. Ploy deletes the member from your workspace. Deleting someone who is already gone counts as done.
Before you start
Perimeter 81's API is included only on the Premium Plus and Enterprise plans. On other plans, the API settings page says your plan does not include API support.
You need a Perimeter 81 API token:
Sign in to the Perimeter 81 management platform as an administrator.
Open Settings, then the API section.
Generate a new token. Give it a name you will recognise, such as Ploy, and an expiration date.
Under Key Permissions, allow it to view the list of users. To let Ploy add and delete members, also allow it to add new members and delete members.
Copy the token. Treat it like a password.
When the token expires, Perimeter 81 stops accepting it and Ploy's scans fail until you generate a new token and update the connection.
Connect Perimeter 81 in Ploy
In Ploy, open Integrations and choose Perimeter 81.
Tick the beta consent checkbox.
Paste the API token.
Click Test. Ploy reads one member from your workspace to check the token works.
Finish the setup. The first scan starts straight away.
Things to know
Members are checked every hour.
A member whose access is terminated in Perimeter 81 loses their access in Ploy at the next scan.
A member deleted from Perimeter 81 loses their access in Ploy once a later scan confirms they are gone.
Perimeter 81's API cannot suspend or reactivate a member, or change their details or role. Make those changes in Perimeter 81.
Troubleshooting
Perimeter 81 refused the token
Check the token was copied in full, has not expired, and has not been deleted in Perimeter 81's API settings.
Perimeter 81 refused to list members
Check the token's Key Permissions include viewing the list of users, and that your plan includes API support.
Adding or deleting a member was refused
Check the token's Key Permissions include adding new members and deleting members.