Accedi con SimosNap

Dati necessari

Indica un nome riconoscibile, il sito web dell’applicazione, la Redirect URI e i permessi che l’applicazione potrà richiedere agli utenti.

Nome applicazione: ChatItaly
Sito web: https://example.com
Redirect URI: https://example.com/oauth/callback.php
Scope disponibili: openid profile irc

URL di autorizzazione

Questa è la URL verso cui reindirizzare l’utente quando preme il pulsante Accedi con SimosNap.

https://www.simosnap.org/rest/service.php/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=https%3A%2F%2Fexample.com%2Foauth%2Fcallback.php&scope=openid%20profile%20irc&state=RANDOM_STATE

Pulsante di esempio

Il pulsante può essere semplice: l’importante è costruire la URL lato server e usare uno state casuale per ogni tentativo di login.

<a href="https://www.simosnap.org/rest/service.php/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=https%3A%2F%2Fexample.com%2Foauth%2Fcallback.php&scope=openid%20profile%20irc&state=RANDOM_STATE">
    Accedi con SimosNap
</a>

Autorizzazione utente

Avvia il login OAuth e mostra il consenso all’utente.

Token endpoint

Scambia l’authorization code con un access token. Questa chiamata deve essere fatta lato server, mai dal browser dell’utente.

grant_type=authorization_code
client_id=CLIENT_ID
client_secret=CLIENT_SECRET
code=AUTHORIZATION_CODE
redirect_uri=https://example.com/oauth/callback.php

{
  "access_token": "ACCESS_TOKEN",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "REFRESH_TOKEN"
}

UserInfo endpoint

Restituisce le informazioni utente autorizzate dagli scope richiesti.

Authorization: Bearer ACCESS_TOKEN

{
  "sub": "hash-stabile-openid",
  "uid": 12345,
  "nickname": "Simos",
  "preferred_username": "Simos",
  "profile_url": "https://www.simosnap.org/user/stats:Simos/profile#info",
  "avatar": "avatar.png",
  "avatar_url": "https://www.simosnap.org/uploads/avatars/default/avatar.png",
  "aliases": ["Simos", "H7-25", "sixxs", "simos|out"],
  "irc_account": "Simos",
  "is_oper": true
}

Callback OAuth

Il Client Secret deve restare lato server. Non inserirlo mai in JavaScript o in pagine pubbliche.

<?php

session_start();

$clientId = 'CLIENT_ID';
$clientSecret = 'CLIENT_SECRET';
$redirectUri = 'https://example.com/oauth/callback.php';

if (!isset($_GET['code'])) {
    exit('Authorization code mancante');
}

if (!isset($_GET['state']) || $_GET['state'] !== ($_SESSION['oauth_state'] ?? null)) {
    exit('State non valido');
}

$tokenContext = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query([
            'grant_type' => 'authorization_code',
            'client_id' => $clientId,
            'client_secret' => $clientSecret,
            'code' => $_GET['code'],
            'redirect_uri' => $redirectUri
        ])
    ]
]);

$tokenResponse = file_get_contents('https://www.simosnap.org/rest/service.php/oauth/token', false, $tokenContext);
$tokenData = json_decode($tokenResponse, true);

if (empty($tokenData['access_token'])) {
    exit('Access token non ricevuto');
}

$userContext = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => 'Authorization: Bearer ' . $tokenData['access_token']
    ]
]);

$userResponse = file_get_contents('https://www.simosnap.org/rest/service.php/oauth/userinfo', false, $userContext);
$userInfo = json_decode($userResponse, true);

$_SESSION['user_uid'] = $userInfo['uid'];
$_SESSION['user_nickname'] = $userInfo['nickname'];

header('Location: /');
exit;