A credential stores logon information (such as username and password) and is often used in combination with connections. By assigning a single credential to multiple connections, you can simplify your credential management and make password changes quick and easy. Credentials also allows you to safely and securely share a connection file without sharing any credentials and using personal credentials (see below under Working with Personal Credentials and a Shared Document).
See also: Credential, About shared documents
Create a Credential
- In the Navigation panel, select a folder.
- On the HOME tab, in the Edit group, click on Add.
- Click on Credential in the drop down menu.
- Type a name in the Display Name box.
- Provide a Username and Password for the credential.
|
You can create credentials in any documents, including the Application document. It's strongly recommended to encrypt and password protect your document as soon as you create a credential with a password in it.
|
- To add the credential and exit the dialog, click OK.
|
You can optionally configure a Private Key File and Passphrase. Connection types (such as Terminal Connection using the SSH protocol) will support these settings.
If you want to use a credential in one of our browser plugins, you may also provide an URL to the login form and specify Auto Fill mappings.
|
Assign a Credential to a Connection
- In the Navigation panel, select a connection.
- On the HOME tab, in the Edit group, click on Properties.
- In the connection properties dialog, click Credentials.
- In the Credentials property page, click to open the drop down box.
- Select Use an existing credential from the drop down box.
- From the Credential drop down list, select the credential you want to assign to this connection.
|
Use the Add button to create a credential and use the Edit button to open or change the properties of the selected credential.
|
- To apply the changes and exit the dialog, click OK.
Working with Personal Credentials and a Shared Document
The following example describes how to securely create a shared document for a team in combination with personal credentials.
- Create a shared document for the team: on the HOME tab, in the File group, click on New (CTRL+N).
- In the Display Name box, type "Shared Connections" (or any other suitable name).
- To exit the dialog, click OK.
- Create one or more connections: in the Navigation panel, select a folder.
- On the HOME tab, in the Edit group, click on Add.
- Click on Remote Desktop in the drop down menu.
- Setup and configure the connection settings as you need to.
- In the connection properties dialog, click Credentials.
- In the Credentials property page, click to open the drop down box.
- Select Specify a credential name from the drop down box.
- Type a credential name of your choice you agreed on with the team. For example: "Server Admin Account".
- Click OK to add the connection to the shared document.
Repeat steps 4 - 12 to add more connections and always use the same credential name.
- On the HOME tab, in the File group, click on Save (CTRL+S). Save the document to share to a central location where all the team members have at least read access (for example a file share).
- Create a personal document: on the HOME tab, in the File group, click on New (CTRL+N)
- In the Display Name box, type "My Credentials" (or any other suitable name).
|
The following steps 16 - 18 are optional but strongly recommended.
|
- Click on Security.
- Click on Enable Encryption.
- Type a strong password or pass phrase in the Password box. Confirm your password in the Confirm box.
- To exit the dialog, click OK.
- Create your personal credential: In the Navigation panel, select a folder within your personal document.
- On the HOME tab, in the Edit group, click on Add.
- Click on Credential in the drop down menu.
- Type "Server Admin Account" in the Display Name box.
|
The Display Name of this credential must exactly be the same name as the credential name that was specified in the connection configuration (step 9).
|
- Provide the Username and Password for the credential.
- To add the credential and exit the dialog, click OK.
- On the HOME tab, in the File group click on Save (CTRL+S). Save the document in one of your personal directories.
Each team member just needs to do steps 14 - 26 and create their own personal document containing a credential with the exact same name as defined in step 11. When both documents (the shared and the personal document) are opened, Royal TS will "resolve" the right credential whenever a connection is established.
|
If a credential is not found or multiple credentials with the same name were found, Royal TS will prompt for a credential.
|