Authentication Overview

The Preads Platform features a robust, OAuth 2.0-compliant social authentication system, providing publishers with a frictionless, single-click registration and login experience. By integrating industry-standard providers like Google, Facebook, and Twitter (X), you can significantly improve conversion rates and streamline the onboarding process for your global network.

🏗️ Unified Authentication Architecture

The platform's social authentication is built on the Laravel Socialite ecosystem and features a unified SocialAuthController that standardizes user attribute mapping across all providers.

Core Features

  • Single-Click Registration: New publishers can join the network instantly using their existing social profiles.
  • Account Linking: The system automatically identifies existing accounts by email address, allowing social logins to "link" to legacy profiles.
  • Verified by Default: Social logins through trusted providers are treated as "Verified," automatically setting the email_verified_at timestamp.
  • Seamless Referrals: Social registration fully supports the platform's multi-tier referral system via deep-linked session tracking.

⚙️ Dynamic Configuration

Unlike traditional integrations that require hardcoded environment variables, the Preads Platform allows for Dynamic API Management.

Administrators can configure, enable, or disable individual social providers directly from the Admin Panel → Settings → Social Login without requiring a server reboot or .env modification.

Configuration Hierarchy

  1. Admin Panel Settings: Primary source for Client IDs and Secrets.
  2. Route Callbacks: Standardized internal routing handles the OAuth handshake.
  3. Encrypted Storage: Credentials are persisted securely in the platform's global settings repository.

🛡️ Security & Privacy

  • OAuth 2.0 Protocol: The platform uses secure redirection flows, ensuring your server never handles or stores raw user passwords.
  • Email Scoping: The platform requests only the minimum necessary permissions (email and profile) to maintain user privacy.
  • IP Intelligence Synergy: Social logins are passed through the platform's anti-fraud layer to prevent automated bot registrations via compromised social accounts.

Integration Guides

Select a provider below to view the detailed setup walkthrough:

Provider Status Setup Time
Google Supported ~5 Minutes
Facebook Supported ~10 Minutes
Twitter (X) Supported ~10 Minutes

Set up Google Authentication →