Laravel 12, güçlü araçları ve modern özellikleriyle web geliştirme dünyasında büyük bir adım atarken, WorkOS entegrasyonu ile güvenli ve kolay kimlik doğrulama çözümleri sunuyor. Bu rehberde, Laravel 12 projelerinizde WorkOS kullanarak Single Sign-On (SSO), sosyal kimlik doğrulama ve passkey desteği gibi özellikleri nasıl entegre edeceğinizi anlatacağız.

WorkOS Nedir?

WorkOS, kurumsal düzeyde kimlik doğrulama çözümleri sunan bir platformdur. Özellikle SSO, dizin senkronizasyonu ve güvenli kimlik doğrulama mekanizmaları ile öne çıkar. WorkOS ile şunları kolayca gerçekleştirebilirsiniz:

• Google, Microsoft ve diğer hizmetlerle SSO entegrasyonu.
• Sosyal Kimlik Doğrulama: Facebook, GitHub, Google gibi hizmetler üzerinden kullanıcı girişleri.
• Passkey Desteği: Şifre gereksinimini ortadan kaldıran modern bir kimlik doğrulama yöntemi.

Laravel 12 ile WorkOS Entegrasyonu

Laravel 12’de WorkOS entegrasyonunu birkaç adımda gerçekleştirebilirsiniz:

1. WorkOS SDK’sını Kurma

Laravel projenize WorkOS PHP SDK'sını yükleyerek başlayın:

composer require workos/workos-php

2. WorkOS API Anahtarlarını Tanımlama

WorkOS API anahtarlarınızı ve Client ID’nizi ".env" dosyasına ekleyin:

WORKOS_API_KEY=your_api_key
WORKOS_CLIENT_ID=your_client_id

3. WorkOS Yapılandırması

AppServiceProvider içinde WorkOS yapılandırmanızı gerçekleştirin:

use WorkOS\WorkOS;

public function boot()
{
    WorkOS::setApiKey(env('WORKOS_API_KEY'));
}

4. Kimlik Doğrulama Rotalarını Ekleyin

Gerekli yönlendirmeleri ve kontrol yapısını ayarlayın. Örneğin:

Route::get('/sso', [SSOController::class, 'redirectToWorkOS']);
Route::get('/callback', [SSOController::class, 'handleCallback']);

Örnek SSO İş Akışı

SSO İşlemini Yönlendirme:
Bir kullanıcının oturum açması için bir yönlendirme bağlantısı oluşturabilirsiniz:

use WorkOS\SSO;

public function redirectToWorkOS()
{
    $authorizationUrl = SSO::getAuthorizationURL([
        'client_id' => env('WORKOS_CLIENT_ID'),
        'redirect_uri' => url('/callback'),
        'provider' => 'google',
    ]);

    return redirect($authorizationUrl);
}

Callback İşleme:
Kullanıcı oturum açtığında gelen kimlik bilgilerini işleyin:

public function handleCallback(Request $request)
{
    $profile = SSO::getProfileAndToken($request->input('code'));
    // Kullanıcı verilerini kaydet ve oturum açtır
    $user = User::firstOrCreate([
        'email' => $profile->email,
    ]);

    Auth::login($user);
    return redirect('/dashboard');
}

Sosyal Kimlik Doğrulama ve Passkey Desteği

Sosyal Kimlik Doğrulama:
WorkOS, Google, Facebook, Microsoft ve diğer sosyal platformlar için kimlik doğrulamayı destekler. Yukarıdaki kodu provider parametresini değiştirerek sosyal kimlik doğrulama için kullanabilirsiniz.

Passkey Desteği:

Passkey’ler ile şifre girmeden güvenli oturum açma özelliklerini aktif edebilirsiniz. WorkOS dokümantasyonunu inceleyerek bu özelliği detaylıca entegre edebilirsiniz.

Laravel 12 ile WorkOS Kullanmanın Avantajları

• Güçlü Güvenlik: Kullanıcı verileriniz güçlü şifreleme ve modern kimlik doğrulama yöntemleri ile korunur.
• Hızlı Entegrasyon: WorkOS SDK’sı ve Laravel’in güçlü mimarisi entegrasyon sürecini hızlandırır.
• Kullanıcı Deneyimi: Tek bir oturum açma (SSO) ile kullanıcılara kesintisiz bir deneyim sunabilirsiniz.

Laravel 12 ve WorkOS, hem geliştiriciler hem de kullanıcılar için modern, güvenli ve kullanımı kolay bir kimlik doğrulama çözümü sunuyor. Bu iki güçlü araçla, hem kurumsal uygulamalar hem de sosyal platformlar için ideal bir altyapı kurabilirsiniz.