Sosyal Giriş Sağlayıcısı Yazma

coremio/modules/SocialAuth/Acme/
├── Acme.php          class Acme extends \SocialAuthProvider
├── config.php        künye + durum + boş ayar anahtarları
├── acme.svg          marka logosu, isteğe bağlı (bi-* simgesine geri düşülür)
└── lang/
    ├── en.php
    └── tr.php

// Sunum. ['label' => string, 'icon' => 'bi-*', 'logo' => mutlak url (isteğe bağlı)]
abstract public function provider_meta(): array;

// Ayarlar akordiyonu için kimlik bilgisi şeması. Aşağıdaki anahtar tablosuna bakın.
abstract public function configFields(): array;

// [Bağlantıyı Test Et] butonu. true döndürün, ya da operatörün işine yarayacak bir mesajla fırlatın.
abstract public function testConnection(): bool;

abstract protected function auth_endpoint(): string;    // popup'ın kullanıcıyı gönderdiği yer
abstract protected function token_endpoint(): string;   // kodun takas edildiği yer
abstract protected function scopes(): string;           // örn. 'openid email profile'
abstract protected function jwks_url(): string;         // imza doğrulama anahtarları
abstract protected function issuers(): array;           // kabul edilen `iss` değerleri

// $ctx = ['code' => string, 'redirect_uri' => string, 'nonce' => string]
abstract public function feedback(array $ctx): array;

return [
    // Hesap bağı. `name` bir kullanıcı bilgi anahtarı olur, `value` şifreli kalıcı kimliktir.
    'field_info' => [
        'name'  => "acme_uid",
        'value' => Crypt::encode($sub, Config::get("crypt/user")),
    ],
    // Hesabın neyden kurulduğu / neyle eşleştirildiği.
    'data' => [
        'name'         => "Ada",              // ad
        'surname'      => "Lovelace",         // soyad
        'email'        => "[email protected]",  // sağlayıcı tarafından doğrulanmış OLMALI
        'picture'      => "",                 // avatar url'si, ya da boş dize
        'provider_uid' => $sub,               // ham kimlik, şifresiz
    ],
];

<?php
namespace WISECP\Modules\SocialAuth;

use Config;
use Crypt;
use Exception;
use Filter;
use Utility;

class Acme extends \SocialAuthProvider
{
    public function provider_meta(): array
    {
        return [
            'label' => $this->lang["button-label"] ?? "Continue with Acme",
            'icon'  => 'bi-box-arrow-in-right',
            'logo'  => $this->url . 'acme.svg',
        ];
    }

    public function configFields(): array
    {
        return [
            'client_id' => [
                'type'        => 'text',
                'label'       => $this->lang["field-client-id"] ?? "Client ID",
                'required'    => true,
                'placeholder' => "acme-0000-0000",
                'description' => $this->lang["field-client-id-desc"] ?? '',
            ],
            'client_secret' => [
                'type'        => 'password',
                'label'       => $this->lang["field-client-secret"] ?? "Client Secret",
                'required'    => true,
                'description' => $this->lang["field-client-secret-desc"] ?? '',
            ],
        ];
    }

    protected function auth_endpoint(): string  { return "https://id.acme.example/oauth2/authorize"; }
    protected function token_endpoint(): string { return "https://id.acme.example/oauth2/token"; }
    protected function scopes(): string         { return "openid email profile"; }
    protected function jwks_url(): string       { return "https://id.acme.example/.well-known/jwks.json"; }
    protected function issuers(): array         { return ["https://id.acme.example"]; }

    public function testConnection(): bool
    {
        $clientId = $this->client_id();
        if ($clientId === '')
            throw new Exception($this->lang["error-invalid-client-id"] ?? "Please enter a Client ID.");

        // Sağlayıcıya bu kimliğin var olup olmadığını sorun: bilinmeyen biri invalid_client,
        // gerçek olan redirect_uri_mismatch döndürür. Biçim denetimi ikisini de geçirirdi.
        $probe = $this->auth_endpoint() . '?' . http_build_query([
            'client_id'     => $clientId,
            'response_type' => 'code',
            'scope'         => $this->scopes(),
            'redirect_uri'  => $this->callback_url(),
            'state'         => 'wisecp-connectivity-check',
        ]);

        $resp = (string) Utility::HttpRequest($probe, ['timeout' => 8]);
        if ($resp === '')
            throw new Exception($this->lang["error-unreachable"] ?? "Could not reach Acme.");

        if (str_contains($resp, 'invalid_client'))
            throw new Exception($this->lang["error-client-not-found"] ?? "Acme does not recognize this Client ID.");

        return true;
    }

    public function feedback(array $ctx): array
    {
        $code = (string) ($ctx['code'] ?? '');
        if ($code === '') throw new Exception("Missing authorization code.");

        $token   = $this->exchange_code($code, (string) ($ctx['redirect_uri'] ?? ''));
        $payload = $this->verify_id_token((string) $token['id_token'], (string) ($ctx['nonce'] ?? ''));

        $email = (string) ($payload["email"] ?? '');
        if (!$email)
            throw new Exception($this->lang["error-no-email"] ?? "Could not read your email address.");

        // Şüphede reddet: çözücü mevcut bir hesabı e-postayla eşler, yani doğrulanmamış
        // bir adres herkesin başkasının hesabını sahiplenmesine izin verirdi.
        if (($payload["email_verified"] ?? false) !== true)
            throw new Exception($this->lang["error-email-unverified"] ?? "Acme has not verified this email address.");

        $fullName = trim((string) ($payload["given_name"] ?? '') . ' ' . (string) ($payload["family_name"] ?? ''));
        $smash    = Filter::name_smash(Utility::ucfirst_space(Utility::substr($fullName, 0, 255)));

        $sub = (string) ($payload["sub"] ?? '');
        if ($sub === '') throw new Exception($this->lang["error-no-account"] ?? "Could not identify your Acme account.");

        return [
            'field_info' => [
                'name'  => "acme_uid",
                'value' => Crypt::encode($sub, Config::get("crypt/user")),
            ],
            'data' => [
                'name'         => $smash["first"] ?? '',
                'surname'      => $smash["last"] ?? '',
                'email'        => $email,
                'picture'      => (string) ($payload["picture"] ?? ''),
                'provider_uid' => $sub,
            ],
        ];
    }
}

// classes/Auth.php - handleProviderCallback(), sınıfınızın dokunduğu kısma indirgenmiş.
$st = $provider->consume_state($state);            // mode + context + nonce, tek seferlik
if (!$st) return ['status' => 'error', 'message' => "Sign-in could not be completed."];

$result = $provider->feedback([
    'code'         => $code,
    'redirect_uri' => $provider->callback_url(),
    'nonce'        => (string) ($st['nonce'] ?? ''),
]);

// connectProvider() sonra şunları bu sırayla yapar:
//   1. hesabı field_info ile arar (e-posta değişikliğinden sağ çıkar),
//   2. data.email değerine düşer,
//   3. yalnız mode=register ve üye bağlamında hesabı oluşturur,
//   4. field_info değerini saklar ki sonraki giriş 1. adımla çözülsün.
return Auth::connectProvider('member', 'Acme', $result, (string) ($st['mode'] ?? 'login'));

// controllers/website/sign.php - giriş sayfası, kayıtta ise aynı çağrı "register" ile.
$this->addData("social_providers", \Auth::activeProviders("login", "client"));

// Tema sonra diziyi gezer; her kayıt ['meta' => [...], 'button' => '<html>'] biçimindedir.