Konto PLVTuber może służyć do logowania w innych aplikacjach: na stronach, w botach czy programach na komputer. Logowanie odbywa się na login.plvtuber.pl, a aplikacja dostaje tylko te dane, na które użytkownik się zgodzi.
login.plvtuber.pl to standardowy dostawca OpenID Connect, więc wystarczy gotowa, sprawdzona biblioteka OIDC (np. openid-client dla Node.js) zamiast własnej implementacji.
| Issuer | https://login.plvtuber.pl |
| Discovery | https://login.plvtuber.pl/.well-known/openid-configuration |
Wymagany jest przepływ authorization code z PKCE (S256), także dla aplikacji z sekretem. Przepływ implicit i logowanie hasłem przez aplikację nie są dostępne.
| Aplikacja | Sekret | Redirect URI |
|---|---|---|
| Strona z backendem | tak (client_secret_basic) | dokładny adres https://, wszystkie na jednej domenie |
| Program na komputer | nigdy | http://127.0.0.1/callback, port dowolny przy uruchomieniu |
| Aplikacja tylko w przeglądarce | brak | dokładny adres https:// (lepiej mieć backend) |
Programy na komputer otwierają logowanie w systemowej przeglądarce (nie we wbudowanym oknie), nasłuchują na losowym porcie loopback i trzymają refresh token w systemowym magazynie haseł. Użytkownik zawsze potwierdza takie logowanie jednym kliknięciem.
| Zakres | Co dostaje aplikacja |
|---|---|
openid | sub: identyfikator użytkownika, inny dla każdej aplikacji |
profile | name, picture, updated_at |
email | email, email_verified: tylko gdy PLVTuber włączy to dla aplikacji i tylko zweryfikowane adresy |
vtuber | vtuber: zatwierdzony profil VTubera użytkownika albo null |
vtuber.managed | managed_vtubers: zatwierdzone profile, którymi użytkownik zarządza |
offline_access | refresh token (razem z prompt=consent) |
Dane są dostępne w userinfo (/me). Jeśli usługa danych PLVTuber chwilowo nie odpowiada, vtuber ma wartość null, a _claim_errors wymienia zakresy, których nie udało się wypełnić. Wtedy warto spróbować później, zamiast uznawać użytkownika za nie-VTubera.
import * as client from 'openid-client';
const config = await client.discovery(new URL('https://login.plvtuber.pl'), CLIENT_ID, CLIENT_SECRET);
// 1. Przekierowanie do logowania
const verifier = client.randomPKCECodeVerifier();
const state = client.randomState();
const url = client.buildAuthorizationUrl(config, {
redirect_uri: 'https://twoja-aplikacja.pl/callback',
scope: 'openid profile vtuber',
code_challenge: await client.calculatePKCECodeChallenge(verifier),
code_challenge_method: 'S256',
state,
});
// 2. Powrót na redirect_uri
const tokens = await client.authorizationCodeGrant(config, currentUrl, {
pkceCodeVerifier: verifier,
expectedState: state,
});
const me = await client.fetchUserInfo(config, tokens.access_token, tokens.claims().sub);/me.invalid_grant.access_denied: użytkownik wybrał "Anuluj".login_required / consent_required: wysłano prompt=none, a potrzebna jest interakcja użytkownika.end_session_endpoint. Strony z adresem back-channel logout dostają informację, gdy użytkownik wyloguje się gdziekolwiek.Aplikacje rejestrują na razie administratorzy PLVTuber. Do zgłoszenia przydadzą się:
email,Zgłoszenia prosimy wysyłać na [email protected] albo na naszym Discordzie. Sekret aplikacji przekazujemy prywatnie i tylko raz.