在本节中,咱们将学习如何添加一个用户(consumer)到KONG实例中。用户是与使用您的API的我的相关联,可用于跟踪,访问管理等。数据库
NOTE:本节假设您已经正确启用了密钥验证插件。若是没有,请参考以前的步骤进行正确配置。json
1. 建立一个用户:api
经过如下命令,来建立一个模拟用户Jason:app
$ curl -i -X POST \ --url http://localhost:8001/consumers/ \ --data "username=Jason"
您应该看到相似于下面的回复:curl
HTTP/1.1 201 Created Content-Type: application/json Connection: keep-alive { "username": "Jason", "created_at": 1428555626000, "id": "bbdf1c48-19dc-4ab7-cae0-ff4f59d87dc9" }
此时,已经完成了建立用户的操做了。学习
NOTE:若是想要将用户和已有的其余数据库中的用户进行关联,可经过添加`custom_id`参数来实现,其值能够是现存用户的id。url
2. 为此用户添加一个[apikey]认证:spa
如今,咱们能够经过发出如下请求为咱们刚刚建立的用户Jason建立一个密钥:插件
$ curl -i -X POST \ --url http://localhost:8001/consumers/Jason/key-auth/ \ --data 'key=ENTER_KEY_HERE'
3. 验证您的用户的apikey是否有效:code
咱们如今能够发出如下请求,来验证用户Jason的apikey是否有效:
$ curl -i -X GET \ --url http://localhost:8000 \ --header "Host: example.com" \ --header "apikey: ENTER_KEY_HERE"