---
title: "E-Signatures"
canonical: "https://support.appfire.com/space/CDML/649661179/E-Signatures"
format: markdown
---
> Macro (aura-html)


> Macro (excerpt)
> 
> Require users to authenticate their identity to activate and undertake an approval including the option to require use of an authentication token generated through a third-party authentication app

## Overview

The e-signature feature allows workflow authors to require that users authenticate their identity to activate and undertake an approval.

> ℹ️ Each approval must be configured to require user authentication.

The workflow popup contains a [credentials prompt](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595003) for the user.

![image](media://f5fd09cf-d87b-49a2-9dad-66a5e5edc1b6)

Global administrators can set the authentication process to be based on either the Confluence username and password or a signing token generated by a third-party authentication app.

Workflow authors can configure each approval to require user credentials.

## Global configuration of credentials required for a reviewer

E-signature credentials required for approvals in the workflow can be configured globally to use either

- the user's Confluence username and password
- the user's Confluence username and a signing token generated by a third-party app

This is configured in the global **[Comala Document Management E-Signatures Configuration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347320)**[ screen](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347320).

![image](media://625b2031-c5db-4eb9-930e-75f7b600c754)

> 📝 User authentication is only requested for an approval configured to require reviewer credentials.

<span style="color: #172b4d">If </span><span style="color: #172b4d">**Signing Token**</span><span style="color: #172b4d"> is selected</span>

- each user must set up their account for the instance with an authentication app
- users with active signing token accounts are listed in the [Comala Document Management E-Signature Configuration screen](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347320)

![image](media://1ba2728b-67d0-4b87-bd5c-b690480c970e)

## Editing an approval to require credentials for a reviewer

Each approval can be edited using [workflow builder](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650248771) to set the requirement for the submission of credentials by a reviewer to activate and undertake the approval.

![image](media://0a498036-7950-480d-beb8-440a0d62bcdf)

The approval can be configured to require the credentials submitted in the workflow popup as one of the following

- no user authentication
- password authentication
- username and password authentication

If the global configuration for e-signature is set to require the user's Confluence username and password the credentials prompt in the workflow popup will be either

- the user's Confluence username ***and***** **the user's Confluence password
- the user's Confluence password

If the global configuration for e-signature is set to require the use of a signing token the credentials prompt in the workflow popup is either

- the user's Confluence username and the signing token
- the signing token

> ℹ️ If a signing token is required, [a user needs to undertake a one-time set up an authentication app](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760336) before undertaking an approval. The [authentication app](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649693211) is then used to generate a time-based signing token required for each approval.

## Related Links

**[User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144)**

- [E-Signature](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649757622)
- [Workflow popup credentials prompt](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595003)
- [Reviewer authentication](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890845)
- [Authentication apps](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649693211)
- [Using an approval signing token to undertake a review](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889506)

**[Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901)**

- [Set up a reviewer signing token](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760336)

**[Confluence Administration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650150846)**

- [E-Signatures configuration - global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347320)