Getting started with Joining Tehama
Purpose
This guide provides the basic steps necessary in order for you to join Tehama.
Joining Tehama
NOTE: Tehama at this time is by invitation only. If you are interested in ordering Tehama, reach out to us through Tehama Support.
Invite Email
You've likely received an invitation through email, sent to the email address you provided for your order/purchase of Tehama.
- From: no-reply@tehama.io
- Subject: Welcome to Tehama
Note: Please check your spam folder if no email is received.
The invitation will be either:
- to create an 'Organization';
- to join an existing organization as a 'Team Member'; or
- to connect to a 'Room' which may require you to create an organization.
Locate the invite email.
The invitation email will contain a link which will need to be actioned in order to set up Tehama.
For the first two types of invitation, the link will be 'Accept invitation'.
- Click on the link. The JOIN TEHAMA dialog will appear.
For the third type of invitation (connect to a Room), the link will be 'Launch Room'.
- Click on the link. The Join room in TEHAMA dialog will appear.
This will present you with two options:
- "I already have an account", followed by a LOG IN button.
Select this if you already have an organization that you wish to use to connect to this room
- Click on the LOG IN button. The SIGN IN TO YOUR ORGANIZATION dialog will appear.
- Enter your organization's subdomain.
- Click CONTINUE. You will see the LOGIN dialog.
- Continue to log in to the Tehama Web UI as you normally would.
- Once you are logged in, you will be directed to the Room connection process.
or- "I need to create an account", followed by a JOIN TEHAMA button.
Select this if you want to create a new organization to connect to this room.
- Enter the name you wish to give to your new organization.
- Click on the JOIN TEHAMA. The CHOOSE A SUBDOMAIN dialog will appear.
- Enter a subdomain name for your new organization.
- Click NEXT. The JOIN TEHAMA dialog will appear. (This is the same user account-creation dialog that is seen from the 'Accept invitation' link found in the other invite emails.)
Note: The Tehama Web UI will display a warning banner if it is opened in a browser that is not one of Tehama's supported platforms. Your experience with the Tehama Web UI will be suboptimal if you continue with an unsupported browser. Instead, re-open the link in one of the browsers listed at the top of Tehama's About page.
User Account Creation
Having clicked on the link in the invite email, you will be presented with a page displaying the JOIN TEHAMA dialog, (after a few preliminary steps, if you are connecting a new organization to a room).
The first step is to create a new Tehama User Account for yourself.
NOTE: After setup is complete, you may opt to enable Single Sign On (SSO) for your organization, if your plan supports this option. SSO will allow your organization members to use accounts from an identity provider to log in to Tehama. You as the organization Admin user will continue to log in to the organization using the Tehama User Account you are about to create. You can find more information on this in the Authentication User Guide.
From the JOIN TEHAMA dialog:
EITHER:
Create a Tehama User Account for this organization with credentials managed by Tehama:
- Fill in the following fields:
Field Description Name First and Last Name (auto-populated) (this will be the full name of your personal User (organization member) account in this organization) Email Address (auto-populated) (this will be your Tehama username, used to login to this organization) Password Your desired password Confirm Password Confirm desired password
Take some time to browse Tehama's terms by clicking on terms. (Note: Terms of service are not shown to members of organizations that have enabled custom terms of service.)
Click on REGISTER. A dialog to set up Google Authenticator will appear.
- Set up a Google Authenticator application on a secondary device (e.g.: tablet or phone). See the section on 2FA authentication in the Authentication User Guide.
- Click NEXT. A LOGIN dialog will appear.
OR:
Create a Tehama User Account for this organization with your Google credentials:
If you see a button at the bottom of the JOIN TEHAMA dialog with the text SIGN UP WITH GOOGLE, you can choose to sign up with your existing Google Account.Your Google credentials (username/password) will be the login credentials for your Tehama User Account.
- Click on the SIGN UP WITH GOOGLE button. The LOGIN dialog will appear.
Initial Log in
From the LOGIN dialog:
EITHER:
If you opted to sign in with credentials managed by Tehama:
- Enter your username.
- Enter your password.
- Click SIGN IN. The Two factor authentication dialog will appear.
- Find your six-digit Authentication Code in the Google Authenticator application on your chosen secondary device and enter it into the dialog.
- Click LOG IN.
OR:
If you opted to sign up with your Google credentials:
- Click SIGN IN WITH GOOGLE.
The following is not applicable if your organization has enabled custom terms of service.
Note:
While you are using Tehama, Tehama continuously checks to see if you have accepted the latest Terms of Service (ToS). If a version of the ToS that is newer than the last one you accepted exists, you will be prompted to view and accept it. You are required to accept the latest ToS before you may proceed to interact with Tehama through the Web UI.
WARNING: Failure of the Admin user for the organization (the user with the Admin role for the organization) to accept the latest ToS within fifteen days of issuance may result in the suspension of the organization's account.
See the 'Login instructions' in the Authentication User Guide for more information on accepting the Terms of Service.
Organization Plan
If you were invited to join as a team member skip this step and proceed to Profile Page Completion.
If you are still here, you were invited to join to create an organization, or to connect to a Room, requiring you to create an organization.
Upon a successful login, you will be directed to your Organization plan page, entitled 'Welcome to TEHAMA'.
This page shows your support plan. Click CONTINUE to confirm that you have agreed to subscribe to this plan. (This plan can be changed at any time.)
Organization Registration
You should have been directed to your Organization's Settings profile page. If you were not, then click on the SETTINGS tab in the navigation bar.
Complete all required fields and correct any mistakes the inviter may have made in your Organization's contact details.
Fields to complete:
- Organization name (Auto-populated)
- Country
- Address
- City
- State/Province
- ZIP/Postal Code
- Phone Number
Press Complete Registration.
Profile Page Completion
You should then be directed to your Tehama User Personal Profile page where you can enter profile details. If you are not, then open the User menu at the bottom left and select Profile and then the sidebar item PROFILE.
This is what other organizations will see about you when deciding to grant you access to Rooms so we generally encourage you to fill this out completely.
Fields to complete:
- Name (full name) (Auto-populated)
- Title
- Email (Auto-populated)
- Phone
- Country
- Address
- ZIP/Postal Code
- City
- State/Province
- Country of Citizenship
Press Save.
Email Customization
You can work with a Tehama Concierge to customize select emails that are sent out by Tehama on your behalf. If this is something your organization would like to do, contact the Tehama Concierge service through Tehama Support to start the process.
Next Steps
At this point you are ready to take your next steps in the Tehama Installation Guide.
Probable next steps:
If you were invited to create an organization, or connect to a Room
you may have also been invited to:
If not, check out the typical Room creation scenarios.
If you were invited to join as a team member
You should be re-directed to the ROOMS page. If not, click the ROOMS tab in the navigation bar.
If you were invited as part of setting up a new Room, you should see the Room in the Room list in the main area.
If not, you are probably done for now unless you were invited by someone in your organization as an Org Manager or a Room Manager to create a Room. In which case, check out the typical Room creation scenarios.