×

Phase Locked Software logoDocument Control Howto

Document Control Logo Document Control Howto

Revision: 2024-01-04

How to sign a document

Signing a document

Signing a page

From the page menu, click "Add Signature" or click the "Add Signature" button (if enabled by your Confluence administrator):

Opening the Add Signature dialog.

Fill out the form and click Submit to sign the page.

If the Authentication setting is enabled, the user is required to authenticate with Document Control with one of the following methods:

If multiple methods are enabled, the user must choose an authentication method.

Choose an authentication method.

Signature Authentication Information

Personal token: When using a personal token, a user needs to set a secret token and validate the token through a validation code received by email. The validation code is only valid for a short time. The token can be revoked on demand. If the secure token does not match, it will be revoked after several failures.

Signing a page with personal token.

The email for the validation code must be the email address used for Confluence login. You can find your login email at your Atlassian profile page. The personal token can be reset by going to the Document Control General page and clicking on the setup button.

2FA: For 2FA authentication, a user needs to install and pair an authenticator app. Compatible apps are:

When using 2FA authentication for the first time, a user needs to pair their authenticator app with Document Control.

Pair authenticator app with Document Control.

The 2FA codes are unique to each user, and can be revoked on demand using a user-specific API token. When signing, the signature dialog ask you to enter a 6 digit code called 2FA token. This token is generated by your authenticator app. The token is refreshed regularly. If the token does not match, an error message is shown to indicate a problem:

Signing a page with 2FA.

API key: When using API key authentication, a user needs to generate a secure token once by using the Atlassian provided secure token management page at the Atlassian API token page. The token is unique to each user, and can be revoked on demand. If the email and the secure token do not match, an error message is shown under the email and token fields to indicate a problem:

Signing a page with API key.

The email for the signature must be the email address used for Confluence login. You can find your login email at your Atlassian profile page.

How to add a reviewer

Add a reviewer

Assigning reviewers

There are two ways to add reviewers to a page:

1. Click the Document Control byline on the page (the link under the page title)
2. From the page menu (the three-dot icon with links to Move, Copy, Delete, etc.), click "Manage Reviewers".

Once the "Manage Reviewers" dialog is open, you can add a reviewer to a page by searching by name.

Adding a reviewer.Adding a reviewer.

You can also use this dialog to remove a reviewer by clicking the small "x" next to each reviewer's name.

If you have the Email notification setting enabled, the new reviewer will receive an email inviting them to review the page:

Email notification for new reviewer.

The page's document control status will change to Needs Review until all reviewers have added a signature to the page.

Document Control Status

All pages set up for document control will have one of three statuses:

  1. Not reviewed - No reviewers have been added to this page.
  2. Needs review - One or more reviewers have been added to this page, but not all reviewers have signed the most recent version of the page.
  3. Reviewed - All reviewers have signed the most recent version of the page.

The document control status is reflected in the byline (the link under the page title) of each page. It's also reflected in the Document Control macro. For example, in the following screenshot, Jason Wright and Lucille Bluth have been assigned as reviewers, but only Lucille Bluth has signed:

Page that needs review.

Once Jason Wright signs the page, the page looks like this:

Page that has been fully reviewed.

If the page is edited, all reviewers will need to sign the page again to maintain the "Reviewed" status; see Page versioning for more details.

Complete Documentation

The complete documentation for Document Control is available at Complete Documentation

Document Control Logo Document Control for Confluence Cloud

Sitemap

Contact

© 2024  Phase Locked Software