Security_Protocol Documentation

Comprehensive guide to GOBERIN's multi-layered authentication infrastructure, including email verification, administrative SMTP configurations, and multi-factor authorization.

Phase_01

Email Verification System

User Registration Flow

1

Accounts are created with INACTIVE status and isEmailVerified: 0.

2

An automated verification signal containing a unique 32-character token is dispatched to the user's registry.

3

Upon token validation, account status transitions to ACTIVE.

Admin Configuration

Admins can customize the verification matrix via Settings > System Config:

  • SMTP Host, Port, and Credentials
  • Customemail_verification_url

Placeholder Node: Use {{token}} to inject the verification logic into your custom URL.

Phase_02

Multi-Factor Authentication (2FA)

Stage 1: Login

If 2FA is active, standard credentials yield a tempToken. Access is restricted until Phase 2 validation is complete.

Stage 2: Verification

Users provide a 6-digit TOTP code generated by synchronized authenticators to finalize the session handshake.

Sensitive Action Protect

High-risk operations (API Key generation, Config changes) trigger a dedicated 2FA modal for immediate authorization.

Deployment Sequence

Follow these vectors to activate your Security Layer Alpha.

01

Generate Seed

Initialize setup in Profile > Security to receive your unique TOTP secret and QR matrix.

02

Sync Device

Scan the QR code with Google Authenticator, Authy, or any compatible protocol.

03

Dual Verification

Request an Email OTP and pair it with your first TOTP code to anchor the synchronization.

04

Activation

Confirm the handshake to activate global multi-factor protection across the node.

Phase_03

Advanced API Authorization

Required Headers

Authorization Bearer {token}
X-2FA-Code (Required for sensitive endpoints)
6-Digit TOTP

Integration Note

Automated integrations using API Keys bypass standard login 2FA but still require X-2FA-Code for operations that modify core configurations.

System_Core_Alpha // Secure