このページは Authlete 2.x 用です。3.0 については クイックスタート(3.0) をご覧ください。
Authlete を用いて「OAuth 2.0 認可フロー」を試す(2.x)
1. アカウントを作成しましょう。
サインアップページ に必要事項を入力し「登録」をクリックします。
2. メールを開きます。
登録完了後に届くメールに、認可フローを試すための手順が書いてあります。
💡 登録完了後、すぐに OAuth 2.0 のフローを試せるよう、以下の設定がすでに完了しています。
- Authlete サービスインスタンス
- デフォルトの OAuth 2.0 認可エンドポイント
- クライアントアプリのサンプル設定
3. 「認可エンドポイント」ボタンをクリックします。
認証・認可を行うためのログインページに遷移します。
💡 「認可エンドポイント」ボタンをクリックすると、Authlete のデフォルト認可エンドポイントに認可リクエスト(インプリシットグラントフロー)を行います。実際には以下の URL です。
https://api.authlete.com/api/auth/authorization/direct/<SERVICE_API_KEY>?response_type=token&client_id=<SAMPLE_APP_CLIENT_ID>4. ログイン情報を入力します
Authlete サービスインスタンスの API キーと API シークレットを用います。
注: API キーと API シークレットはサービス管理者コンソールにログインして確認します。
- メール内のボタンをクリック
- API キーとシークレットを確認
💡 動作確認用に、デフォルト認可エンドポイントは API キーと API シークレットを用いてユーザーを認証します。
5. 「認可」ボタンをクリックします
ブラウザはクライアントのリダイレクションエンドポイントに遷移します。発行されたアクセストークンが表示されます。 また、遷移後の URL のフラグメント部にアクセストークンが含まれています。https://api.authlete.com/api/mock/redirection/<SERVICE_API_KEY>#access_token=SNqzo...&token_type=Bearer&expires_in=86400&scope=
おめでとうございます! Authlete を使ったアクセストークンの発行ができました!
認可コードグラントフローを試す
上記(インプリシットグラントフロー)に続き、認可コードグラントフローを試してみましょう。 1. Web ブラウザーに以下の URL(認可リクエスト)を入力・送信してください。https://api.authlete.com/api/auth/authorization/direct/<SERVICE_API_KEY>?response_type=code&client_id=<SAMPLE_APP_CLIENT_ID>
response_type=code である以外は先の認可リクエストと同一です。<SERVICE_API_KEY> / <SAMPLE_APP_CLIENT_ID> は適宜修正してください。
2. さきほどと同じログインページに遷移します。API キーと API シークレットを入力してください。
3. トークンリクエスト送信ページに遷移します。client_id フィールドに SAMPLE_APP_CLIENT_ID の値を入力し、Submit ボタンをクリックしてください。
4. トークンレスポンス(JSON 形式)の内容が表示されます。"access_token" と "refresh_token" のそれぞれに値が入っていることを確認してください。
認可サーバーを実装する
ここまでのセクションでは、Authlete のデフォルトの認可エンドポイント実装を用いて認可フローを試しました。実環境での Authlete の活用にあたっては、さまざまな方法で、Authlete の Web API を使った認可サーバーを実装することが可能です。 java-oauth-server はオープンソースの認可サーバーであり、Authlete の Web API を使って実装されています。この、Java を使った参照実装は、独自の認可サーバーを構築する際の参考となるものです。同参照実装は Authlete をバックエンドとして用いています。 その結果、下記のいくつかのコマンドだけで、認可サーバー(java-oauth-server)のダウンロードから実行までが完了します。次のステップ
- Authlete のセットアップ(2.x): サービス・クライアント管理の概要
- JavaでのAuthlete API入門(2.x): java-oauth-server を動かしてフローをテストする手順
- API リファレンス — Authlete 2.x Web API