Dotfile

The platform reads the Dotfile workspace members through the DotfileAPI so you can check who has access.

Attention

Use a work space keyCreated by a work space adminA Dotfile API key is a wide workspace and Dotfile documents no domains or permissions on it, so any workspace key can call users the end point. Dotfile hashes and encrypts the key, so copy it when you create it.

Prerequisites

• the platform organization administrator access
• The admin role in the Dotfile workspace (Dotfile requires you to be the workspace administrator to generate keysAPI)

Collected Fields

the platform field	Dotfile field	Notes
Name	first_name and last_name	Return to email address
Email	email
Role	role	owner, admin, member or the name of a custom role
Admin	role	It falls as an administrator when role is owner or admin
Status	suspended_at	Inactive once a suspension timestamp is set
MFA	Not supported
Last login	Not supported
External ID	id	Stable ID used to track your account through reviews
Created at	created_at	When the user was created in the workspace

The platform requires suspended users, as well as those active, so that a suspended member still appears in the campaign, marked inactive.

Step 1: Create an API Key

1. In the Dotfile console, signed in as a workspace admin, go to Workspace settings > API keys.
2. Create a new key and give it a name (e.g. Probo Access Review). Dotfile documents do not have the scope or permission to set a key.
3. Copy the key and store it securely (password manager, secret manager). Dotfile a hash and encrypts it so you can’t read it again.

Step 2: Connect in the platform

1. On the platform, go to Access Reviews > Sources > Add Source.
2. Find Dotfile, click API KeyPut the key and click Connect.

The platform names the source after the Dotfile workspace and attracts its members to your campaigns.

Troubleshooting

• Key rejected. Confirms a workspace administrator generated the key and that it has not been replaced since then. the platform sends it in the header X-DOTFILE-API-KEY so that a key from another workspace will not authenticate.
• No members appear. A keyAPI is a wide workspace, so check if it belongs to the workspace you intend to review.