# Cloud Voice App Login Overview

The Cloud Voice App desktop client gives you more than one way to sign in. You can authenticate with your extension account, or, if your administrator has connected the system to an outside identity provider, sign in with a third-party account instead. Choose whichever method matches how your account was set up.

:::note
Not every method is available on every system. The extension account options (quick login and manual login) always work, but the third-party single sign-on options only appear when your administrator has enabled them. If you are not sure which method applies to you, ask your administrator.
:::

## Sign in with your extension account

Your extension account is the account tied to your phone extension on the system. It can get you into the desktop client in several ways. The quick options need no manual typing, while manual login lets you enter your details by hand.

### Quick login

- **Login link**: When your administrator sets you up as a user, you receive a welcome email that contains a login link. Opening that link signs you in to the desktop client automatically, with nothing to type. See [Log in with Extension Account Using a Login Link](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-extension-account-using-login-link/).
- **One-click login**: If you are already signed in to the Cloud Voice App in your web browser (the web client), you can open the desktop client from there with a single click. See [Log in with Extension Account by One Click](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-extension-account-by-one-click/).

:::tip
The login link and one-click methods are the fastest and least error-prone way in, because you never type a username, password, or server address. Use one of them whenever it is available.
:::

:::caution
The login link in your welcome email signs you straight into your extension, so treat it like a password. Do not forward the welcome email or share the link with anyone.
:::

### Manual login

Use manual login when you do not have a login link and are not already signed in on the web. Before you start, ask your administrator for:

1. Your username and password.
2. The server network details (such as the server address) so the client knows where to connect.

Enter this information in the desktop client to sign in. See [Log in with Extension Account Using Manually Entered Credentials](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-extension-account-using-manually-entered-credentials/).

:::note
Manual login needs all of the details above, not just your username and password. Even correct credentials will fail if the server network information is missing or wrong, because the client cannot reach the server without it.
:::

## Sign in with a third-party account

When your administrator has integrated the system with an external identity provider, you can sign in to the desktop client directly with that provider's account. This uses single sign-on (SSO), meaning you reuse one existing account (for example your work Microsoft or Google account) instead of a separate voice password. The supported providers are:

- [Log in with a Microsoft Account](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-microsoft-account/), available when the system is connected to Microsoft Entra ID (Azure Active Directory).
- [Log in with an Active Directory Domain Account](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-active-directory-domain-account/), available when the system is connected to Active Directory (AD), the on-premise Windows directory service.
- [Log in with a Google Account](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-google-account/), available when the system is connected to Google Workspace.
- [Log in with a Red Hat Account](/pbx/desktop-client-user-guide/log-in-to-cloud-voice-app-with-red-hat-account/), available when the system is connected to Red Hat SSO.