A token is used to allow DFA to access Docbox printers. Tokens are created in the Docbox Dashboard and then added to DFA. DFA will then be able to use all the printers that the Docbox user who created the token has access to. Navigate to Control Panel > Tokens to view and manage tokens.
All tokens that have been added are listed, showing the following information.
| Column | Description |
|---|---|
| Name | The name given to the token when it was added to DFA. |
| Docbox URL | The URL of the Docbox installation the token connects to. |
| Created | The date and time the token was added to DFA. |
| Last Updated | The date and time the token was last modified. |
The token gives DFA access to every printer the account that created it can use. Rather than generating the token against an individual user's account, we recommend creating a dedicated service account in Docbox for this purpose. That way, DFA's access doesn't depend on one person's account remaining active, and printer access can be managed independently of any individual's role changes or departure.
Adding a Token
Adding a token is a two-stage process. First, you create the token in the Docbox Dashboard, then you add it to DFA. The token value is only displayed once in the Docbox Dashboard. You must copy it before navigating away, as it cannot be retrieved afterwards.
Step 1: Create the token in the Docbox Dashboard
- Log in to the Docbox Dashboard and navigate to My Docbox > User Tokens.
- Click Add New User Token.
- Enter a Token Name and select FileAgent from the Client dropdown.
- Click Generate Token.
- The token value is displayed on screen. A warning is shown confirming that the token will not be visible again once you leave this screen.
- Click Copy Token to copy the token value to your clipboard. You will need this in Step 2.
Step 2: Add the token to DFA
- In DFA, navigate to Control Panel > Tokens.
- Click New Token. This opens the Token Details panel.
- Complete the following fields.
| Field | Description |
|---|---|
| Name | A label to identify this token in DFA. |
| Docbox URL | The URL of your Docbox installation. This is usually https://{your-docbox-domain}/api/v1. |
| Token | Paste the token value copied from the Docbox Dashboard. |
- Click Save.
Viewing Token Details
Selecting a token from the list opens the Token Details panel, which shows the following information.
| Field | Description |
|---|---|
| Name | The name given to the token. |
| Docbox URL | The URL of the Docbox installation the token connects to. |
| Printers | The Docbox printers accessible to the Docbox user who created this token. These are the printers available when creating a Docbox destination - see Destination Details. |
| Created | The date and time the token was added to DFA, and by which user. |
| Last Updated | The date and time the token was last modified, and by which user. |
| Token | Displays the Replace Token... button to update the token value. |
Replacing a Token
If a token needs to be rotated (for example, if it's expired or you want to issue a new one for security reasons), you don't need to recreate every destination that uses it. From the Token Details panel, click Replace Token... and paste in the new token value. All destinations already using that token will continue to work with the new value automatically.
First generate a new token in the Docbox Dashboard following Step 1 above, then:
- Navigate to Control Panel > Tokens and select the token to be updated.
- Click Replace Token in the Token Details panel.
- Paste the new token value into the Token field.
- Click Save Replacement.
Deleting a Token
To delete a token, select it from the list and click Delete in the Token Details panel.
Token Revocation
DFA tokens can also be revoked directly from the Docbox Dashboard by a Docbox administrator, without requiring access to DFA. Refer to Users for further information.