できる限り簡単にPHPで「Google OpenID Connect」を使ってみる

OpenIDを理解するにあたってできる限り簡単にPHPで「Google OpenID Connect」を利用するプログラムを作成してみました。
（あくまでも理解する為に作成したプラグラムなので実際に運用する場合はセキュリティーを十分に高める施策が必要です。）

大まかな手順としては、まずGoogleのクライアントIDを取得する必要があります。

「Google OpenID Connect」の為の「クライアントID」の取得方法については下記の記事を参考にしてください。

Googleの「OpenID Connect」を利用する為の「クライアントID」の取得方法

Googleの「OpenID Connect」を利用するにあたり、まずは「Google Developers Console」より「クラ...

「クライアントID」を取得したら実際にPHPに実装して動作させる事が可能です。

大まかな仕組みは下記の図のようになります。

この図のServerがPHPのプログラムを実装するサーバーです。

図のオレンジ色のPHPが作成対象になります。

index.php	ボタン（リンク）を表示するだけのページ
auth.php	各種パラメタを設定してGoogleにリダイレクトするプログラム
callback.php	Googleの認証が完了した際にコールバックされるプログラムコールバックされた情報を元に詳細情報を取得処理も実行 ※クライアントIDを取得する際に設定した「設定した認証済みのリダイレクトURI」に対応するファイル名（ファイルパス）にする必要があります。必要があればファイル名（ファイルパス）を修正するかGoogle Developers Consoleにて「設定した認証済みのリダイレクトURI」を設定（修正）して下さい。

それでは、各種コードを紹介していきます。

index.php

<a href="./auth.php">google openid connect login</a>

1	<a href="./auth.php">google openid connect login</a>

はい、もはやプログラムではありませんね。（汗

「google openid connect login」というリンクが表示されるだけのページです。

続いてこのリンクから呼び出される「auth.php」のコードです。

auth.php

<?PHP
//**************
// 各種値の設定
//**************
$url           = "https://accounts.google.com/o/oauth2/auth";

$client_id     = "[取得したクライアントID]";
$redirect_uri  = "[設定した認証済みのリダイレクトURI]";

//----------------
// パラメタの設定
//----------------
$query  = "";
$query .= "client_id="     . urlencode( $client_id ) . "&";
$query .= "scope="         . urlencode( "openid email" ) . "&";
$query .= "response_type=" . urlencode( "code" ) . "&";
$query .= "redirect_uri="  . urlencode( $redirect_uri ) . "&";

$location = $url . "?" . $query;

//--------------
//リダイレクト
//--------------
header("Location: {$location}");
?>

<?PHP

//**************

// 各種値の設定

//**************

$url = "https://accounts.google.com/o/oauth2/auth";

$client_id = "[取得したクライアントID]";

$redirect_uri = "[設定した認証済みのリダイレクトURI]";

//----------------

// パラメタの設定

//----------------

$query = "";

$query .= "client_id=" . urlencode( $client_id ) . "&";

$query .= "scope=" . urlencode( "openid email" ) . "&";

$query .= "response_type=" . urlencode( "code" ) . "&";

$query .= "redirect_uri=" . urlencode( $redirect_uri ) . "&";

$location = $url . "?" . $query;

//--------------

//リダイレクト

//--------------

header("Location: {$location}");

こちらもさほど難しいコードではありません。

先に取得した「クライアントID」と設定した「コールバックURL」を指定してGoogleのOAuthにリダイレクトするだけです。

そして最後にGoogleから実際に対象のデータを取得するコードです。

callback.php

<?PHP
//**************
// 各種値の設定
//**************
$url           = "https://accounts.google.com/o/oauth2/token";
$client_id     = "[取得したクライアントID]";
$client_secret = "[取得したクライアント シークレット]";
$redirect_uri  = "[設定した認証済みのリダイレクトURI]";

