App Specific Passwords are a feature of Truework that enables special-purpose credentials for specific third party integrations such as Encompass or Empower.
Intended Audience
App Specific Passwords are available to verifier users of the Truework platform.
Supported Applications
These are the currently supported third party applications that App Specific Passwords can be generated for and used with:
- Encompass
- Empower
- Yardi
Throughout the rest of the document, "Third Party Application", or a variation of that, will be used to represent these supported applications.
Benefits of App Specific Passwords
App Specific Passwords offer several advantages to verifiers, including:
- App Specific Passwords can be used in Third Party Applications when your team requires SAML to authenticate to the web dashboard.
- App Specific Passwords can be used in Third Party Applications when you login to the web dashboard via Google/Microsoft.
- App Specific Passwords do not get reset when you reset your user password, ensuring your integration still works even if you change your app.truework.com password.
- App Specific Passwords are limited in scope to only the features that a given Third Party Application requires access to, which helps reduce the risks associated with any potential compromised App Specific Password.
- App Specific Passwords are securely generated random values, ensuring they are difficult for an attacker to guess.
Setting Up An App Specific Password
- To get started setting up an App Specific Password, ensure you are logged into your account and then click the "Account" menu option in the sidebar.
- From your Account settings, you should see a section called "Account" in the body of the page
- Within the "Account" section, there is an option to Edit your App Specific Passwords. Click "Edit" to reveal the App Specific Passwords menu.
- If you have any App Specific Passwords already, they will show up here. If you do not, you can select one from the "Generate New App-Specific Password" dropdown menu. Simply select the integration you would like to generate the password for and click "Generate." Note: The password will only be valid for the application you select at this stage.
- Your App Specific Passwords should now update to include a table that looks similar to the one shown below. Each password is associated with a specific application, and you can either reveal the whole password by clicking the eye icon, or you can click the clipboard icon to automatically put the password on your clipboard. It's recommended to use the clipboard icon to ensure that you get the exact password on your clipboard.
- In the application you've selected, such as Encompass in this example, you may need to coordinate with your Third Party Application administrator to update your Truework credentials if you've previously used Truework in that platform. When prompted for your Truework username and password, simply supply your email address and your App Specific Password.