> ## Documentation Index > Fetch the complete documentation index at: https://kawax.biz/llms.txt > Use this file to discover all available pages before exploring further. # Laravel Socialite (autenticazione social) > Come implementare login social (GitHub, Google, Facebook, ecc.) con OAuth 2.0 usando Laravel Socialite. ## Cos'è Laravel Socialite Laravel Socialite è il pacchetto ufficiale che semplifica il login social con OAuth 2.0. Supporta i principali provider (GitHub, Google, Facebook, X, LinkedIn) e ti permette di implementare OAuth in poche righe. Provider inclusi: | Provider | Chiave | | ----------------- | ------------------------ | | Bitbucket | `bitbucket` | | Facebook | `facebook` | | GitHub | `github` | | GitLab | `gitlab` | | Google | `google` | | LinkedIn (OpenID) | `linkedin-openid` | | Slack | `slack` / `slack-openid` | | Spotify | `spotify` | | Twitch | `twitch` | | X (Twitter) | `x` | ### Flusso di login social ```mermaid theme={null} sequenceDiagram participant User as Utente participant App as App Laravel participant OAuth as GitHub (OAuth) participant DB as Database User->>App: Click sul pulsante di login App->>OAuth: Redirect (Socialite::driver('github')->redirect()) OAuth->>User: Schermata di consenso User->>OAuth: Approvazione OAuth->>App: Callback (parametro code) App->>OAuth: Richiede access token OAuth-->>App: Info utente App->>DB: Crea/aggiorna utente (updateOrCreate) DB-->>App: Record utente App->>User: Login completato, redirect alla dashboard ``` *** ## Installazione ```shell theme={null} composer require laravel/socialite ``` Per gli upgrade di versione maggiore, consulta la [Guida all'upgrade](https://github.com/laravel/socialite/blob/master/UPGRADE.md). *** ## Configurazione ### config/services.php ```php theme={null} 'github' => [ 'client_id' => env('GITHUB_CLIENT_ID'), 'client_secret' => env('GITHUB_CLIENT_SECRET'), 'redirect' => env('GITHUB_REDIRECT_URI'), ], 'google' => [ 'client_id' => env('GOOGLE_CLIENT_ID'), 'client_secret' => env('GOOGLE_CLIENT_SECRET'), 'redirect' => env('GOOGLE_REDIRECT_URI'), ], 'facebook' => [ 'client_id' => env('FACEBOOK_CLIENT_ID'), 'client_secret' => env('FACEBOOK_CLIENT_SECRET'), 'redirect' => env('FACEBOOK_REDIRECT_URI'), ], ``` Path relativi in `redirect` sono automaticamente risolti in URL completi. ### .env ```ini theme={null} GITHUB_CLIENT_ID=your-client-id GITHUB_CLIENT_SECRET=your-client-secret GITHUB_REDIRECT_URI=https://example.com/auth/github/callback ``` Per GitHub, crea una OAuth App in [Developer Settings](https://github.com/settings/developers). *** ## Flusso di autenticazione ### Routing Servono due route (redirect e callback). ```php theme={null} use Laravel\Socialite\Facades\Socialite; Route::get('/auth/github', function () { return Socialite::driver('github')->redirect(); }); Route::get('/auth/github/callback', function () { $user = Socialite::driver('github')->user(); // $user->token per l'access token }); ``` ### Salvataggio utente e login ```php theme={null} use App\Models\User; use Illuminate\Support\Facades\Auth; use Laravel\Socialite\Facades\Socialite; Route::get('/auth/github/callback', function () { $githubUser = Socialite::driver('github')->user(); $user = User::updateOrCreate( ['github_id' => $githubUser->id], [ 'name' => $githubUser->name, 'email' => $githubUser->email, 'github_token' => $githubUser->token, 'github_refresh_token' => $githubUser->refreshToken, ] ); Auth::login($user); return redirect('/dashboard'); }); ``` Con `updateOrCreate` la colonna `github_id` deve esistere in `users`. *** ## Ottenere info utente ```php theme={null} Route::get('/auth/github/callback', function () { $user = Socialite::driver('github')->user(); // OAuth 2.0 $token = $user->token; $refreshToken = $user->refreshToken; $expiresIn = $user->expiresIn; // OAuth 1.0 (X) $token = $user->token; $tokenSecret = $user->tokenSecret; // Comuni $user->getId(); $user->getNickname(); $user->getName(); $user->getEmail(); $user->getAvatar(); }); ``` ### Da un token esistente ```php theme={null} $user = Socialite::driver('github')->userFromToken($token); ``` ### Modalità stateless ```php theme={null} return Socialite::driver('google')->stateless()->user(); ``` *** ## Integrazione DB ### Migration ```php theme={null} return new class extends Migration { public function up(): void { Schema::table('users', function (Blueprint $table) { $table->string('github_id')->nullable()->unique()->after('id'); $table->string('github_token')->nullable()->after('github_id'); $table->string('github_refresh_token')->nullable()->after('github_token'); }); } public function down(): void { Schema::table('users', function (Blueprint $table) { $table->dropColumn(['github_id', 'github_token', 'github_refresh_token']); }); } }; ``` ### Più provider con colonna provider ```php theme={null} Schema::table('users', function (Blueprint $table) { $table->string('provider')->nullable()->after('id'); $table->string('provider_id')->nullable()->after('provider'); $table->string('provider_token')->nullable()->after('provider_id'); $table->unique(['provider', 'provider_id']); }); ``` ```php theme={null} Route::get('/auth/{provider}/callback', function (string $provider) { $socialUser = Socialite::driver($provider)->user(); $user = User::updateOrCreate( [ 'provider' => $provider, 'provider_id' => $socialUser->getId(), ], [ 'name' => $socialUser->getName(), 'email' => $socialUser->getEmail(), 'provider_token' => $socialUser->token, ] ); Auth::login($user); return redirect('/dashboard'); }); ``` ### Collegamento a utente esistente ```php theme={null} $socialUser = Socialite::driver('github')->user(); $user = User::where('email', $socialUser->getEmail())->first(); if ($user) { $user->update([ 'github_id' => $socialUser->getId(), 'github_token' => $socialUser->token, ]); } else { $user = User::create([ 'name' => $socialUser->getName(), 'email' => $socialUser->getEmail(), 'github_id' => $socialUser->getId(), 'github_token' => $socialUser->token, ]); } Auth::login($user); ``` *** ## Scope e opzioni ### Scope ```php theme={null} return Socialite::driver('github') ->scopes(['read:user', 'public_repo']) ->redirect(); ``` `setScopes()` sovrascrive quelli esistenti. ```php theme={null} return Socialite::driver('github') ->setScopes(['read:user', 'public_repo']) ->redirect(); ``` ### Parametri aggiuntivi ```php theme={null} return Socialite::driver('google') ->with(['hd' => 'example.com']) ->redirect(); return Socialite::driver('google') ->with(['prompt' => 'consent']) ->redirect(); ``` Non passare a `with()` chiavi riservate come `state` o `response_type`. ### Bot token Slack ```php theme={null} return Socialite::driver('slack') ->asBotUser() ->setScopes(['chat:write', 'chat:write.public', 'chat:write.customize']) ->redirect(); $user = Socialite::driver('slack')->asBotUser()->user(); ``` *** ## Test ### Redirect ```php theme={null} use Laravel\Socialite\Facades\Socialite; test('l\'utente viene reindirizzato a GitHub', function () { Socialite::fake('github'); $response = $this->get('/auth/github'); $response->assertRedirect(); }); ``` ### Callback ```php theme={null} use Laravel\Socialite\Facades\Socialite; use Laravel\Socialite\Two\User; test('login con GitHub', function () { Socialite::fake('github', User::fake([ 'id' => 'github-123', 'name' => 'Jane Doe', 'email' => 'jane@example.com', ])); $response = $this->get('/auth/github/callback'); $response->assertRedirect('/dashboard'); $this->assertDatabaseHas('users', [ 'name' => 'Jane Doe', 'email' => 'jane@example.com', 'github_id' => 'github-123', ]); }); ``` Attributi aggiuntivi: ```php theme={null} $fakeUser = User::fake([ 'id' => 'github-123', 'name' => 'Jane Doe', 'email' => 'jane@example.com', 'token' => 'fake-token', 'refreshToken' => 'fake-refresh-token', 'expiresIn' => 3600, 'approvedScopes' => ['read:user', 'public_repo'], ]); ``` Per OAuth 1 usa `Laravel\Socialite\One\User`. *** ## Provider personalizzati Usa `Socialite::extend()`. `SocialiteManager` estende `Illuminate\Support\Manager`. Per il pattern Manager consulta [Manager class](/it/advanced/manager). ### 1. Crea la classe provider ```php theme={null} namespace App\Socialite; use Laravel\Socialite\Two\AbstractProvider; use Laravel\Socialite\Two\User; class ExampleProvider extends AbstractProvider { public function getAuthUrl($state): string { return $this->buildAuthUrlFromBase('https://example.com/oauth/authorize', $state); } protected function getTokenUrl(): string { return 'https://example.com/oauth/token'; } protected function getUserByToken($token): array { $response = $this->getHttpClient()->get('https://example.com/api/user', [ 'headers' => ['Authorization' => 'Bearer '.$token], ]); return json_decode($response->getBody(), true); } protected function mapUserToObject(array $user): User { return (new User)->setRaw($user)->map([ 'id' => $user['id'], 'nickname' => $user['login'] ?? null, 'name' => $user['name'], 'email' => $user['email'], 'avatar' => $user['avatar_url'] ?? null, ]); } } ``` | Metodo | Ruolo | | ------------------------------ | --------------------------------------- | | `getAuthUrl($state)` | URL di autorizzazione OAuth | | `getTokenUrl()` | Endpoint di scambio code → token | | `getUserByToken($token)` | Recupera l'utente dall'API con il token | | `mapUserToObject(array $user)` | Converte in `User` di Socialite | ### 2. Registralo nel service provider ```php theme={null} use App\Socialite\ExampleProvider; use Laravel\Socialite\Facades\Socialite; public function boot(): void { Socialite::extend('example', function ($app) { $config = $app['config']['services.example']; return Socialite::buildProvider(ExampleProvider::class, $config); }); } ``` ### 3. Configura ```php theme={null} 'example' => [ 'client_id' => env('EXAMPLE_CLIENT_ID'), 'client_secret' => env('EXAMPLE_CLIENT_SECRET'), 'redirect' => env('EXAMPLE_REDIRECT_URI'), ], ``` ### 4. Usalo come i provider integrati ```php theme={null} Route::get('/auth/example', function () { return Socialite::driver('example')->redirect(); }); Route::get('/auth/example/callback', function () { $user = Socialite::driver('example')->user(); }); ``` Puoi anche usare pacchetti di terze parti che estendono Socialite tramite `extend()`. *** ## Pacchetti correlati LINE SDK for Laravel. Oltre al login OAuth via Socialite, integra anche Messaging API. Integrazione AT Protocol (Bluesky). Login OAuth e invio post. Login OAuth2 Discord. Integrazione Meta Threads. Login with Amazon. Login OAuth a un'istanza Mastodon. Login OAuth WordPress.com o self-hosted. ## Related topics - [Socialite - Laravel Bluesky](/it/packages/laravel-bluesky/socialite.md) - [Socialite (LINE Login) - LINE SDK for Laravel](/it/packages/laravel-line-sdk/socialite.md) - [Socialite for Discord](/it/packages/socialite-discord.md) - [Confronto tra metodi di autenticazione - Laravel Bluesky](/it/packages/laravel-bluesky/authentication.md) - [Autenticazione OAuth 2.0 - Google Sheets API for Laravel](/it/packages/laravel-google-sheets/oauth.md)