> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/authentication-and-access-control.md).

# Authentication and Access Control

Sign in to Telmai, and manage users and their roles.

## Sign in to Telmai

### General Login Steps

1. Go to the Login Page: Navigate to the Telmai login page.
2. Enter Credentials: Use your registered email address and password.
3. Click "Sign In": Click the sign-in button to access your Telmai account.

### Single Sign-On (SSO) Login Steps

Many organizations use SSO for a more secure and streamlined login experience. If your company uses an identity provider (IdP) like Okta, you'll use this method to log in.

1. Go to the Login Page: Navigate to the Telmai login page.
2. Enter Credentials: Use your registered email address.
3. If SSO is configured for your account, you will be navigated to the IDP option. If multiple SSOs are configured, you will need to select the desired one.
4. You will be redirected to your organization's identity provider login page.
5. Enter your Company Credentials: Use your standard company username and password to authenticate.
6. Redirect to Telmai: After successful authentication with your IdP, you'll be redirected back to the Telmai Account.

To set up SSO for your tenant, see [SSO Configuration](https://docs.telm.ai/telmai/authentication-and-access-control/sso-configuration.md).

### Sign in Issues

Potential issues you may face when signing in:

* Account locked out
* User not added to SSO group
* User not added to Telmai account

## Managing Users <a href="#managing-users" id="managing-users"></a>

Tenant admins add, edit and delete users in **Administration** > **Users**. You can also open it from **Manage tenant users** in the account menu, under your initials at the top right.

* Click **New user** to add a user. Enter their **User email**, **First name** and **Last name**, optionally a **Password (optional)**, and choose their roles under **Project permissions**. Click **Create**.
* Click a user to open **Edit user** and change their details or permissions. To send them a password reset email, click **Reset user password**, then **Send email** in the **Reset password** dialog.
* Click **Delete** on a user to remove them from the tenant.

### Role-based Access <a href="#role-based-access" id="role-based-access"></a>

Telmai permissions are set per project. A user can have a different role in each project.

| Role         | Add/Modify Users | Add, Edit or Delete Assets | Scan Assets / Schedule Scans | View scan results |
| ------------ | ---------------- | -------------------------- | ---------------------------- | ----------------- |
| Tenant Admin | x                | x                          | x                            | x                 |
| Editor       |                  | x                          | x                            | x                 |
| Operator     |                  |                            | x                            | x                 |
| Viewer       |                  |                            |                              | x                 |

To change a user's roles:

1. Open **Administration** > **Users**.
2. Click the user to open **Edit user**.
3. Under **Project permissions**, choose **Editor**, **Operator** or **Viewer** for each project. To make the user a tenant admin, check **Grant admin privileges**. Admins have full access to every project, so project roles don't apply to them.
4. Click **Save**.

To create or change projects, see [Projects](https://docs.telm.ai/telmai/connect-to-data/projects.md).