//----------------------------------------
// POSTパラメータの作成
//  コールバックの戻り値はGETで取得できる
//----------------------------------------
$query  = "";
$query .= "code="          . urlencode( $_GET["code"] ) . "&";
$query .= "client_id="     . urlencode( $client_id ) . "&";
$query .= "client_secret=" . urlencode( $client_secret ) . "&";
$query .= "redirect_uri="  . urlencode( $redirect_uri ) . "&";
$query .= "grant_type="    . urlencode( "authorization_code" );

//--------------------
// HTTPヘッダーの設定
//--------------------
$header = array(
	"Content-Type: application/x-www-form-urlencoded",
	"Content-Length: ".strlen($query)
);

//--------------------------------
// コンテキスト（各種情報）の設定
//--------------------------------
$context = array(
	"http" => array(
		"method"  => "POST",
		"header"  => implode("\r\n", $header),
		"content" => $query
	)
);

//---------------------
// id token を取得する
//---------------------
$res_json = file_get_contents( $url, false, stream_context_create($context) );

//----------------------------------
// 取得するデータを展開して表示する
//----------------------------------

//取得したjsonデータをオブジェクト化
$res = json_decode($res_json);

//id_token(JWT)を分解
$val = explode(".", $res->id_token);

//2番目がデータ部分なのでbase64でデコード
$data_json = base64_decode($val[1]);

//bsae64でデコードしたjsonをオブジェクト化
$data = json_decode($data_json);

//取得したデータを表示
print( "[sub]:["            . $data->sub . "][対象ユーザーの識別子]<br />\n" );
print( "[email]:["          . $data->email . "][email]<br />\n" );
print( "[email_verified]:[" . $data->email_verified . "][emailが認証済みかどうか]<br />\n" );
?>

<?PHP

//**************

// 各種値の設定

//**************

$url = "https://accounts.google.com/o/oauth2/token";

$client_id = "[取得したクライアントID]";

$client_secret = "[取得したクライアントシークレット]";

$redirect_uri = "[設定した認証済みのリダイレクトURI]";

//----------------------------------------

// POSTパラメータの作成

// コールバックの戻り値はGETで取得できる

//----------------------------------------

$query = "";

$query .= "code=" . urlencode( $_GET["code"] ) . "&";

$query .= "client_id=" . urlencode( $client_id ) . "&";

$query .= "client_secret=" . urlencode( $client_secret ) . "&";

$query .= "redirect_uri=" . urlencode( $redirect_uri ) . "&";

$query .= "grant_type=" . urlencode( "authorization_code" );

//--------------------

// HTTPヘッダーの設定

//--------------------

$header = array(

"Content-Type: application/x-www-form-urlencoded",

"Content-Length: ".strlen($query)

);

//--------------------------------

// コンテキスト（各種情報）の設定

//--------------------------------

$context = array(

"http" => array(

"method" => "POST",

"header" => implode("\r\n", $header),

"content" => $query

)

);

//---------------------

// id token を取得する

//---------------------

$res_json = file_get_contents( $url, false, stream_context_create($context) );

//----------------------------------

// 取得するデータを展開して表示する

//----------------------------------

//取得したjsonデータをオブジェクト化

$res = json_decode($res_json);

//id_token(JWT)を分解

$val = explode(".", $res->id_token);

//2番目がデータ部分なのでbase64でデコード

$data_json = base64_decode($val[1]);

//bsae64でデコードしたjsonをオブジェクト化

$data = json_decode($data_json);

//取得したデータを表示

print( "[sub]:[" . $data->sub . "][対象ユーザーの識別子]<br />\n" );

print( "[email]:[" . $data->email . "][email]<br />\n" );

print( "[email_verified]:[" . $data->email_verified . "][emailが認証済みかどうか]<br />\n" );

最後のプログラムについては途中でgoogleに処理を投げたりして難しくなっていますが、プログラムのはじめの方の「クライアントID」「クライアントシークレット」「コールバックURL」を設定するだけで対象のユーザの情報が取得できます。

この中でも「sub」というパラメータがユーザーを特定することのできる値なので以後の認証はこれを元に構築できるかと思います。

プログラム一式
google_openid_connect.zip

【参考にしたサイト】