旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。
コンシューマによる認証
この例では、 Key Authenticationプラグイン を有効にして、キー認証を使用するコンシューマを作成します。API Key Authenticationは、API認証を実行する最も一般的な方法の1つであり、必要に応じてアクセスキーを作成および削除するように実装できます。
Admin APIを使用する場合は、Kong Gateway使用開始ガイドを参照してください。
Key Authenticationプラグインの設定
Kong Managerの ワークスペース タブ:
-
デフォルトの ワークスペースを開きます。
-
メニューで、 ルート を開き、作成した モック ルートを選択します。
-
サブメニューから プラグイン(Plugins) タブを選択し、 プラグインのインストール(Install Plugin) をクリックします。
-
Key Authentication プラグインを見つけて、 有効にする をクリックします。
-
モックルートのページからプラグインが選択されているため、 プラグインをインストール:Key-auth ページでは、プラグインフィールドはルートに自動的にスコープされます。
この例では、すべてのデフォルト値を使用できることを意味します。
-
作成 クリックします。
API キーを提供せずにルートにアクセスしようとすると、リクエストは失敗し、次のメッセージが表示されます。"No API key found in request".
Kongがこのルートのリクエストをプロキシする前に、APIキーが必要です。この例では、Key Authenticationプラグインをインストールしたので、最初に関連付けられたキーを持つコンシューマを作成する必要があります。
コンシューマと認証情報を設定
Kong Managerの ワークスペース タブ:
- デフォルトの ワークスペースを開きます。
- メニューから コンシューマ を開き、 新規コンシューマ をクリックします。
-
ユーザー名 と カスタムID を入力します。この例では、各フィールドに
consumer
を使用できます。 - 作成 クリックします。
- [コンシューマ]ページで新しいコンシューマを開きます。
- サブメニューで 認証情報 を開きます。
- New Key Auth Credential をクリックします。
- キーを
apikey
に設定し、 作成 をクリックします。
新しいKey Authentication IDは、 コンシューマ ページの 認証情報 タブに表示されます。
Key Authenticationの検証
Key Authenticationプラグインを検証するには、次のURLに?apikey=apikey
を追加してブラウザからルートにアクセスします。
http://localhost:8000/mock?apikey=apikey
次の手順
次に、ターゲットを使ったアップストリームサービスのロードバランシングについて学びます。