> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/authentication/passwordless-for-web-apps/login-methods/liveid-biometric-authentication.md).

# LiveID (Biometric Authentication)

***

### Overview

It is designed to replace traditional password-based login and passwordless methods that rely on biometric authenticator apps or passkeys.

During enrollment, LiveID captures a high-quality, forward-facing selfie suitable for biometric verification. The system automatically checks face positioning, visibility, orientation, and pose stability before capturing. No manual interaction is required, the capture is fully automatic.

### Enrolling LiveID

Users enroll their LiveID selfie from **My Profile** after logging in with any already-registered authentication method (for example, password + OTP or push notification).

1. Log in to your tenant
2. Navigate to **My Profile > Login Options**
3. Under the **Setup** drop-down, click **LiveID Selfie**
4. On the **Enroll LiveID Selfie** screen, review and accept the consent notice, then click **Capture**.
5. The camera opens and automatically captures your selfie
6. When prompted, enter a **4-digit PIN** and click **Submit**

{% hint style="info" %}
   Note: **PIN is configurable (4/6/8)**
{% endhint %}

A confirmation message confirms successful enrollment. The PIN is required whenever an additional authentication factor is challenged, based on the configured authentication policy.

### Configuring Adaptive Authentication for LiveID

Community Administrators configure LiveID as an authentication method via **Authentication > Adaptive Authentication**. Two options are available under the Decision Actions:

| Method                                | Description                                                                        |
| ------------------------------------- | ---------------------------------------------------------------------------------- |
| **LiveID Selfie**                     | Prompts the user to provide a selfie on a camera-enabled device                    |
| **LiveID Selfie & Push Notification** | Uses facial biometric combined with push notification approval via the 1Kosmos app |

### Logging in with LiveID

1. Open the tenant URL
2. Navigate to the **LiveID Selfie** tab
3. Read the on-screen instructions, the camera opens automatically
4. Present your face; the system captures the selfie automatically once it detects a clear, stable image
5. Enter your **4-digit PIN** when prompted *(PIN length is configurable by the admin to contain 4, 6 or 8 digits)*
6. Upon successful authentication, you are logged into the tenant

### Best Practices

* Use a well-lit environment to ensure clear image quality
* Maintain a steady, forward-facing pose for at least 600ms
* Keep your face within the on-screen circular frame
* Avoid tilting your head left, right, or sideways
* Avoid wearing headwear or face coverings that block facial features
* Small, natural head movements are allowed and will not reset the capture
* Follow the real-time guidance messages displayed during capture


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.1kosmos.com/authentication/passwordless-for-web-apps/login-methods/liveid-biometric-authentication.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.