Logins and passwords
Get started
The following sections do not apply, if you have Single Sign On (SSO) enabled. If you have opted for SSO and it has been enabled, see Single Sign on.
After you have been invited to use Retain Cloud, you will receive an email invite:
- Click Join Retain Cloud. A welcome screen is displayed
- Click Get started. The screen to set a password is displayed
- Read the tips and enter a new password. The password must have at least 12 characters, and at least one symbol or one number
- The checkmark icon will turn green only when you choose a password that follows the rules mentioned above
- The Continue button is enabled only when you choose a password that follows the rules mentioned above
- Click Continue
- The password is saved.
- Click the appropriate button to go to your profile, plans or dashboard
Note
If you leave the page or close the tab before setting up a new password, click the Join Retain Cloud link that you received on your email again and follow the above process.
Login
Note
You will only get 5 attempts to log in after which your account will be disabled for 10 minutes. You may either retry after 10 minutes or reset your password.
- Enter your email and password
- Click Remember me on this computer to save your login details to avoid re-entering them on your next logon
- Click Log in. By logging in, it is assumed that you agree to the terms and conditions
- Depending on your permissions, the next screen in your application is displayed on successfully logging in
Reset password
- Click Forgot your password? on the login screen
- Enter your email associated with this account on the next screen
- Click Send reset password link. A link will be sent to you via email
- Click on the link that has been sent via email
- Think of a new password. Minimum 12 characters. Use the tips that are displayed
- Enter the password twice to confirm
- Click Reset password
Get help
- Select the Help icon from the navigation menu on the left
- The Help documents are displayed
Single Sign On
Overview
Single sign-on (SSO) is an authentication method that allows you to sign in to multiple independent software systems using only one set of credentials. With SSO, you can access all needed applications without being required to authenticate using different credentials. There is no need to sign in every time. You only sign in once. Retain Cloud application supports Azure Active Directory (AAD) accounts which can be used through the Microsoft Identity Platform.
Pre-requisites
- A Microsoft Azure account with an active subscription
- All the users under your tenant in Retain Cloud will need an account in Azure Active Directory with exactly the same email address. The email address is used as a user name for logging in to Retain Cloud.
- One of the following roles: Global Administrator, Cloud Application Administrator or Application Administrator (only for the setup of My Applications Portal)
Access Retain Cloud
You have two options to access Retain Cloud:
Direct access with a link
- The link should be in the format: https://app.retaincloud.com/my_company where my_company is your tenant name in Retain Cloud
- When the link is accessed for the first time, you are asked to grant permissions to the application. Note: You may need to grant permission for the whole organisation
-
If you are unable to progress past this point please contact your Azure Administrator for advice. You may also wish to contact Support Portal or your implementation consultant should you need to seek further advice.
-
Retain Cloud needs only the minimum amount of user information - only the user profile read access is required
- Click Accept
You can now access Retain Cloud.
Note
The grant access process may be different, depending on the security policies in your organization.
My Application Portal
This requires a configuration in Azure Portal which requires one of the following roles: Global Administrator, Cloud Application Administrator or Application Administrator.
To set up the 'My Applications Portal:
-
Go to Enterprise applications and choose New application
-
Click Create your own application
-
Enter an appropriate name and choose Integrate any other application... and click Create. The app registration is created and it is ready to be configured
-
Select Single sign-on from the left pane and click the Linked SSO method
-
Enter the Retain Cloud URL and click Save
-
Select the User and groups and click Add user/group
- Select user(s) or group(s) that need access
-
Enable the Visible to users switch in the Properties tab
-
Retain Cloud application is now configured and will be shown in My Applications Portal
After the application is configured, it will take a couple of minutes to be shown in the user portal.
After you have enabled SSO, you will be able to access Retain Cloud via the SSO module in your company SSO provider website by clicking on the Retain Cloud box. If you have an active Retain user account then you will be taken directly to the Plan page.
You can also visit our Support Portal and raise a case to request Single Sign on (SSO).
Log out
- Select Log out from the navigation menu on the left
- You will be logged out
Logging out completely from the SSO provider website will sign you out of all your company apps