Manage directories

On the Admin Portal Directory Sync menu, you can see the Directory connections.

Create Directory Sync connection

1. From your Admin Portal, go to Directory Sync.
2. Click Create New.
3. Enter the following information:
   • Enter Directory name
   • Select the Directory provider from the list of available providers.
   • Add the Tenant
   • Add the Product
   • Enter the Webhook URL
   • Enter the Webhook secret

Update Directory Sync connection

1. From your Admin Portal, go to Directory Sync.
2. From the list of directory sync connections, click edit icon.
3. You can update the following information:
   • Enter Directory name
   • Enter the Webhook URL
   • Enter the Webhook secret
   • Toggle Enable Webhook events logging

View directory users

1. From your Admin Portal, go to Directory Sync.
2. From the list of directory sync connections, click database icon.
3. Click the tab Users.
4. To find one user, enter their full email address and select Find. The address has to match what your identity provider sent. A partial address finds nothing, and a user whose address changed after they were provisioned is found under the address they were created with. Select Clear to list every user again.
5. Click the eye icon to view the user raw JSON data.

View directory groups

1. From your Admin Portal, go to Directory Sync.
2. From the list of directory sync connections, click database icon.
3. Click the tab Groups.
4. To find one group, enter its full name and select Find. The name has to match what your identity provider sent. A partial name finds nothing, and a group renamed after it was created is found under the name it was created with. Select Clear to list every group again.
5. Click the eye icon to view the group raw JSON data.

View webhook events

1. From your Admin Portal, go to Directory Sync.
2. From the list of directory sync connections, click database icon.
3. Click the tab Webhook Events.
4. Each row shows the event types the delivery carried, who or what they applied to, and the response your endpoint returned. A delivery that carried a batch of events shows how many users and groups it touched rather than naming them.
5. Select the Sent at time, or the eye icon, to open the event. The event page lists each event in the delivery with its subject, and shows the payload your endpoint received, with a button to copy it.

Click the button Clear Events to delete all events from the database.

Enable webhook events logging

1. From your Admin Portal, go to Directory Sync.
2. From the list of directory sync connections, click edit icon.
3. You can enable or disable the Enable Webhook events logging.

By default, the webhook events are not logged.

Logged webhook events are retained for 7 days by default. Use the DSYNC_WEBHOOK_LOGS_TTL environment variable to change the retention period or to keep events indefinitely.