Vergelijking van authenticatiemethodes - Laravel Bluesky

Overzicht

Laravel Bluesky ondersteunt twee authenticatiemethodes. Na authenticatie zijn de API-aanroepen voor beide methodes identiek.

Onderwerp	App Password	OAuth
Interne klassen	`LegacyAgent` / `LegacySession`	`OAuthAgent` / `OAuthSession`
Entrypoint	`Bluesky::login()`	`Bluesky::withToken(OAuthSession)`
Private key	Niet nodig	`BLUESKY_OAUTH_PRIVATE_KEY` vereist
Autorisatie door de gebruiker	Niet nodig	Vereist (goedkeuring in de browser)
Uitvoering op de achtergrond	✅ Uitstekend geschikt	✅ Mogelijk (refresh_token opslaan)
Sessiesleutels	`accessJwt` / `refreshJwt`	`access_token` / `refresh_token`
Deprecatie gepland	Nee	—
Belangrijkste toepassing	Automatisch posten, notificaties, batchverwerking	Handelen namens gebruikers, Socialite-integratie

De naam LegacyAgent verwijst naar “de authenticatiemethode van vóór OAuth”, maar App Password zelf wordt niet uitgefaseerd. Voor scenario’s zonder gebruikersinteractie, zoals notificaties en automatisch posten, is App Password eenvoudiger en beter geschikt.

Architectuur

BlueskyManager is de implementatie achter de Bluesky Facade. Je stelt een agent in via login() of withToken(), en de API-aanroepen daarna gebruiken bij beide authenticatiemethodes dezelfde methodes.

App Password (LegacyAgent)

Authenticatieflow

Bluesky::login()

Je hoeft alleen het App Password in .env in te stellen en login() aan te roepen.

BLUESKY_IDENTIFIER=your-handle.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx

use Revolution\Bluesky\Facades\Bluesky;

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post('Hello Bluesky');

LegacySession hergebruiken

Elke keer login() aanroepen betekent elke keer een API-request. Het is efficiënter om de sessie te cachen en te hergebruiken.

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Session\LegacySession;

// Eerste keer inloggen en de sessie opslaan
Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
);
cache()->put('bluesky_session', Bluesky::agent()->session()->toArray(), now()->addDay());

// Daarna herstellen uit de cache
$session = LegacySession::create(cache('bluesky_session', []));
Bluesky::withToken($session);

// Vernieuwen als het access token verlopen is
if (! Bluesky::check()) {
    Bluesky::refreshSession();
}

$response = Bluesky::post('Hello from cached session');

Belangrijkste sleutels van LegacySession

Sleutel	Inhoud	Methode
`accessJwt`	Access token	`token()`
`refreshJwt`	Refresh token	`refresh()`
`did`	Bluesky DID	`did()`
`handle`	Handle	`handle()`
`email`	E-mailadres	`email()`
`active`	Of het account actief is	`active()`

Geschikte use cases

Automatisch posten via background jobs en queue-verwerking
Notificaties via een Laravel Notification-kanaal
Batchverwerking en scheduling
Posten met het account van de applicatie zelf

OAuth (OAuthAgent)

Authenticatieflow

Bluesky::withToken()

Je geeft de via Socialite verkregen OAuthSession door aan withToken().

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Session\OAuthSession;

// Herstellen uit de Laravel-sessie (webrequest)
$session = OAuthSession::create(session('bluesky_session'));
$timeline = Bluesky::withToken($session)->getTimeline();

Ook in background jobs of de console kun je een OAuthSession samenstellen uit waarden die in de database zijn opgeslagen.

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Session\OAuthSession;

$session = OAuthSession::create([
    'did'           => $user->did,
    'refresh_token' => $user->refresh_token,
    // Voor accounts buiten bsky.social geef je ook iss op
    // 'iss'        => $user->iss,
]);

$response = Bluesky::withToken($session)
                   ->refreshSession()
                   ->post('Hello from OAuth');

