# AWS Face Liveness Pro
**Documentation last updated:** March 2026 | **Plugin last updated:** March 2026


# Overview

Seamlessly integrate **AWS Rekognition Face Liveness** detection directly into your Bubble.io application.

This plugin prevents advanced spoofing attacks (printed photos, 3D masks, digital screens) by ensuring a real, live human is physically present during onboarding, KYC (Know Your Customer), or high-security actions.

The video stream is captured securely on the user's browser and sent directly to AWS via native HTML5/React Web Components — no heavy Bubble backend video processing required.

---

# Plugin Details & Categories

*   **Primary Categories:** Artificial Intelligence (AI), Compliance, Security, Identity Verification.
*   **Search Tags:** Face Liveness, AWS Rekognition, KYC, Biometrics, Anti-Spoofing, Identity Fraud, Webcam, Video Verification.
*   **Platform Support:** Desktop (Chrome, Safari, Edge, Firefox), Mobile (iOS Safari, Android Chrome), Native Wrappers (BNC, GoNative).

---

# Pre-Requisites

*   An active **Amazon Web Services (AWS)** account.
*   An **IAM User** with `rekognition:CreateFaceLivenessSession` and `rekognition:GetFaceLivenessSessionResults` permissions.
*   A **Cognito Identity Pool ID** (Guest Access) for secure frontend video streaming.

> Full setup instructions are available in the demo app documentation.

---

# Element: Face Liveness Camera (Front-End)

A responsive Web Component that renders a camera feed with a UI targeting oval. It analyzes the user's distance and lighting before securely streaming the video challenge to AWS.

> **Important:** Place this element inside a **Bubble Popup** or **Floating Group** that covers the entire screen, and set its width and height to 100%. Do not place it inside a small constrained Group.

**Properties:**

*   **Session ID (Text):** The 36-character token generated by the Start Liveness Session action. Typically sourced from a Custom State.
*   **Cognito Identity Pool ID (Text):** Your AWS Guest Access pool ID.
*   **Region (Text):** Your AWS region (e.g., `us-east-1`).
*   **Primary Color (Color):** Hex code to theme the AWS UI to match your branding.

**Events:**

*   **Check Finished:** Fires when video capture completes and has been uploaded to AWS. Trigger the Get Liveness Results action immediately.
*   **Check Failed:** Fires on error — camera blocked, poor lighting, network timeout, or user cancellation.

**Exposed States:**

*   **Is Completed (Yes/No):** Becomes "Yes" when the check finishes or fails.
*   **Error Message (Text):** Describes exactly why a check failed (e.g., "Camera access denied").

---

# Actions

### Start Liveness Session (Back-End)
*Run this before showing the camera to the user.*

Requests a new one-time session token from AWS.

*   **Inputs:** None required.
*   **Returns — Session ID (Text):** Pass this to the Camera Element's Session ID property.

---

### Get Liveness Results (Back-End)
*Run this inside the Check Finished event workflow.*

Retrieves the AI analysis results from AWS for the completed session.

*   **Input — Session ID (Text):** The Session ID from Start Liveness Session.
*   **Returns:**
   *   **Confidence Score (Number 0–100):** Likelihood the user is a live human. AWS recommends accepting scores above 90.
   *   **Is Live (Yes/No):** Definitive boolean determination from AWS.
   *   **Status (Text):** Server status string (e.g., "SUCCEEDED", "FAILED", "EXPIRED").
   *   **Reference Image Base64 (Text):** Highest-quality photo taken during the scan, Base64-encoded. Use directly as a Bubble Image element's dynamic source.

---

# Plugin Demo

**[View Live Interactive Demo](https://aws-plugin-preview.bubbleapps.io/version-test/aws_faceliveness_check)**

**[View Demo App Editor](https://bubble.io/page?id=aws-plugin-preview&tab=Design&name=aws_faceliveness_check&type=page)**

---

# Contact / Support

For feature requests, general support, or AWS IAM configuration assistance:

📧 **[email protected]**