Directory sync lets your company's sign-in system manage the workspace's people for you. When your IT team gives someone access to Bluedeer, they join the workspace. When IT deactivates or removes them, they lose access to the workspace straight away.
Directory sync is part of Bluedeer Enterprise. On the Team plan it shows locked, with an Enterprise badge, and owners and admins can select Contact sales from there.
Only the workspace owner can set it up and change it, on the web. Admins see its settings and the provisioning log read-only; each control they can't use says "Only the workspace owner can change directory sync." To find it, open the Workspace page, select Settings, choose the Security tab, and find Directory sync below Single sign-on. On the phone, owners and admins see a Directory sync row under Enterprise on the General tab of Manage workspace. It is locked with the Enterprise badge when the plan doesn't include it, and it says that it is set up and managed on the web. The settings themselves are changed on the web only. People your sign-in system adds use the phone like any other member.
Before you start
Directory sync needs single sign-on first:
- your company's sign-in system is set up with Bluedeer and switched on, and
- at least one domain, verified by its DNS record, signs in with it.
Your sign-in system can only add people whose email address is on one of those domains. Someone on any other domain is refused, and the provisioning log says why. An Apple Hide My Email address (a private relay address that hides a person's real email) is always refused, because Bluedeer can't send email to it. The provisioning log gives this refusal its own reason and asks for the person's real work address, so ask their IT team to use it. A sign-in system can never add or change people in another Bluedeer workspace.
1. Turn it on
Turn on the Directory sync switch. Bluedeer shows two values, each with a Copy button:
- SCIM base URL: the address your sign-in system sends its changes to.
- Token: the secret your sign-in system sends with every change. Bluedeer shows it only this once, so copy it straight away. Bluedeer keeps only a fingerprint of it, and shows its last four characters.
If the token is lost or might have leaked, select Make a new token. The old one stops working at once, so paste the new one into your sign-in system straight away.
2. Give the values to your IT team
Your IT team adds Bluedeer to your sign-in system and sets up automatic provisioning with these two values:
- Paste the SCIM base URL and the Token into the provisioning settings of the Bluedeer app.
- Turn on creating, updating and deactivating people.
- Assign the people or groups who should have access to Bluedeer.
- Map the groups you want to use (see Groups below).
- Run the connection test if your sign-in system has one, then turn provisioning on.
Some sign-in systems don't offer automatic provisioning for apps that are added by hand. In that case, people join the workspace the first time they sign in with single sign-on. Some systems send their changes in batches, so a change can take a short while to arrive.
What happens to people
- Added: someone without a Bluedeer account gets one. It has no password: they sign in with your company's single sign-on. Someone who already has an account with that address keeps it, with everything in it. Either way, Bluedeer emails them to say which workspace they were added to, how to sign in with single sign-on using their work email, and whether they have a seat yet. The same happens when your sign-in system adds someone back after a removal. Changes to someone already in the workspace send no email, and neither does anything that concerns the owner.
- Seats: being added doesn't give anyone a seat. Without one they can only read, and the owner and admins see in their Inbox that they need one. If you turn on Give new people a free seat, Bluedeer gives them an unused paid seat the workspace already has. Bluedeer never buys a seat for them.
- Changed: when your sign-in system changes someone's name, Bluedeer applies the change, unless they chose their own name in Bluedeer. An email address change is applied for accounts the directory created, when the new address is on one of the workspace's verified domains.
- Deactivated or removed: they are removed from the workspace like any removed member. Their seat is freed, their scheduled tasks pause and their waiting actions are canceled. Their single sign-on sessions for the workspace end. Their Bluedeer account and their artifacts are not deleted. If your sign-in system adds them back, they return to the workspace and find their work as they left it.
- The owner is never added, removed or given a role by directory sync. Transfer ownership first.
Removing someone your sign-in system manages
While directory sync is on, people your sign-in system added can't be removed from the workspace in Bluedeer: removing them here wouldn't last, because the next check of the directory would add them back. The remove button beside them on the Members page and Remove from workspace on their page are off. On the web, hovering over or focusing one shows why; on the phone, the reason is shown under it, for example "Sam Lee is managed by your identity provider. Remove them there, and Bluedeer removes them within 30 minutes." Remove or deactivate them in your sign-in system instead.
- People who joined another way (an invitation, a link or domain capture) can be removed in Bluedeer as usual.
- Someone your sign-in system has already deactivated or removed, but who is still listed while the change arrives, can be removed in Bluedeer too.
- Once directory sync is turned off, or the workspace is no longer on Enterprise, everyone can be removed in Bluedeer again.
- Taking someone's seat away is not affected, and people can still leave the workspace themselves.
The first time someone your sign-in system added signs in with single sign-on, Bluedeer links that sign-in to the account created for them and signs them in.
Groups
Groups your sign-in system sends appear under Groups, with how many people are in each. For each group you can choose:
- Role: Admin or Member. A person in several groups gets the highest role. Owner can't be given by a group. With no group set to a role, directory sync doesn't change anyone's role.
- Seat: the seat tier a person in the group gets when Give new people a free seat is on and such a seat is free.
The provisioning log
Provisioning log lists what your sign-in system sent and what Bluedeer did, newest first: who was added, updated or removed, and who wasn't and why. Use Filters to show one kind. The same changes are in the workspace's Activity.
If Bluedeer can't apply a change right away, it retries automatically. It also checks the whole directory every 30 minutes and corrects anything that was missed. Select Sync now to check straight away.
Turn it off
Turn off the Directory sync switch. Your sign-in system can no longer reach Bluedeer. Nobody is removed from the workspace, and everyone keeps signing in with single sign-on. Turning it on again makes a new base URL and token. Turning directory sync off is always allowed, even on the Team plan.