login512 / server-sdk
Official Login512 Server SDK for PHP (Post-Quantum Passwordless Face Authentication)
v1.0.0
2026-11-21 10:11 UTC
Requires
- php: >=8.0.0
- ext-curl: *
- ext-json: *
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Official PHP server-side SDK for Login512 — Global Post-Quantum Passwordless Face Authentication API.
Requirements
- PHP >= 8.0
ext-curlext-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']]);