Skip to content

SCIM card sync

What it does

With directory sync on, the SCIM provisioning that manages your members also manages their cards. A new person gets a card. A change to their title, phone or department updates it. A person who is deprovisioned has their card deactivated, and what the printed code shows then is the offboarding choice you made for the program.

It needs SCIM (see the pricing page) and the plan feature for bulk and directory cards. Google Workspace can provision only into apps in its catalogue, so it depends on Dotwick’s listing there.

Turn it on

  • Set up SCIM for your directory first, under Settings → Security. The base address is /v1/auth/scim/v2 on https://api.dotwick.com.
  • Open Cards → Program and switch on directory sync.
  • Decide whether a member may still edit a field that follows the directory. By default an edit takes that field off the directory; locking synced fields stops members editing them.
  • Assign the Dotwick app, in your directory, to the people who should have a card.

Which attributes are read

Each SCIM attribute fills one field of the card. The enterprise extension’s department and organization are read too.

name.givenNamefirstNameFirst name
name.familyNamelastNameLast name
titletitleJob title
emails[type eq "work"].valueemailsWork email
phoneNumbers[type eq "work"].valuephonesWork phone
phoneNumbers[type eq "mobile"].valuephonesMobile phone
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departmentdepartmentDepartment
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organizationcompanyCompany
addresses[type eq "work"]addressWork address
preferredLanguagelocaleLanguage of the card

When someone leaves

Deprovisioning deactivates the person’s cards; nothing is deleted. The printed QR code keeps working and, as you chose, shows the company card without the person, redirects to a page you name, or says the card is gone. An admin can give a deactivated card to a new person later, and the short link, the QR code and any NFC tags carry on.