Belangrijkste sleutels van OAuthSession

Sleutel	Inhoud	Methode
`access_token`	Access token	`token()`
`refresh_token`	Refresh token (slechts één keer bruikbaar)	`refresh()`
`did` / `sub`	Bluesky DID	`did()`
`iss`	URL van de autorisatieserver	`issuer()`
`profile.handle`	Handle	`handle()`
`profile.displayName`	Weergavenaam	`displayName()`

Een OAuth refresh_token is maar één keer bruikbaar. Gebruik het OAuthSessionUpdated-event en werk na een tokenvernieuwing altijd de database bij. Zie Socialite voor de details.

Geschikte use cases

Gebruikerslogin via Socialite
API-aanroepen namens een gebruiker
Situaties waarin je per gebruiker met een ander account moet werken

API-aanroepen na authenticatie zijn identiek

Bij beide authenticatiemethodes gebruik je na withToken() dezelfde API-methodes.

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Session\LegacySession;
use Revolution\Bluesky\Session\OAuthSession;

// App Password
Bluesky::login(config('bluesky.identifier'), config('bluesky.password'));

// Of OAuth
$session = OAuthSession::create(session('bluesky_session'));
Bluesky::withToken($session);

// ↓ De API-aanroepen hierna zijn volledig identiek ↓

Bluesky::post('Hello Bluesky');
Bluesky::getTimeline();
Bluesky::getProfile();
Bluesky::searchPosts(q: '#laravel');

BlueskyManager gebruikt intern een LegacyAgent of OAuthAgent, maar dat heeft geen invloed op de aanroepende code.

Welke moet je kiezen?

Situatie	Aanbevolen
Automatisch posten, notificaties, batches	App Password
Gebruikersloginfunctionaliteit	OAuth
Alleen background jobs	App Password
Handelen namens gebruikers nodig	OAuth
Eenvoud in beheer voorop	App Password
Nadruk op security en rechtenbeheer	OAuth

Bij twijfel is indelen op doel het duidelijkst: “de app handelt zelf” betekent App Password, “de gebruiker handelt” betekent OAuth. Je kunt beide ook combineren; een veelvoorkomende opzet is App Password voor notificaties en OAuth voor gebruikerslogin.

Referenties

Basic client — API-operaties na authenticatie
Socialite — details van de OAuth-flow
Notificatiekanaal — notificaties met App Password / OAuth
Source: invokable/laravel-bluesky

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Vergelijking van authenticatiemethodes - Laravel Bluesky

Overzicht

Architectuur

App Password (LegacyAgent)

Authenticatieflow

Bluesky::login()

LegacySession hergebruiken

Belangrijkste sleutels van LegacySession

Geschikte use cases

OAuth (OAuthAgent)

Authenticatieflow

Bluesky::withToken()

Belangrijkste sleutels van OAuthSession

Geschikte use cases

API-aanroepen na authenticatie zijn identiek

Welke moet je kiezen?

Referenties

​Overzicht

​Architectuur

​App Password (LegacyAgent)

​Authenticatieflow

​Bluesky::login()

​LegacySession hergebruiken

​Belangrijkste sleutels van LegacySession

​Geschikte use cases

​OAuth (OAuthAgent)

​Authenticatieflow

​Bluesky::withToken()

​Belangrijkste sleutels van OAuthSession

​Geschikte use cases

​API-aanroepen na authenticatie zijn identiek

​Welke moet je kiezen?

​Referenties

Overzicht

Architectuur

App Password (LegacyAgent)

Authenticatieflow

Bluesky::login()

LegacySession hergebruiken

Belangrijkste sleutels van LegacySession

Geschikte use cases

OAuth (OAuthAgent)

Authenticatieflow

Bluesky::withToken()

Belangrijkste sleutels van OAuthSession

Geschikte use cases

API-aanroepen na authenticatie zijn identiek

Welke moet je kiezen?

Referenties