Auth0を使ってSSOの流れを確認してみた #PHP

はじめに

この記事はOPENLOGI Advent Calendar 2022の9日目の記事です。

業務と全く関係ないのですが、今回は個人的に気になっていたSSOの具体的な流れについて手元で環境を作り処理を追っていきたいと思います。
Auth0やSSO、またその他利用しているツール類の説明は、詳しく解説されてる記事がありますので割愛させていただきます。

概要

SSOの分かりやすいフロー図がAuth0 blogにありますので、Auth0を使ったSSOの１〜１３までの流れを確認します。

実際に利用する際は意識する必要はない項目もありそうですが、今回はざっと見ていければと思います。

確認準備

1. ローカル環境作成

SSOの確認なのでまずは２環境作っていきます。

作成は以下のコマンドをport番号違いで2回叩くだけです。

$ php -S localhost:8888
PHP 8.1.11 Development Server (http://localhost:8888) started

2. 外部からローカル環境へアクセスできるようにする

ngrokを利用します。
service1と2は先ほど立ち上げたローカル環境をポート番号違いで紐づけてます。

$ ngrok start service1 service2
ngrok                                                                                        (Ctrl+C to quit)

Try our new native Go library: https://github.com/ngrok/ngrok-go

Session Status                online
Account                       terumichi1209@gmail.com (Plan: Free)
Version                       3.1.0
Region                        United States (us)
Latency                       -
Web Interface                 http://127.0.0.1:4040
Forwarding                    https://6fef-60-61-127-42.ngrok.io -> http://localhost:8888
Forwarding                    https://c78d-60-61-127-42.ngrok.io -> http://localhost:8889

これで外部からアクセスできる２つのローカル環境が作成できました。

3. Auth0へ生成したドメインを反映する

Auth0管理画面にて、ご自身の環境でアプリを以下のように２つ作成します。

各アプリには生成したURLを設定します。

データベースを利用せず、ソーシャルログインだけの場合はこれでAuth0側は準備完了です。

4. Auth0のアプリ情報を設定する

サービスごとにディレクトリを切っただけのアプリを用意します。

index.php はAuth0クイックスタートのサンプルコードの寄せ集めになります。
ドメインやパス、Auth0のアプリ情報を変えて、２つの index.php に設定します。

<?php
use Steampixel\Route;

const ROUTE_URL_INDEX = 'https://f272-60-61-127-42.ngrok.io/service1';
const ROUTE_URL_LOGIN = ROUTE_URL_INDEX . '/login';
const ROUTE_URL_CALLBACK = ROUTE_URL_INDEX . '/callback';
const ROUTE_URL_LOGOUT = ROUTE_URL_INDEX . '/logout';

require '../vendor/autoload.php';

$auth0 = new \Auth0\SDK\Auth0([
    'domain' => 'Auth0で作成したアプリのdomain',
    'clientId' => 'Auth0で作成したアプリのclientId',
    'clientSecret' => 'Auth0で作成したアプリのclientSecret',
    'cookieSecret' => 'test',
]);

Route::add('/service1', function() use ($auth0) {
    $session = $auth0->getCredentials();
    if ($session === null) {
        echo '<p>Please <a href="' . ROUTE_URL_LOGIN . '">log in</a>.</p>';
        return;
    }

    echo '<pre>';
    print_r($session->user);
    echo '</pre>';

    echo '<p>You can now <a href="' . ROUTE_URL_LOGOUT . '">log out</a>.</p>';
});

Route::add('/service1/login', function() use ($auth0) {
    $auth0->clear();
    header("Location: " . $auth0->login(ROUTE_URL_CALLBACK));
});

Route::add('/service1/callback', function() use ($auth0) {
    $auth0->exchange(ROUTE_URL_CALLBACK);
    header("Location: " . ROUTE_URL_INDEX);
});

Route::add('/service1/logout', function() use ($auth0) {
    header("Location: " . $auth0->logout(ROUTE_URL_INDEX));
});

Route::run('/');