Unblocked
Connect Unblocked to Ploy to see the users in your Unblocked team, whether each one is active, and which groups they belong to. Ploy can also add users, deactivate and reactivate them, delete them, and add or remove users from groups.
This integration is in beta
The Unblocked integration is in beta. It was built from Unblocked's API documentation and has not yet been checked against a live Unblocked team, 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 Unblocked fails: the error response Unblocked sends back, with personal details, keys 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 Unblocked user provisioned through SCIM, with their name and email address
Whether each user is active or deactivated. Deactivated users show as no longer having access
Every SCIM group, and the users in each group
Ploy does not read your questions, answers, code, documents or data sources. Roles (Admin or Member) and licences are managed only in Unblocked's dashboard, so Ploy does not read or change them.
Before you start
Ploy connects through Unblocked's SCIM provisioning, which needs SAML single sign-on configured for your team. Single sign-on is part of Unblocked's Enterprise plan.
You need to be an admin of the Unblocked team.
Create a SCIM token in Unblocked
Sign in to Unblocked as a team admin.
Open Settings, then Security under Team Settings.
If single sign-on is not set up yet, configure it first under Single Sign-On.
Find SCIM User and Group Provisioning and click Configure.
Click Add Token and copy the token. Unblocked shows it only once, so treat it like a password.
You do not need the Base URL shown in the same window. It is the same for every team, and Ploy already knows it.
Connect Unblocked in Ploy
In Ploy, open Integrations and choose Unblocked.
Tick the beta consent checkbox.
Paste the SCIM token.
Click Test. Ploy reads one Unblocked user to check the token works.
Finish the setup. The first scan starts straight away.
Things to know
Unblocked's provisioning API lists the users provisioned through SCIM. People who joined your team through an invite link, outside single sign-on, may not appear.
Deactivating a user in Ploy removes their access in Unblocked but keeps their account, so you can reactivate them later. Deleting removes the user from Unblocked.
If your identity provider also pushes Unblocked groups, it may undo a group change made in Ploy on its next sync. Make the change in your identity provider instead if it owns the group.
If you replace the SCIM token in Unblocked, update it in the Unblocked connection in Ploy.