クライアント認証の設定

​

はじめに

​

Authlete におけるクライアント認証のしくみ

​

事前設定する情報

• Authlete サービス

• クライアント

​

実行時に得られる情報

​

設定例

​

サービスの設定

1. Authlete 管理コンソールにログインします。
2. 組織名をクリックし、対象のサービス (この場合 “Service A”) を選択します。
3. サービス設定 > エンドポイント > トークン を開きます。
4. サポートするクライアント認証方式で CLIENT_SECRET_BASIC のチェックボックスを選択します。
5. 変更を保存をクリックして反映します。

​

クライアントの設定

1. クライアント設定 > エンドポイント > トークン > 一般 を開きます。
2. クライアント認証方式のドロップダウンから CLIENT_SECRET_BASIC を選択します。
3. 変更を保存をクリックして反映します。

​

クライアント ID とクライアントシークレット

1. Authlete 管理コンソールにログインします。
2. 組織名をクリックし、対象のサービスを選択します。
3. クライアント設定 > 基本設定 > 一般 を開きます。

• ステップ 1

POST /token HTTP/1.1
Authorization: Basic base64(1257...: gTyu...)
Host: as.example.com
...
grant_type=authorization_code&
code=...&
redirect_uri=...

• ステップ 2

• ステップ 3

POST /api/auth/token HTTP/1.1
Host: api.authlete.com
...

{
  "clientId":"1257...",
  "clientSecret":"gTyu...",
  "parameters":
    "grant_type=authorization_code
     &code=...&redirect_uri=..."}

• ステップ 4

​

主なクライアント認証方式の設定のポイント

​

CLIENT_SECRET_BASIC

• Authlete の設定
  • このクライアント認証方式に必要となるクライアント ID とクライアントシークレットは、Authlete が自動的に生成・管理するため、Authlete への追加設定は不要です。
• 認可サーバーの設定
  • Authorization ヘッダーからこれらの情報を抽出し、/auth/token API へのリクエストのパラメーターとして別途指定します。

​

CLIENT_SECRET_POST

• Authlete の設定
  • CLIENT_SECRET_BASIC の場合と同じく、Authlete への追加設定は不要です。
• 認可サーバーの設定
  • クライアント ID とクライアントシークレットがトークンリクエスト自体に含まれるため、これらの情報に関する処理は不要です。

​

 CLIENT_SECRET_JWT

• Authlete の設定
  • クライアントシークレットは Authlete が自動的に生成・管理しますが、別途新たに指定する必要がある Authlete のクライアント情報として、JWT アサーションの「アサーション署名アルゴリズム」があります。
• 認可サーバーの設定
  • JWT アサーションがトークンリクエスト自体に含まれるため、これらの情報に関する処理は不要です。

​

PRIVATE_KEY_JWT

• Authlete の設定
  • Authlete のクライアント情報として、クライアントが送信する JWT の「アサーション署名アルゴリズム」を指定し、またクライアントの公開鍵を事前に登録する必要があります。
• 認可サーバーの設定
  • JWT アサーションがトークンリクエスト自体に含まれるため、これらの情報に関する処理は不要です。

​

TLS_CLIENT_AUTH

• Authlete の設定
  • Authlete のクライアント情報として、クライアント証明書の「サブジェクト名」を事前に登録する必要があります。
• 認可サーバーの設定
  • 相互 TLS 接続からクライアント証明書を抽出し、/auth/token API へのリクエストのパラメーターとして別途指定します。