Evan Sims による
このガイドでは、Auth0 PHP SDK を使用して、PHP バックエンド API に Auth0 を統合する方法を説明します。アカウント用に設定された例を使ってこのクイックスタートを進められるよう、ログインしたうえで読み進めることをお勧めします。
Auth0 Dashboard の APIs セクションで、Create API をクリックします。API の名前と識別子を入力します。たとえば https://quickstarts/api です。この識別子は、後でアクセストークンの検証を設定する際に audience として使用します。Signing Algorithm は RS256 のままにします。
デフォルトでは、API はトークンの署名アルゴリズムとして RS256 を使用します。RS256 は秘密鍵と公開鍵のキーペアを使用するため、Auth0 アカウントの公開鍵を使ってトークンを検証します。公開鍵は JSON Web Key Set (JWKS) 形式で提供されており、こちら からアクセスできます。
権限を使用すると、特定のアクセストークンを使ってユーザーに代わりリソースにどのようにアクセスできるかを定義できます。たとえば、ユーザーが manager アクセスレベルの場合は messages リソースへの読み取りアクセスを許可し、administrator アクセスレベルの場合はそのリソースへの書き込みアクセスを許可するように設定できます。
許可する権限は、Auth0 Dashboard の APIs セクションにある Permissions ビューで定義できます。
この例では、read:messages スコープを使用します。
HTTPクライアントとメッセージファクトリーのインストール
composer require guzzlehttp/guzzle guzzlehttp/psr7 http-interop/http-factory-guzzle
composer require auth0/auth0-php
vendor フォルダーが作成され、Auth0 PHP SDK の使用に必要な依存関係がすべてダウンロードされます。また、サンプルで使用する vendor/autoload.php ファイルも作成されます。このファイルは、アプリケーションの動作に必要なすべてのクラスを読み込むために使用されます。SDK を動作させるには、このオートロードファイルをプロジェクト内で require することが重要です。
まず、サンプルアプリケーションの設定を保存するため、プロジェクトディレクトリのルートに .env ファイルを作成し、環境変数を設定します。
PHP は .env ファイルを単体では読み取れないため、それを補うライブラリをインストールします。ここではサンプルアプリケーションの都合上、特定のライブラリを使用しますが、実際のアプリケーションでは任意の dotenv ローダーを使用できます。プロジェクトディレクトリで、次のシェルコマンドを実行してライブラリをインストールします。
composer require vlucas/phpdotenv
index.php を作成し、サンプルアプリケーション向けにAuth0 PHP SDKのインスタンスを設定しましょう。
<?php
// Composer AutoloaderをインポートしてSDKクラスを利用可能にします:
require 'vendor/autoload.php';
// .envファイルから環境変数を読み込みます:
(Dotenv\Dotenv::createImmutable(__DIR__))->load();
// Auth0クラスを設定でインスタンス化します:
$auth0 = new \Auth0\SDK\Auth0([
'strategy' => \Auth0\SDK\Configuration\SdkConfiguration::STRATEGY_API,
'domain' => $_ENV['AUTH0_DOMAIN'],
'clientId' => $_ENV['AUTH0_CLIENT_ID'],
'clientSecret' => $_ENV['AUTH0_CLIENT_SECRET'],
'audience' => ($_ENV['AUTH0_AUDIENCE'] ?? null) !== null ? [trim($_ENV['AUTH0_AUDIENCE'])] : null,
]);
?token パラメーター、または HTTP_AUTHORIZATION か Authorization ヘッダーを確認します。
// 👆 上記の手順から続きます。index.php ファイルに追記してください。
$jwt = $_GET['token'] ?? $_SERVER['HTTP_AUTHORIZATION'] ?? $_SERVER['Authorization'] ?? null;
// 👆 上記の手順から続きます。index.php ファイルに追記してください。
// トークンが存在する場合は処理します。
if ($jwt !== null) {
// トークン文字列の前後の空白を除去します。
$jwt = trim($jwt);
// Authorization ヘッダーに 'Bearer ' プレフィックスが含まれている場合は削除します。
if (substr($jwt, 0, 7) === 'Bearer ') {
$jwt = substr($jwt, 7);
}
// トークンのデコードを試みます:
try {
$token = $auth0->decode($jwt, null, null, null, null, null, null, \Auth0\SDK\Token::TYPE_TOKEN);
define('ENDPOINT_AUTHORIZED', true);
} catch (\Auth0\SDK\Exception\InvalidTokenException $exception) {
// トークンが無効でした。Auth0 SDK のエラーメッセージを表示します。
// 実際のアプリケーションでは、カスタムエラーを表示するのが望ましいでしょう。
die($exception->getMessage());
}
}
// 👆 上記の手順から続きます。index.phpファイルに追記してください。
// リクエストは認可されていますか？
if (defined('ENDPOINT_AUTHORIZED')) {
// JSONレスポンスを返します：
echo json_encode([
'authorized' => true,
'data' => $token->toArray()
], JSON_PRETTY_PRINT);
exit;
}
// HTTP 401 Unauthorizedステータスを発行します：
http_response_code(401);
// JSONレスポンスを返します：
echo json_encode([
'authorized' => false,
'error' => [
'message' => 'You are NOT authorized to be here!'
]
], JSON_PRETTY_PRINT);
composer require symfony/cache
// ✋ SDKがキャッシュを使用できるよう、上記の手順で追加したトークン処理の前にこれを挿入してください。
$tokenCache = new \Symfony\Component\Cache\Adapter\FilesystemAdapter();
$auth0->configuration()->setTokenCache($tokenCache);
Authenticate
Manage Users
Customize
Auth0 AI
Platform
