download top

ドキュメント (0.10.x)

Kong がどのようにして API を加速していくのか学びましょう。

注意! 現在閲覧中のドキュメントは、Kong の旧バージョンです。最新のドキュメントは、こちらからご覧ください。

コンシューマーの追加


始める前に:
  1. 必ず Kong をインストールしてください - インストールは数分で完了します!
  2. 次に、Kong が起動していることを確認してください。
  3. そして、Kong に API が追加されたことを確認してください。

1 つ前のセクションでは、Kong へプラグインを追加する方法を学びました。このセクションでは、Kong インスタンスにコンシューマーを追加する方法を学ぶことができます。Kong のコンシューマーは、API を使用する個人を指し、トラッキングやアクセス管理などに使用することができます。

注意: このセクションでは、鍵認証プラグインが 有効化されている状態であることを前提とします。まだ有効化していない場合、プラグインの有効化を行うか、手順 2 および 3 をスキップしてください。


  1. RESTful API を通したコンシューマーの作成

    以下のリクエストを実行して、Jason という名前のユーザーを作成しましょう:

    $ curl -i -X POST \
      --url http://localhost:8001/consumers/ \
      --data "username=Jason"
    

    リクエスト後、以下のようなレスポンスが表示されます:

    HTTP/1.1 201 Created
    Content-Type: application/json
    Connection: keep-alive
    
    {
      "username": "Jason",
      "created_at": 1428555626000,
      "id": "bbdf1c48-19dc-4ab7-cae0-ff4f59d87dc9"
    }
    

    おめでとうございます!これで、Kong へ 1 人目のコンシューマーを追加することができました。

    注意: Kong は、既存のユーザー データベースでコンシューマーを関連付けるためにコンシューマーを追加する際、custom_id パラメーターを使用することができます。

  2. コンシューマーに対する鍵証明の提供

    ここで、以下のリクエストを実行して、先程作成したコンシューマーである Jason へキーを作成することができます:

    $ curl -i -X POST \
      --url http://localhost:8001/consumers/Jason/key-auth/ \
      --data 'key=ENTER_KEY_HERE'
    
  3. コンシューマー証明が有効であることを確認

    以下のリクエストを実行して、コンシューマーである Jason の証明が有効であることを確認します:

    $ curl -i -X GET \
      --url http://localhost:8000 \
      --header "Host: example.com" \
      --header "apikey: ENTER_KEY_HERE"
    
  4. 次のステップ

    これで、API およびコンシューマーの追加方法、そしてプラグインを有効化する方法の基礎を学ぶことができました。Kong についてさらに理解を深めたい方は、以下のドキュメント (英文) を参照してください。

    Config (設定) ファイル リファレンス

    CLI リファレンス

    プロキシ リファレンス

    Admin API リファレンス

    クラスタリング リファレンス

価格/お問い合わせ

製品の詳細、価格、ライセンス体系、デモの依頼など、お気軽にお問い合わせください。