> For the complete documentation index, see [llms.txt](https://docs.silverband.com.au/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silverband.com.au/home/paradigm-knowledge-base/providers-and-contacts/workflows/contacts/contacts-login-options-randomised-or-token-based-password.md).

# Contacts Login Options: Randomised or Token-Based Password

## Overview

When adding new contacts in Paradigm, you can now choose to set their login options as either Randomised or Token-Based Password. This avoids the need to manually set passwords for each new contact record. If you have configured your system to use either of these two options, Paradigm will automatically send an email to the new contact with their login credentials.

## Prerequisites

For the selected login option to work, please refer to the following requirements:

* [Send a ticket request](https://silverband.atlassian.net/servicedesk/customer/user/login?destination=portals) for the configuration of the preferred login option
* The data resource template of the preferred login option has been customised accordingly, *see* [Edit and Email Template](/home/paradigm-knowledge-base/sending-communications/workflows/manage-email-templates/edit-an-email-template.md) 

  * Data Resource Template: `STAFF_PWD_RESET_RAND` - edit if you opted for the Randomised Password option for contacts
  * Data Resource Template: `STAFF_PWD_RESET_TKN` - edit if you opted for the Token-Based Password option for contacts
  * Edit Label: `reset_user_login_password_emailHtmlHeader` - edit if you are using the system's default email header
  * Edit Label: `reset_user_login_password_emailHtmlFooter` - edit if you are using the system's default email footer

  <figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2Fmixf8aX3NYBdb1V3bkyW%2Fimage.png?alt=media&amp;token=6070a4a1-2fd8-4426-8d0c-87c70b6998b9" alt=""><figcaption><p>Data Resource Templates to edit </p></figcaption></figure>

## Workflow

1. [Create a new contact record](/home/paradigm-knowledge-base/providers-and-contacts/workflows/contacts/create-a-contact-record.md), making sure that the email address is entered correctly. The following fields are required for the system to auto-create a login credential:
   * Given Name
   * Last Name
   * Email
   * DOB
   * Home Institution
   * Status

Note that the Security Group every time a contact record is created is set to STAFF by default.

On saving the record, Paradigm sends the email depending on which preferred method is configured. Refer to the sample email below for each login option.

## Randomised Password

<figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2FsOg99YZOhQJsJBRh26Xs%2Fimage.png?alt=media&amp;token=a8d33818-9239-47e7-98cb-9dc617dd39df" alt=""><figcaption><p>sample email received when the <strong>Random</strong> login option is set</p></figcaption></figure>

2. After the contact has login successfully, they can edit their password via the **Login** menu.

<figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2FvVgJMPfNMLeiA6HcB9NA%2Fimage.png?alt=media&amp;token=1ce2c6a9-636b-46ff-8f21-25ad26c15d34" alt=""><figcaption><p><strong>Login</strong> menu to change their password once logged in</p></figcaption></figure>

## Token-Based Password

<figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2FUl4trBehvM7rUeHjGSuR%2Fimage.png?alt=media&amp;token=e15a14e5-360e-417b-9b6c-dc8ae9cc1cb4" alt=""><figcaption><p>sample email received when the <strong>Token</strong> login option is set</p></figcaption></figure>

3. After the contact has clicked the link, they can set their password accordingly.

<figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2FZ1FfEJGC8F3FiQ0D9ylE%2Fimage.png?alt=media&amp;token=2831c491-7a03-4f0a-acb5-8589d86cd112" alt=""><figcaption><p>page link where the new contact can set their password</p></figcaption></figure>