Search by

login512 / server-sdk

narubest

Official Login512 Server SDK for PHP (Post-Quantum Passwordless Face Authentication)

Package info

github.com/login512/login512-php

pkg:composer/login512/server-sdk

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-11-21 10:11 UTC

This package is auto-updated.

Last update: 2026-11-21 10:18:45 UTC


README

Official PHP server-side SDK for Login512 — Global Post-Quantum Passwordless Face Authentication API.

Requirements

  • PHP >= 8.0
  • ext-curl
  • ext-json

Installation

Via Composer:

composer require login512/server-sdk

Or include Login512.php directly:

require_once __DIR__ . '/Login512.php';
use Login512\Login512;

4-Step Integration Flow

Step 1: Generate Nonce for Session

Before displaying the Login512 biometric frame, generate a cryptographically secure 32-byte nonce on your server and store it in the user's session:

use Login512\Login512;

session_start();
$nonce = Login512::generateNonce();
$_SESSION['auth_nonce'] = $nonce;

header('Content-Type: application/json');
echo json_encode(['nonce' => $nonce]);

Step 2: Receive & Verify Token from Frontend

When the user finishes face authentication, receive the post-quantum L512 token and verify it against Login512 API:

use Login512\Login512;

session_start();
$input = json_decode(file_get_contents('php://input'), true);
$token = $input['token'] ?? '';
$expectedNonce = $_SESSION['auth_nonce'] ?? null;

$result = Login512::verifyToken(
    secretKey: getenv('LOGIN512_SECRET_KEY'), // e.g. l512_sk_...
    token: $token,
    expectedNonce: $expectedNonce
);

if (!$result['valid']) {
    http_response_code(401);
    echo json_encode(['error' => $result['error']]);
    exit;
}

// Step 3: Handle Session Authorization vs Step-up
if ($result['session_allowed']) {
    // Normal passwordless login
    $_SESSION['user_id'] = $result['claims']['sub'];
    echo json_encode(['ok' => true, 'user_id' => $result['claims']['sub']]);
    exit;
}

if ($result['step_up_required']) {
    // New device policy triggered step-up requirement
    $_SESSION['pending_device_ref'] = $result['claims']['did'];
    echo json_encode([
        'step_up_required' => true,
        'message' => 'Unrecognized device: please verify via Passkey/MFA'
    ]);
    exit;
}

Step 3: Device Trusting after Step-up

If $result['step_up_required'] is true, perform step-up authentication (e.g. Passkey), then mark the device as trusted:

use Login512\Login512;

session_start();
$deviceRef = $_SESSION['pending_device_ref'] ?? '';

Login512::trustDevice(
    secretKey: getenv('LOGIN512_SECRET_KEY'),
    deviceRef: $deviceRef
);

unset($_SESSION['pending_device_ref']);
echo json_encode(['ok' => true]);

Step 4: Enabling Face Login (Enrollment)

Enable Face Login for existing authenticated users:

use Login512\Login512;

session_start();
$userId = $_SESSION['user_id'];

// 1. Create one-time enrollment token
$enrollment = Login512::createEnrollmentToken(
    secretKey: getenv('LOGIN512_SECRET_KEY'),
    externalUserId: $userId,
    displayName: $_SESSION['user_name'] ?? null,
    ttlSeconds: 120
);

echo json_encode(['enrollment_token' => $enrollment['token']]);