OAuth 2.0の鍵！リダイレクトURIの重要性と設定方法

[OAuth 2.0](https://qiita.com/takuya77088/items/ef97763b3109a9671390)におけるリダイレクトURIは、認可プロセスが完了した後に、認可サーバーがユーザーをリダイレクトする先のURIを指します。リダイレクトURIは、クライアントアプリケーションのセキュリティと正常な動作にとって重要な役割を果たします。本文では、リダイレクトURIの基本情報を完全に解説した上、その動作の原理をも探りたいと思います。

## リダイレクトURIとは？
OAuth 2.0におけるリダイレクトURIは、認可プロセスが完了した後に、認可サーバーがユーザーをリダイレクトする先のURIを指します。リダイレクトURIは、クライアントアプリケーションが認可リクエストを開始する際に指定されます。

### リダイレクトURIの役割
それでは、リダイレクトURIはOAuth 2.0のワークフローの中で、どのような役割を果たしていますか？次は、リダイレクトURIの主な役割を皆さんに紹介します。

- **セキュリティ**：リダイレクトURIは事前に登録されており、認可サーバーはリダイレクト先が正当なアプリケーションであることを確認できます。これにより、認可コードや認証情報が不正なアプリケーションに渡されることを防ぎます

- **認可コードの受け渡し**：認可サーバーは、認可プロセスが完了した後、認可コードをクエリパラメータとしてリダイレクトURIに付加してユーザーをリダイレクトします。クライアントアプリケーションは、このリダイレクトを受け取ることで認可コードを取得できます

- **状態管理**：クライアントアプリケーションは、認可リクエスト時に状態パラメータ（state）を指定することができます。認可サーバーは、リダイレクト時にこの状態パラメータを含めることで、リクエストとコールバックの対応関係を維持できます

リダイレクトURIは、クライアントアプリケーションのセキュリティと正常な動作にとって重要な役割を果たします。適切に設定されたリダイレクトURIにより、OAuth 2.0の認可フローを安全に実装することができます。

## リダイレクトURIの動作原理
それでは、リダイレクトURIはどのように動作していますか？OAuth 2.0のリダイレクトURIは、以下のように動作します：

- 1.クライアントアプリケーションは、認可リクエストを開始する際に、認可サーバーにリクエストを送信します。このリクエストには、`client_id`、`redirect_uri`、`response_type`、`scope` などのパラメータが含まれます
- 2.認可サーバーは、リクエストを受信し、redirect_uriが事前に登録されたものと一致するかを確認します。一致しない場合、エラーを返します
- 3.ユーザーは、認可サーバーにリダイレクトされ、ログインおよび同意画面が表示されます。ユーザーは、クライアントアプリケーションに対して要求された権限を確認し、許可するかどうかを選択します
- 4.ユーザーが権限を許可すると、認可サーバーは認可コードを生成し、redirect_uriにクエリパラメータとして付加してユーザーをリダイレクトします。例えば、`https://client.example.com/callback?` `code=AUTH_CODE_HERE&state=STATE_VALUE_HERE`  のようなURLになります
- 5.クライアントアプリケーションは、リダイレクトを受信し、URLから認可コードを抽出します。また、stateパラメータがリクエスト時に指定したものと一致することを確認します
- 6.クライアントアプリケーションは、認可コードを使用してトークンエンドポイントにリクエストを送信し、アクセストークンを取得します
- 7.トークンエンドポイントは、認可コードとclient_idおよびclient_secretを検証し、アクセストークンを発行します
- 8.クライアントアプリケーションは、アクセストークンを使用して、保護されたリソースにアクセスできるようになります


このように、リダイレクトURIはOAuth 2.0の認可フローにおいて、認可サーバーとクライアントアプリケーション間の通信を安全に行うために重要な役割を果たしています。

## リダイレクトURIをどのように指定する？

OAuth 2.0の仕様では、クライアントアプリケーションが認可サーバーに登録したリダイレクトURIと、認可リクエスト時に指定するリダイレクトURIが一致していれば、アクセストークンを取得することができます。つまり、クライアントアプリケーションが任意のURIを登録し、そのURIをリクエスト時に指定すれば、たとえそのURIが実在しなくても、アクセストークンを取得できるということになります。

ただし、これはセキュリティ上のベストプラクティスではありません。クライアントアプリケーションは、適切なリダイレクトURIを設定し、信頼できるドメインのみを許可するようにすべきです。また、認可サーバーも、登録されたリダイレクトURIのホワイトリストを維持し、不正なURIが登録されていないか定期的にチェックすることが推奨されます。

さらに、クライアントアプリケーションは、リダイレクト時に受け取った認可コードやアクセストークンを適切に処理し、安全に保存する必要があります。リダイレクトURIが実在しない場合や、適切にハンドリングされていない場合、認可コードやアクセストークンが漏洩するリスクがあります。

したがって、OAuth 2.0の仕様に準拠しつつ、セキュリティ上のベストプラクティスに従ってリダイレクトURIを設定・管理することが重要です。

## OAuth 2.0認証を行い、アクセストークンをAPIに自動追加
非常に使いやすいAPI管理ツールの[Apidog](http://www.apidog.com/jp/?utm_source=opr&utm_medium=a2takuya)はOAuth 2.0という認証に完璧に対応できます。ApidogのOAuth 2.0認証機能を利用して、非常に簡単な手順で、OAuth 2.0のアクセストークンを取得し、API認証を行うことができます。

次の操作ガイドのように、「Auth」タブで、認証方式を選択することで、必要な情報を記入すれば、簡単にトークンを取得することができます。この後、リクエストを送信する度、これらのトークン情報がリクエストに追加されるので、非常に便利です。

- **ステップ⒈**リクエストを送信する際、Apidogで「Auth」タブに切り替えて、認証タイプのドロップダウンリストから「Auth 2.0」を選択します

![apidog-auth-1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3877124/19df2c98-7ea3-b821-02f8-8f87d81a947a.png)

- **ステップ⒉**必要な情報を記入して、「トークンの取得」ボタンをクリックします

![apidog-auth-2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3877124/aacb5438-11bd-b42f-38bb-e86e39b218ff.png)

- **ステップ⒊**記入の情報に問題がなければ、アクセストークンが成功に取得れます。ここで、リクエストを送信する際は、アクセストークンが自動的に追加され、OAuth認証を行うことができます

![apidog-auth-3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3877124/9a81a5e8-2170-1c13-752a-c29e56db8f90.png)

また、ここでトークンの有効期限もちゃんと表示され、必要に応じて、トークンを再度取得したり、トークンを削除したりすることもできるので、非常に便利です。


## まとめ
OAuth 2.0におけるリダイレクトURIは、認可プロセスが完了した後に、認可サーバーがユーザーをリダイレクトする先のURIを指します。リダイレクトURIはセキュリティの確保、認可コードの受け渡しや状態管理などの方面において重要な役割を果たしています。

リダイレクトURIは、認可サーバーとクライアントアプリケーション間の通信を安全に行うために重要な役割を果たしています。クライアントアプリケーションは信頼できるドメインのみを許可するよう適切にリダイレクトURIを設定し、認可サーバーも登録されたURIのホワイトリストを維持する必要があります。

OAuth 2.0認証を簡単に行うためには、API管理ツールの[Apidog](http://www.apidog.com/jp/?utm_source=opr&utm_medium=a2takuya)が非常に便利です。ApidogのOAuth 2.0認証機能を使えば、簡単な操作でアクセストークンを取得し、自動的にAPIリクエストに認証情報を追加できます。有効期限の管理やトークンの再取得も可能です。

**最後まで読んでくださり、ありがとうございました！
この記事を読んで少しでも理解を深めていただければ幸いです！**