> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tenant login URL

> Find and share a tenant-specific sign-in URL for ABBYY Vantage, and understand how the URL interacts with optional External Identity Providers.

Each tenant in Vantage has a unique URL that takes users directly to that tenant's sign-in page. Use a tenant login URL to skip the cross-tenant email lookup and send users straight to the right tenant.

## Finding the tenant login URL

<Steps>
  <Step title="Open the tenant configuration">
    In Vantage, click **Configuration** in the left pane.
  </Step>

  <Step title="Copy the Login URL">
    Click **General** and find the **Login URL** field. Copy the URL to share it with your users.
  </Step>
</Steps>

## URL formats

A tenant login URL takes one of two forms:

| Format                                              | Purpose                                                                                                                                                              |
| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `vantage.com/login/<tenantName>`                    | Send the user to the tenant's sign-in page. The user enters their email on arrival.                                                                                  |
| `vantage.com/login/<tenantName>?login_hint=<email>` | Pre-fill the user's email so they go straight to the password screen (or to the External Identity Provider). Useful when the user is registered in multiple tenants. |

## Authentication behavior

How the login URL behaves depends on whether an External Identity Provider is configured for the tenant and whether the URL includes a `login_hint` parameter:

| External Identity Provider | `login_hint` included | What the user sees                                                   |
| :------------------------- | :-------------------- | :------------------------------------------------------------------- |
| Not configured             | No                    | Prompted for email, then password                                    |
| Not configured             | Yes                   | Prompted for password only                                           |
| Configured                 | No                    | Redirected to the Identity Provider; enters email and password there |
| Configured                 | Yes                   | Redirected to the Identity Provider; enters password only            |

## Related topics

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/vantage/documentation/tenant-admin/tenant-management/authentication">
    Sign-in flows and OAuth 2.0 / SAML 2.0 options
  </Card>

  <Card title="Associated email domains" icon="at" href="/vantage/documentation/tenant-admin/tenant-management/email-domains">
    Allow users from specific email domains to sign in
  </Card>

  <Card title="Setting up an External Identity Provider" icon="shield-halved" href="/vantage/documentation/tenant-admin/tenant-management/external-identity-provider">
    Overview of OAuth 2.0 and SAML 2.0 provider setup
  </Card>
</CardGroup>