fossilman
fossilman

Kong插件向导

鉴权插件

Basic Authentication

配置信息

  • 基本描述
属性 描述
认证方式 基本认证、用户名密码登录
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为basic-auth
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.hide_credentials 是否隐藏请求中的凭证信息（如Authorization头），默认是false
config.anonymous 在验证失败后是否启用匿名消费者，值可以配置为消费者Id

使用详情

  • 创建消费者
curl -d "username=user123&custom_id=SOME_CUSTOM_ID" http://kong:8001/consumers/
  • 创建凭证
curl -X POST http://kong:8001/consumers/{consumer}/basic-auth --data "username=Aladdin" --data "password=OpenSesame"
  • 使用凭证
curl http://kong:8000/{path matching a configured Route} -H 'Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l'

凭证接口

  • 查看所有basic-auths凭证信息
curl -X GET http://kong:8001/basic-auths
  • 查看指定basic-auths凭证信息
curl -X GET http://kong:8001/consumers/{username or id}/basic-auths

HMAC Authentication

配置信息

  • 基本描述
属性 描述
认证方式 HMAC 签名认证
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为hmac-auth
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.hide_credentials 是否隐藏请求中的凭证信息（如Authorization头），默认是false
config.clock_skew 时间偏移量，默认是300s
config.anonymous 在验证失败后是否启用匿名消费者，值可以配置为消费者Id
config.validate_request_body 是否启用Body体校验，默认是false
config.enforce_headers 请求中必须包含的头部信息
config.algorithms HMAC 算法支持的列表，默认值是hmac-sha1,hmac-sha256,hmac-sha384,hmac-sha512

使用详情

  • 创建服务
curl -i -X POST http://localhost:8001/services -d "name=example-service" -d "url=http://example.com"
  • 创建路由
curl -i -f -X POST http://localhost:8001/services/example-service/routes -d "paths[]=/"
  • 创建插件
curl -i -X POST http://localhost:8001/services/example-service/plugins -d "name=hmac-auth" -d "config.enforce_headers=date, request-line" -d "config.algorithms=hmac-sha1, hmac-sha256"
  • 创建消费者
curl -i -X POST http://localhost:8001/consumers/ -d "username=alice"
  • 创建凭证
curl -i -X POST http://localhost:8001/consumers/alice/hmac-auth -d "username=alice123" -d "secret=secret"
  • 使用凭证
curl -i -X GET http://localhost:8000/requests -H "Host: hmac.com" -H "Date: Thu, 22 Jun 2017 17:15:21 GMT" -H 'Authorization: hmac username="alice123", algorithm="hmac-sha256", headers="date request-line", signature="ujWCGHeec9Xd6UD2zlyxiNMCiXnDOWeVFMu5VeRUxtw="'

凭证接口

  • 查看所有hmac-auths凭证信息
curl -X GET http://kong:8001/hmac-auths
  • 查看指定hmac-auths凭证信息
curl -X GET http://kong:8001/consumers/{username or id}/hmac-auths

JWT

配置信息

  • 基本描述
属性 描述
认证方式 JWT（JSON Web Tokens）认证
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为jwt
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.uri_param_names jwt的参数列表，默认值是jwt
config.cookie_names cookie中jwt的参数列表
config.claims_to_verify JWT声明中的验证，可接受的值exp、nbf
config.key_claim_name 创建凭证时响应体中的key字段必须需要传递，默认参数值iss
config.secret_is_base64 JWT是否启用Base64加密，默认是false
config.anonymous 在验证失败后是否启用匿名消费者，值可以配置为消费者Id
config.run_on_preflight 是否在 OPTIONS 类型的请求上启用鉴权
config.maximum_expiration JWT的最大失效时间，config.key_claim_name必须设置为exp，0代表永不是失效，默认值为0

使用详情

  • 创建消费者
curl -d "username=user123&custom_id=SOME_CUSTOM_ID" http://kong:8001/consumers/
  • 创建凭证
curl -X POST http://kong:8001/consumers/{consumer}/jwt -H "Content-Type: application/x-www-form-urlencoded"
参数 描述
{consumer} 消费者的Id或者用户名
key JWT凭证的key名，如果不指定，会自动生成
algorithm 校验token的算法，可以是HS256、HS384、HS512、RS256或者ES256，默认是HS256
rsa_public_key 如果算法使用RS256或者ES256，需要上传公钥，pem格式
secret 如果算法使用RS256或者ES256，JWT签名的secret，如果不指定，会自动生成
  • 使用凭证
curl http://kong:8000/{route path} -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJhMzZjMzA0OWIzNjI0OWEzYzlmODg5MWNiMTI3MjQzYyIsImV4cCI6MTQ0MjQzMDA1NCwibmJmIjoxNDQyNDI2NDU0LCJpYXQiOjE0NDI0MjY0NTR9.AhumfY35GFLuEEjrOXiaADo7Ae6gt_8VLwX7qffhQN4'

或者

curl http://kong:8000/{route path}?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJhMzZjMzA0OWIzNjI0OWEzYzlmODg5MWNiMTI3MjQzYyIsImV4cCI6MTQ0MjQzMDA1NCwibmJmIjoxNDQyNDI2NDU0LCJpYXQiOjE0NDI0MjY0NTR9.AhumfY35GFLuEEjrOXiaADo7Ae6gt_8VLwX7qffhQN4

或者

curl --cookie  jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJhMzZjMzA0OWIzNjI0OWEzYzlmODg5MWNiMTI3MjQzYyIsImV4cCI6MTQ0MjQzMDA1NCwibmJmIjoxNDQyNDI2NDU0LCJpYXQiOjE0NDI0MjY0NTR9.AhumfY35GFLuEEjrOXiaADo7Ae6gt_8VLwX7qffhQN4 http://kong:8000/{route path}
  • 删除凭证
curl -X DELETE http://kong:8001/consumers/{consumer}/jwt/{id}
  • 查询凭证
curl -X GET http://kong:8001/consumers/{consumer}/jwt

加密详情

  • 使用HS256签名
# 请求头
{
    "typ": "JWT",
    "alg": "HS256"
}

{
    "iss": "a36c3049b36249a3c9f8891cb127243c"
}

# token值
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJhMzZjMzA0OWIzNjI0OWEzYzlmODg5MWNiMTI3MjQzYyIsImV4cCI6MTQ0MjQzMDA1NCwibmJmIjoxNDQyNDI2NDU0LCJpYXQiOjE0NDI0MjY0NTR9.AhumfY35GFLuEEjrOXiaADo7Ae6gt_8VLwX7qffhQN4
  • 使用公私钥签名（RS256 or ES256）
# 创建凭证
curl -X POST http://kong:8001/consumers/{consumer}/jwt -F "rsa_public_key=@/path/to/public_key.pem"

# 请求头
{
    "typ": "JWT",
    "alg": "RS256"
}

{
    "iss": "a36c3049b36249a3c9f8891cb127243c"
}

# 使用凭证
curl http://kong:8000/{route path} -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiIxM2Q1ODE0NTcyZTc0YTIyYjFhOWEwMDJmMmQxN2MzNyJ9.uNPTnDZXVShFYUSiii78Q-IAfhnc2ExjarZr_WVhGrHHBLweOBJxGJlAKZQEKE4rVd7D6hCtWSkvAAOu7BU34OnlxtQqB8ArGX58xhpIqHtFUkj882JQ9QD6_v2S2Ad-EmEx5402ge71VWEJ0-jyH2WvfxZ_pD90n5AG5rAbYNAIlm2Ew78q4w4GVSivpletUhcv31-U3GROsa7dl8rYMqx6gyo9oIIDcGoMh3bu8su5kQc5SQBFp1CcA5H8sHGfYs-Et5rCU2A6yKbyXtpHrd1Y9oMrZpEfQdgpLae0AfWRf6JutA9SPhst9-5rn4o3cdUmto_TBGqHsFmVyob8VQ'

凭证接口

  • 查看所有jwt凭证信息
curl -X GET http://kong:8001/jwts
  • 查看指定jwt凭证信息
curl -X GET http://kong:8001/consumers/{username or id}/jwts

Key Authentication

配置信息

  • 基本描述
属性 描述
认证方式 Key认证
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为key-auth
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.key_names key的参数列表，默认值是apikey
config.key_in_body 参数key是否可以存放在请求体中，默认是false
config.hide_credentials 是否隐藏请求中的凭证信息，默认是false
config.anonymous 在验证失败后是否启用匿名消费者，值可以配置为消费者Id
config.run_on_preflight 是否在 OPTIONS 类型的请求上启用鉴权

使用详情

  • 创建消费者
curl -d  "username=user123&custom_id=SOME_CUSTOM_ID" http://kong:8001/consumers/
  • 创建凭证
curl -X POST http://kong:8001/consumers/{consumer}/key-auth -d ''
  • 使用凭证
curl http://kong:8000/{proxy path}?apikey=

或者

curl http://kong:8000/{proxy path} -H 'apikey: '
  • 删除凭证
curl -X DELETE http://kong:8001/consumers/{consumer}/key-auth/{id}

凭证接口

  • 查看所有key-auths凭证信息
curl -X GET http://kong:8001/key-auths
  • 查看指定key-auths凭证信息
curl -X GET http://kong:8001/consumers/{username or id}/key-auth

LDAP Authentication

配置信息

  • 基本描述
属性 描述
认证方式 LDAP认证
插件作用域 路由
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为ldap-auth
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.hide_credentials 是否隐藏请求中的凭证信息，默认是false
config.ldap_host LDAP服务器的地址
config.ldap_port LDAP服务器的端口
config.start_tls 是否启用TLS，默认是false
config.base_dn 基准DN（Distinguished Name）
config.verify_ldap_host 是否启用LDAP服务器验证，默认是false
config.attribute 搜索用户使用的属性
config.cache_ttl 缓存的失效时间，默认是60s
config.timeout 连接LDAP服务器超时时间，默认10000ms
config.keepalive LDAP服务器保持连接时间，默认60000ms
config.anonymous 在验证失败后是否启用匿名消费者，值可以配置为消费者Id
config.header_type 请求头参数名，默认是ldap

OAuth2.0 Authentication

配置信息

  • 基本描述
属性 描述
认证方式 HMAC 签名认证
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为key-auth
service_id 绑定的服务Id
enabled 是否启用该插件，默认是true
config.scopes 描述终端用户可以访问的范围
config.mandatory_scope 是否告诉插件至少给终端用户分配一个访问范围，默认是false
config.token_expiration token的过期时间，默认是7200s，设置为0时token不过期
config.enable_authorization_code 是否启用Authorization Code模式，默认是false
config.enable_client_credentials 是否启用Client Credentials模式，默认是false
config.enable_implicit_grant 是否启用Implicit Grant模式，默认是false
config.enable_password_grant 是否启用Password Grant模式，默认是false
config.auth_header_name 携带access token的头信息，默认值是authorization
config.hide_credentials 是否隐藏请求中的凭证信息，默认是false
config.accept_http_if_already_terminated
config.anonymous 在验证失败后是否启用匿名消费者，值可以配置为消费者Id
config.global_credentials 是否启用通用OAuth2.0服务
config.refresh_token_ttl refresh_token的过期时间，默认为两周，设置为0时token不过期

使用详情

  • OAuth2端点
端点 描述
/oauth2/authorize 授权服务器的端点，用于为Authorization Code模式提供authorization code，或为Implicit Grant模式提供access token，仅支持POST方法
/oauth2/token 令牌服务器的端点，也作为Client Credentials模式和Password Grant模式唯一的端点，仅支持POST方法
  • 创建消费者
curl -X POST http://kong:8001/consumers/ --data "username=user123" --data "custom_id=SOME_CUSTOM_ID"
  • 创建OAuth2.0应用
curl -X POST http://kong:8001/consumers/{consumer_id}/oauth2 --data "name=Test%20Application" --data "client_id=SOME-CLIENT-ID" --data "client_secret=SOME-CLIENT-SECRET" --data "redirect_uris=http://some-domain/endpoint/"
参数 描述
name 新建OAuth2.0应用的名称
client_id clientId，如果不指定，会自动生成
client_secret clientSecrct，如果不指定，会自动生成
redirect_uris 授权完成之后的跳转地址

OAuth2.0 Client Credentials模式

Client Credentials模式开箱即用，无需构建任何授权页面，客户端需要使用 /oauth2/token 端点获取access token

OAuth2.0 Authorization Code模式

配置完消费者并且与OAuth2.0凭证关联之后，需要正确了解OAuth2.0的授权流程，与大多数Kong插件不同，OAuth2.0插件需要一些额外的工作才能运转正常
用户必须在Web应用中实现授权页面，该页面与插件的服务器端通信，用户需要在网站或文档中解释清楚如何使用受OAuth2.0保护的服务，这个开发者可以知道如何实现客户端程序
构建授权页面是插件无法开箱即用的部分，因为它需要检查用户是否已正确登录，此操作与用户身份校验的实现密切相关
授权页面由两部分组成：

  • 用户看到的前端的页面，这将允许他授权客户端应用程序访问他的数据
  • 后端将处理HTML表单中显示的信息，这个表单会与Kong上的OAuth2.0插件进行通信，并最终将用户重定向到第三方URL上

完整流程如下：

  1. 客户端应用会将终端用户重定向到用户实现的授权页面上，并将 client_id、response_type 和 scope（如果需要的话） 作为参数传递过来；
  2. 在展示真实的授权页面前，应用程序需要确保该用户已经正常登录了；
  3. 客户端应用会通过参数将 client_id 传递给应用程序，应用程序向Kong发送指令取回OAuth2.0应用名和开发者名：
curl kong:8001/oauth2?client_id=XXX
  1. 如果终端用户授权了客户端程序，表单将使用 POST 请求将 client_id、response_type 和 scope 提交到后端；
  2. 后端在发送 POST 请求时还需要加入 provision_key 和 authenticated_userid 参数，如果客户端带入了 Authorization 头，请求也需要透传，其中 provision_key 是插件添加到服务时生成的密钥，authenticated_userid 是授予权限的用户的Id，请求大致如下：
curl https://your.service.com/oauth2/authorize --header "Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW" --data "client_id=XXX" --data "response_type=XXX" --data "scope=XXX" --data "provision_key=XXX" --data "authenticated_userid=XXX"
  1. Kong响应大致如下，200 OK 或者 400 Bad Request 响应码取决请求是否成功：
{
   "redirect_uri": "http://some/url"
}
  1. 无论哪种情况，忽略响应状态码，只需将用户重定向到 redirect_uri 属性返回的URI上；
  2. 客户端应用将在此处获取它，并将继续使用Kong，而不与用户的应用进行其他交互；
  3. 当获取到access token之后，客户端应用可以作为用户，向上游服务发起请求；
  4. access token是会过期的，当发生这种情况时，客户端应用程序需要使用Kong续订访问令牌

在这些步骤中，用户需要实现的步骤有：

  • 登录页（步骤2）
  • 授权页面，以及后端简单地收集信息，向Kong发送请求，并重定向到Kong返回的URL上

Password Grant模式

Password Grant模式是一个比较简单的模式，但仍需要后端授权（无前端）才能正常工作：

  1. 第一个请求中，客户端应用向应用程序发送请求，携带一些OAuth2的参数，包含用户名和密码；
  2. 应用程序的后端会校验客户端发送的用户名和密码，如果校验成功，会将 provision_key、authenticated_userid 和 grant_type 这些参数添加到客户端最初发送的参数中，并向Kong的 /oauth2/token 端点发送 POST 请求，其中 provision_key 是插件添加到服务时生成的密钥，authenticated_userid 是授予权限的用户的Id，请求大致如下：
curl https://your.service.com/oauth2/token --header "Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW" --data "client_id=XXX" --data "client_secret=XXX" --data "grant_type=password" --data "scope=XXX" --data "provision_key=XXX" --data "authenticated_userid=XXX" --data "username=XXX" --data "password=XXX"
  1. Kong返回一个JSON响应；
  2. Kong的响应必须原样发送回客户端，如果操作成功，响应中会包含access token，否则会包含错误

在这些步骤中，用户需要实现的步骤有：
后端端点将处理原始请求并验证客户端发送的用户名和密码，如果验证成功，则向Kong发出请求并返回客户端，无论Kong响应什么内容

刷新Token

当用户的access token过期时，用户可以使用refresh token生成新的access token

curl -X POST https://your.service.com/oauth2/token --data "grant_type=refresh_token" --data "client_id=XXX" --data "client_secret=XXX" --data "refresh_token=XXX"

安全插件

CORS

配置信息

  • 基本描述
属性 描述
安全策略 跨域资源共享
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为cors
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.origins Access-Control-Allow-Origin头允许的域列表，使用 * 代表允许所有域，值可以是普通值；也可以是正则表达式
config.methods Access-Control-Allow-Methods头的值，默认为GET, HEAD, PUT, PATCH, POST
config.headers Access-Control-Allow-Headers头的值，默认为Access-Control-Request-Headers头的值
config.exposed_headers Access-Control-Expose-Headers的值，如果不指定，不暴露自定义的头
config.credentials 是否发送Access-Control-Allow-Credentials请求头，默认是false
config.max_age 预检请求的缓存时间
config.preflight_continue 是否将 OPTIONS 请求代理到上游服务

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=cors" --data "config.origins=http://mockbin.com" --data "config.methods=GET" --data "config.methods=POST" --data "config.headers=Accept" --data "config.headers=Accept-Version" --data "config.headers=Content-Length" --data "config.headers=Content-MD5" --data "config.headers=Content-Type" --data "config.headers=Date" --data "config.headers=X-Auth-Token" --data "config.exposed_headers=X-Auth-Token" --data "config.credentials=true" --data "config.max_age=3600"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=cors" --data "config.origins=http://mockbin.com" --data "config.methods=GET" --data "config.methods=POST" --data "config.headers=Accept" --data "config.headers=Accept-Version" --data "config.headers=Content-Length" --data "config.headers=Content-MD5" --data "config.headers=Content-Type" --data "config.headers=Date" --data "config.headers=X-Auth-Token" --data "config.exposed_headers=X-Auth-Token" --data "config.credentials=true" --data "config.max_age=3600"

IP Restriction

配置信息

  • 基本描述
属性 描述
安全策略 IP限制
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为ip-restriction
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.whitelist 白名单列表，白名单或黑名单必须配置一个
config.blacklist 黑名单列表，白名单或黑名单必须配置一个

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=ip-restriction" --data "config.whitelist=54.13.21.1" --data "config.whitelist=143.1.0.0/24"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=ip-restriction" --data "config.whitelist=54.13.21.1" --data "config.whitelist=143.1.0.0/24"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=ip-restriction" --data "config.whitelist=54.13.21.1" --data "config.whitelist=143.1.0.0/24"

注意，白名单 和 黑名单模型在使用中是互斥的，它们提供了互补的方法，也就是说，用户无法既用白名单 ，又用黑名单配置插件，白名单提供了积极的安全模型，只允许配置范围内的ip访问资源，其他全部拒绝；黑名单提供了被动的安全模型，只拒绝配置范围内的ip访问资源，其他全部允许

流量控制插件

ACL

配置信息

  • 基本描述
属性 描述
限流策略 ACL组限制
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为acl
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
config.whitelist 白名单组列表，白名单或黑名单必须配置一个
config.blacklist 黑名单组列表，白名单或黑名单必须配置一个
config.hide_groups_header 是否将X-Consumer-Groups头发送给上游服务

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=acl" --data "config.whitelist=group1" --data "config.whitelist=group2" --data "config.hide_groups_header=true"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=acl" --data "config.whitelist=group1" --data "config.whitelist=group2" --data "config.hide_groups_header=true"
  • 在消费者上添加ACL组属性
curl -X POST http://kong:8001/consumers/{consumer}/acls --data "group=group1"

凭证接口

  • 查询所有消费者的ACL组
curl -X GET http://kong:8001/acls
  • 查询指定消费者的ACL组
curl -X GET http://kong:8001/consumers/{username or id}/acls
  • 查询ACL组Id关联的消费者
curl -X GET http://kong:8001/acls/{id}/consumer

Proxy Caching

配置信息

  • 基本描述
属性 描述
限流策略 终止请求限制
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为proxy-cache
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
api_id 绑定的API Id，已经废弃
config.response_code 上游服务可以作为缓存的状态码，默认值为200, 301, 404
config.request_method 下游服务可以作为缓存的方法，默认为GET, HEAD
config.content_type 可以作为缓存的 content type
config.vary_headers 用于生成缓存Key的头部信息，如果不指定，所有头部信息都不作为数据源
config.vary_query_params 用于生成缓存Key的查询参数，如果不指定，所有查询参数都作为数据源
config.cache_ttl 缓存的TTL时间，默认是300s
config.cache_control 是否启用Cache-Control行为，默认是false
config.storage_ttl 数据在存储引擎中的TTL时间
config.strategy 缓存策略，可以取 memory 或 redis
config.memory.dictionary_name 当选用 memory 策略时，用于保存缓存实体的 shared dictionary 的名称，这个 shared dictionary 必须在Kong的Nginx模板中手动定义，默认是kong_cache
config.redis.host redis服务器地址
config.redis.port redis服务器端口
config.redis.timeout 连接redis服务器超时时间
config.redis.password redis服务器密码
config.redis.database redis数据库
config.redis.sentinel_master redis哨兵模式master节点地址
config.redis.sentinel_role redis哨兵模式角色
config.redis.sentinel_addresses redis哨兵模式哨兵地址

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=proxy-cache" --data "config.strategy=memory"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=proxy-cache" --data "config.strategy=memory"
  • 在消费者上添加插件
curl -X POST http://kong:8001/apis/{api}/plugins --data "name=proxy-cache" --data "config.strategy=memory"
  • 缓存策略
模式 描述
memory 内存模式，是一个lua_shared_dict，默认的kong_cache也被Kong的其他插件用于缓存其他数据，使用这种方式比较简单，但不推荐在大规模场景中使用，因为大量使用会对Kong数据缓存操作造成压力
redis 支持redis和redis哨兵模式
  • 缓存Key
    Kong基于请求方法、完整的客户端请求（路径和请求参数）和绑定在请求上的API或消费者UUID来生成缓存 Key，所以各个API或消费者之间的缓存都是不同的，目前缓存Key的格式是硬编码的，无法调整，缓存的组成方式如下：
key = md5(UUID | method | request)

其中 method 是通过 ngx.req.get_method() 方法获得的，request 是根据 Nginx $request 变量获得的，Kong会在响应的 X-Cache-Key 头中返回缓存Key值，如上所述，可以预先计算缓存Key

  • 缓存控制
    当启用 cache_control 时，Kong将遵守 Cache-Control 头的使用规范，有一些例外情况：
  1. 不支持缓存重新验证
  2. 类似地，no-cache 排除缓存存在
  3. 不支持根据 Vary 计算二级缓存
  • 缓存状态
    Kong通过 X-Cache-Status 头表示缓存行为的状态：
状态 描述
Miss 请求可以缓存，但是缓存中没有数据，数据从代理的服务中获取
Hit 缓存命中，数据从缓存中获取
Refresh 缓存命中，但因为缓存控制行为或者达到了cache_ttl设置的阈值
Bypass 不能使用缓存
  • 存储TTL
    Kong可以在存储引擎中存储数据，存储时间超过 cache_ttl 或 Cache-Control 阈值所限定的时间，这使得Kong在资源过期后，还能维持一份资源的缓存副本，这样客户端在必要时可以使用 max-age 或 max-stale 头请求过期的数据

缓存API

  • 获取缓存实体
    GET /proxy-cache/:plugin_id/caches/:cache_id
    GET /proxy-cache/:cache_id
  • 删除缓存实体
    DELETE /proxy-cache/:plugin_id/caches/:cache_id
    DELETE /proxy-cache/:cache_id
  • 清除所有缓存
    DELETE /proxy-cache/

Rate Limiting

配置信息

  • 基本描述
属性 描述
限流策略 ACL组限制
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为rate-limiting
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.second 每秒的限流数
config.minute 每分钟的限流数
config.hour 每小时的限流数
config.day 每天的限流数
config.month 每月的限流数
config.year 每年的限流数
config.limit_by 限制次数的衡量标准，可以取consumer、credential 或 ip，如果不能识别consumer或credential，都按照ip计数，默认是consumer
config.policy 限流累加器的计数策略，可以取local、cluster 或 redis，默认是cluster
config.fault_tolerant 当第三方数据源出错时，是否启用限流功能，取true时会禁用限流功能，默认是true
config.hide_client_headers 是否隐藏消息响应头，默认是false
config.redis_host redis服务器地址
config.redis_port redis服务器端口
config.redis_password redis服务器密码
config.redis_timeout 连接redis服务器超时时间
config.redis_database redis数据库

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=rate-limiting" --data "config.second=5" --data "config.hour=10000"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=rate-limiting" --data "config.second=5" --data "config.hour=10000"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=rate-limiting" --data "config.second=5" --data "config.hour=10000"
  • 返回给客户端的头部信息
X-RateLimit-Limit-Second: 5
X-RateLimit-Remaining-Second: 4
X-RateLimit-Limit-Minute: 10
X-RateLimit-Remaining-Minute: 9
  • 实施细节
模式 优点 描述
cluster 准确，不需要依赖其他组件 相对来说性能影响最大的，每个请求都会强制对底层的数据源进行读写操作
redis 准确，性能影响比cluster模式小 需要额外安装redis，相比local模式性能影响大
local 性能影响最小 不太准确，除非在Kong之前使用Hash一致性负载均衡器
  1. 事务粒度
    这个场景中，不能选用 local 策略，应该在 cluster 或 redis 策略中考量，推荐是先尝试使用 cluster 策略，如果性能急速下降，则切换成 redis 策略，需要注意的是，指标数据无法从原有数据源切换到redis，通常来说，短周期指标（如秒、分）不受影响，长周期指标（月）可能会有影响，所以切换数据源时需要小心
  2. 后端保护模式
    这种场景中因为准确性不太重要，可以使用 local 策略，这需要多些尝试才能找到合适的值，比如用户希望配置限流每秒100个请求，总共有5个Kong节点，设置 local 策略，每秒30个请求，大致可以满足需求，如果觉得返回的失败过于频繁，可以适当增大阈值
    需要注意的是，当增加Kong节点时，会增加总请求数；同理减少Kong节点时，会降低总请求数，所以调整节点数时需要同步调整阈值
    在Kong节点前使用Hash一致性负载均衡器可以避免上述的问题，因为它会保证相同的用户会路由到指定的Kong节点，保证数据准确，并且不受节点缩放的影响
    通常情况下，真实的请求数会大于限流的阈值，但是它还是能有效的防止攻击，并且保持最佳性能

RequestTermination

配置信息

  • 基本描述
属性 描述
限流策略 终止请求限制
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为request-termination
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.status_code 响应码，默认是503
config.message 响应消息
config.body 响应消息体，与响应消息互斥
config.content_type 响应体的content_type，默认值是 application/json; charset=utf-8

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=request-termination" --data "config.status_code=403" --data "config.message=So long and thanks for all the fish!"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=request-termination" --data "config.status_code=403" --data "config.message=So long and thanks for all the fish!"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=request-termination" --data "config.status_code=403" --data "config.message=So long and thanks for all the fish!"
  • 使用场景
  1. 临时禁用某个服务（比如正在维护中）
  2. 临时禁用某个路由（比如需要禁用某个端点）
  3. 临时禁用某个消费者（比如过度消费）
  4. 阻止匿名访问

Kong Service Virtualization

配置信息

  • 基本描述
属性 描述
限流策略 服务虚拟化
插件作用域 服务、路由、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为kong-service-virtualization
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
api_id 绑定的API Id，已经废弃
config.virtual_tests JSON字串配置项
  • JSON配置项
参数 描述
name 测试用例名称
requestHttpMethod 测试用例的请求方法
requestHash 测试用例的请求参数，使用Sha256算法加密
responseHttpStatus 测试用例的响应状态码
responseContentType 测试用例的响应ContentType
response 测试用例的响应体，采用Base64编码

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=kong-service-virtualization" --data "config.virtual_tests={"name"=>"TestCase1", "requestHttpMethod"=>"POST", "requestHash"=>"0296217561490155228da9c17fc555cf9db82d159732f3206638c25f04a285c4", "responseHttpStatus"=>"200", "responseContentType"=>"application/json", "response"=>"eyJtZXNzYWdlIjogIkEgQmlnIFN1Y2Nlc3MhIn0="}" --data "config.virtual_tests={"name"=>"TestCase2", "requestHttpMethod"=>"GET", "requestHash"=>"e2c319e4ef41706e2c0c1b266c62cad607a014c59597ba662bef6d10a0b64a32", "responseHttpStatus"=>"200", "responseContentType"=>"application/json", "response"=>"eyJtZXNzYWdlIjogIkFub3RoZXIgU3VjY2VzcyEifQ=="}"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=kong-service-virtualization" --data "config.virtual_tests={"name"=>"TestCase1", "requestHttpMethod"=>"POST", "requestHash"=>"0296217561490155228da9c17fc555cf9db82d159732f3206638c25f04a285c4", "responseHttpStatus"=>"200", "responseContentType"=>"application/json", "response"=>"eyJtZXNzYWdlIjogIkEgQmlnIFN1Y2Nlc3MhIn0="}" --data "config.virtual_tests={"name"=>"TestCase2", "requestHttpMethod"=>"GET", "requestHash"=>"e2c319e4ef41706e2c0c1b266c62cad607a014c59597ba662bef6d10a0b64a32", "responseHttpStatus"=>"200", "responseContentType"=>"application/json", "response"=>"eyJtZXNzYWdlIjogIkFub3RoZXIgU3VjY2VzcyEifQ=="}"
  • 安装插件
  1. 推荐安装方式
luarocks install kong-service-virtualization
  1. 其他选择安装方式
git clone https://github.com/Optum/kong-service-virtualization
cd /path/to/kong/plugins/kong-service-virtualization
luarocks make *.rockspec
  • virtual_tests参数详解
[
     {
        "name": "TestCase1",           
        "requestHttpMethod": "POST",
        "requestHash": "0296217561490155228da9c17fc555cf9db82d159732f3206638c25f04a285c4",
        "responseHttpStatus": "200",
        "responseContentType": "application/json",
        "response": "eyJtZXNzYWdlIjogIkEgQmlnIFN1Y2Nlc3MhIn0="
    },
    {         
        "name": "TestCase2",           
        "requestHttpMethod": "GET",
        "requestHash": "e2c319e4ef41706e2c0c1b266c62cad607a014c59597ba662bef6d10a0b64a32",
        "responseHttpStatus": "200",
        "responseContentType": "application/json",
        "response": "eyJtZXNzYWdlIjogIkFub3RoZXIgU3VjY2VzcyEifQ=="
    }
]

上述的请求相当于：

https://gateway.company.com/virtualtest
POST:
{
   "virtual": "test"
}
Response : {"message": "A Big Success!"} as base64 encoded in plugin
GET:
hello=world&service=virtualized
Response : {"message": "Another Success!"} as base4 encoded in plugin

日志插件

HTTP Log

配置信息

  • 基本描述
属性 描述
日志策略 HTTP日志
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为http-log
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.http_endpoint http服务器端点，数据会发送到该端点
config.method 向http服务器发送数据的方法，默认是POST方法，其他支持的方法是PUT和PATCH
config.timeout 发送数据的超时时间，默认是10000ms
config.keepalive 空闲连接的等待时间，默认是60000ms

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=http-log" --data "config.http_endpoint=http://mockbin.org/bin/:id" --data "config.method=POST" --data "config.timeout=1000" --data "config.keepalive=1000"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=http-log" --data "config.http_endpoint=http://mockbin.org/bin/:id" --data "config.method=POST" --data "config.timeout=1000" --data "config.keepalive=1000"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=http-log" --data "config.http_endpoint=http://mockbin.org/bin/:id" --data "config.method=POST" --data "config.timeout=1000" --data "config.keepalive=1000"

日志格式

{
    "request": {
        "method": "GET",
        "uri": "/get",
        "url": "http://httpbin.org:8000/get",
        "size": "75",
        "querystring": {},
        "headers": {
            "accept": "*/*",
            "host": "httpbin.org",
            "user-agent": "curl/7.37.1"
        },
        "tls": {
            "version": "TLSv1.2",
            "cipher": "ECDHE-RSA-AES256-GCM-SHA384",
            "supported_client_ciphers": "ECDHE-RSA-AES256-GCM-SHA384",
            "client_verify": "NONE"
        }
    },
    "upstream_uri": "/",
    "response": {
        "status": 200,
        "size": "434",
        "headers": {
            "Content-Length": "197",
            "via": "kong/0.3.0",
            "Connection": "close",
            "access-control-allow-credentials": "true",
            "Content-Type": "application/json",
            "server": "nginx",
            "access-control-allow-origin": "*"
        }
    },
    "tries": [
        {
            "state": "next",
            "code": 502,
            "ip": "127.0.0.1",
            "port": 8000
        },
        {
            "ip": "127.0.0.1",
            "port": 8000
        }
    ],
    "authenticated_entity": {
        "consumer_id": "80f74eef-31b8-45d5-c525-ae532297ea8e",
        "id": "eaa330c0-4cff-47f5-c79e-b2e4f355207e"
    },
    "route": {
        "created_at": 1521555129,
        "hosts": null,
        "id": "75818c5f-202d-4b82-a553-6a46e7c9a19e",
        "methods": null,
        "paths": [
            "/example-path"
        ],
        "preserve_host": false,
        "protocols": [
            "http",
            "https"
        ],
        "regex_priority": 0,
        "service": {
            "id": "0590139e-7481-466c-bcdf-929adcaaf804"
        },
        "strip_path": true,
        "updated_at": 1521555129
    },
    "service": {
        "connect_timeout": 60000,
        "created_at": 1521554518,
        "host": "example.com",
        "id": "0590139e-7481-466c-bcdf-929adcaaf804",
        "name": "myservice",
        "path": "/",
        "port": 80,
        "protocol": "http",
        "read_timeout": 60000,
        "retries": 5,
        "updated_at": 1521554518,
        "write_timeout": 60000
    },
    "workspaces": [
        {
            "id":"b7cac81a-05dc-41f5-b6dc-b87e29b6c3a3",
            "name": "default"
        }
    ],
    "consumer": {
        "username": "demo",
        "created_at": 1491847011000,
        "id": "35b03bfc-7a5b-4a23-a594-aa350c585fa8"
    },
    "latencies": {
        "proxy": 1430,
        "kong": 9,
        "request": 1921
    },
    "client_ip": "127.0.0.1",
    "started_at": 1433209822425
}
参数 描述
request 客户端发送的请求信息
response 发送给客户端的响应信息
tries 请求负载均衡记录信息
route 请求对应的路由信息
service 请求对应的服务信息
authenticated_entity 请求对应的凭证信息
workspaces 企业版本 >= 0.34 包含的信息，可以忽略
consumer 请求对应的消费者信息
latencies.proxy 从接收到客户端请求，到查找到指定服务花的时间
latencies.kong Kong所有插件运行的时间
latencies.request 请求的总时常
client_ip 客户端的原始IP
started_at 请求的时间戳

TCP Log

配置信息

  • 基本描述
属性 描述
日志策略 TCP日志
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为tcp-log
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.host 服务器Ip地址
config.port 服务器端口
config.timeout 发送数据的超时时间，默认是10000ms
config.keepalive 空闲连接的等待时间，默认是60000ms

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=tcp-log" --data "config.host=127.0.0.1" --data "config.port=9999"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=tcp-log" --data "config.host=127.0.0.1" --data "config.port=9999"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=tcp-log" --data "config.host=127.0.0.1" --data "config.port=9999"

日志格式

{
    "request": {
        "method": "GET",
        "uri": "/get",
        "url": "http://httpbin.org:8000/get",
        "size": "75",
        "querystring": {},
        "headers": {
            "accept": "*/*",
            "host": "httpbin.org",
            "user-agent": "curl/7.37.1"
        },
        "tls": {
            "version": "TLSv1.2",
            "cipher": "ECDHE-RSA-AES256-GCM-SHA384",
            "supported_client_ciphers": "ECDHE-RSA-AES256-GCM-SHA384",
            "client_verify": "NONE"
        }
    },
    "upstream_uri": "/",
    "response": {
        "status": 200,
        "size": "434",
        "headers": {
            "Content-Length": "197",
            "via": "kong/0.3.0",
            "Connection": "close",
            "access-control-allow-credentials": "true",
            "Content-Type": "application/json",
            "server": "nginx",
            "access-control-allow-origin": "*"
        }
    },
    "tries": [
        {
            "state": "next",
            "code": 502,
            "ip": "127.0.0.1",
            "port": 8000
        },
        {
            "ip": "127.0.0.1",
            "port": 8000
        }
    ],
    "authenticated_entity": {
        "consumer_id": "80f74eef-31b8-45d5-c525-ae532297ea8e",
        "id": "eaa330c0-4cff-47f5-c79e-b2e4f355207e"
    },
    "route": {
        "created_at": 1521555129,
        "hosts": null,
        "id": "75818c5f-202d-4b82-a553-6a46e7c9a19e",
        "methods": null,
        "paths": [
            "/example-path"
        ],
        "preserve_host": false,
        "protocols": [
            "http",
            "https"
        ],
        "regex_priority": 0,
        "service": {
            "id": "0590139e-7481-466c-bcdf-929adcaaf804"
        },
        "strip_path": true,
        "updated_at": 1521555129
    },
    "service": {
        "connect_timeout": 60000,
        "created_at": 1521554518,
        "host": "example.com",
        "id": "0590139e-7481-466c-bcdf-929adcaaf804",
        "name": "myservice",
        "path": "/",
        "port": 80,
        "protocol": "http",
        "read_timeout": 60000,
        "retries": 5,
        "updated_at": 1521554518,
        "write_timeout": 60000
    },
    "workspaces": [
        {
            "id":"b7cac81a-05dc-41f5-b6dc-b87e29b6c3a3",
            "name": "default"
        }
    ],
    "consumer": {
        "username": "demo",
        "created_at": 1491847011000,
        "id": "35b03bfc-7a5b-4a23-a594-aa350c585fa8"
    },
    "latencies": {
        "proxy": 1430,
        "kong": 9,
        "request": 1921
    },
    "client_ip": "127.0.0.1",
    "started_at": 1433209822425
}
参数 描述
request 客户端发送的请求信息
response 发送给客户端的响应信息
tries 请求负载均衡记录信息
route 请求对应的路由信息
service 请求对应的服务信息
authenticated_entity 请求对应的凭证信息
workspaces 企业版本 >= 0.34 包含的信息，可以忽略
consumer 请求对应的消费者信息
latencies.proxy 从接收到客户端请求，到查找到指定服务花的时间
latencies.kong Kong所有插件运行的时间
latencies.request 请求的总时常
client_ip 客户端的原始IP
started_at 请求的时间戳

UDP Log

配置信息

  • 基本描述
属性 描述
日志策略 UDP日志
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为udp-log
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.host 服务器Ip地址
config.port 服务器端口
config.timeout 发送数据的超时时间，默认是10000ms
config.keepalive 空闲连接的等待时间，默认是60000ms

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=udp-log" --data "config.host=127.0.0.1" --data "config.port=9999" --data "config.timeout=10000"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=udp-log" --data "config.host=127.0.0.1" --data "config.port=9999" --data "config.timeout=10000"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=udp-log" --data "config.host=127.0.0.1" --data "config.port=9999" --data "config.timeout=10000"

日志格式

{
    "request": {
        "method": "GET",
        "uri": "/get",
        "url": "http://httpbin.org:8000/get",
        "size": "75",
        "querystring": {},
        "headers": {
            "accept": "*/*",
            "host": "httpbin.org",
            "user-agent": "curl/7.37.1"
        },
        "tls": {
            "version": "TLSv1.2",
            "cipher": "ECDHE-RSA-AES256-GCM-SHA384",
            "supported_client_ciphers": "ECDHE-RSA-AES256-GCM-SHA384",
            "client_verify": "NONE"
        }
    },
    "upstream_uri": "/",
    "response": {
        "status": 200,
        "size": "434",
        "headers": {
            "Content-Length": "197",
            "via": "kong/0.3.0",
            "Connection": "close",
            "access-control-allow-credentials": "true",
            "Content-Type": "application/json",
            "server": "nginx",
            "access-control-allow-origin": "*"
        }
    },
    "tries": [
        {
            "state": "next",
            "code": 502,
            "ip": "127.0.0.1",
            "port": 8000
        },
        {
            "ip": "127.0.0.1",
            "port": 8000
        }
    ],
    "authenticated_entity": {
        "consumer_id": "80f74eef-31b8-45d5-c525-ae532297ea8e",
        "id": "eaa330c0-4cff-47f5-c79e-b2e4f355207e"
    },
    "route": {
        "created_at": 1521555129,
        "hosts": null,
        "id": "75818c5f-202d-4b82-a553-6a46e7c9a19e",
        "methods": null,
        "paths": [
            "/example-path"
        ],
        "preserve_host": false,
        "protocols": [
            "http",
            "https"
        ],
        "regex_priority": 0,
        "service": {
            "id": "0590139e-7481-466c-bcdf-929adcaaf804"
        },
        "strip_path": true,
        "updated_at": 1521555129
    },
    "service": {
        "connect_timeout": 60000,
        "created_at": 1521554518,
        "host": "example.com",
        "id": "0590139e-7481-466c-bcdf-929adcaaf804",
        "name": "myservice",
        "path": "/",
        "port": 80,
        "protocol": "http",
        "read_timeout": 60000,
        "retries": 5,
        "updated_at": 1521554518,
        "write_timeout": 60000
    },
    "workspaces": [
        {
            "id":"b7cac81a-05dc-41f5-b6dc-b87e29b6c3a3",
            "name": "default"
        }
    ],
    "consumer": {
        "username": "demo",
        "created_at": 1491847011000,
        "id": "35b03bfc-7a5b-4a23-a594-aa350c585fa8"
    },
    "latencies": {
        "proxy": 1430,
        "kong": 9,
        "request": 1921
    },
    "client_ip": "127.0.0.1",
    "started_at": 1433209822425
}
参数 描述
request 客户端发送的请求信息
response 发送给客户端的响应信息
tries 请求负载均衡记录信息
route 请求对应的路由信息
service 请求对应的服务信息
authenticated_entity 请求对应的凭证信息
workspaces 企业版本 >= 0.34 包含的信息，可以忽略
consumer 请求对应的消费者信息
latencies.proxy 从接收到客户端请求，到查找到指定服务花的时间
latencies.kong Kong所有插件运行的时间
latencies.request 请求的总时常
client_ip 客户端的原始IP
started_at 请求的时间戳

转换插件

Correlation ID

配置信息

  • 基本描述
属性 描述
转换策略 关联ID
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为correlation-id
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.header_name 用来关联Id的Http头，默认是 Kong-Request-ID
config.generator 关联Id的生成器，可以取 uuid、uuid#counter 或 tracker，默认是 uuid#counter
config.echo_downstream 是否将 Kong-Request-ID 返回给客户端，默认是false

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=correlation-id" --data "config.header_name=Kong-Request-ID" --data "config.generator=uuid#counter" --data "config.echo_downstream=false"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=correlation-id" --data "config.header_name=Kong-Request-ID" --data "config.generator=uuid#counter" --data "config.echo_downstream=false"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=correlation-id" --data "config.header_name=Kong-Request-ID" --data "config.generator=uuid#counter" --data "config.echo_downstream=false"

ID生成器

  • uuid
    格式：
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

使用这种格式时，每个请求以十六进制形式生成UUID

  • uuid#counter
    格式：
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx#counter

使用这种格式时，基于每个 worker 生成UUID，之后的请求会在UUID之后添加一个累加器，每个计数器从0开始计数，每个 worker 之间都是独立的，这种格式性能比较高，但是比较难以存储并进一步进行处理

  • tracker
    格式：
ip-port-pid-connection-connection_requests-timestamp

使用这种格式时，关联Id更有实际意义：

参数 描述
ip 处理请求的服务器地址
port 处理请求的服务器端口
pid nginx worker进程
connection 连接序列号
connection_requests 连接的请求序列号
timestamp 时间戳

Request Transformer

配置信息

  • 基本描述
属性 描述
转换策略 请求转换
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为request-transformer
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.http_method 更改请求的Http方法
config.remove.headers 删除请求头
config.remove.querystring 删除请求参数
config.remove.body 删除请求体中的参数，content-type为 application/json、 multipart/form-data 或 application/x-www-form-urlencoded 中的一个
config.replace.headers 替换请求头，形式为键值对
config.replace.querystring 替换请求参数，形式为键值对
config.replace.body 替换请求体中的参数，形式为键值对，content-type为 application/json、 multipart/form-data 或 application/x-www-form-urlencoded 中的一个
config.rename.headers 重命名请求头，形式为键值对
config.rename.querystring 重命名请求参数，形式为键值对
config.rename.body 重命名请求体中的参数，形式为键值对，content-type为 application/json、 multipart/form-data 或 application/x-www-form-urlencoded 中的一个
config.add.headers 添加请求头，形式为键值对，如果原请求中没有该参数，添加一个；如果原请求中已经有了，直接忽略
config.add.querystring 添加请求参数，形式为键值对，如果原请求中没有该参数，添加一个；如果原请求中已经有了，直接忽略
config.add.body 添加请求体中的参数，形式为键值对，content-type为 application/json、 multipart/form-data 或 application/x-www-form-urlencoded 中的一个，如果原请求中没有该参数，添加一个；如果原请求中已经有了，直接忽略
config.append.headers 追加请求头，形式为键值对，如果原请求中没有该参数，添加一个；如果原请求中已经有了，再原样添加一个
config.append.querystring 追加请求参数，形式为键值对，如果原请求中没有该参数，添加一个；如果原请求中已经有了，直接忽略
config.append.body 追加请求体中的参数，形式为键值对，content-type为 application/json、 multipart/form-data 或 application/x-www-form-urlencoded 中的一个，如果原请求中没有该参数，添加一个；如果原请求中已经有了，直接忽略

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=request-transformer" --data "config.remove.headers=x-toremove" --data "config.remove.headers=x-another-one" --data "config.remove.querystring=qs-old-name:qs-new-name" --data "config.remove.querystring=qs2-old-name:qs2-new-name" --data "config.remove.body=formparam-toremove" --data "config.remove.body=formparam-another-one" --data "config.rename.headers=header-old-name:header-new-name" --data "config.rename.headers=another-old-name:another-new-name" --data "config.rename.querystring=qs-old-name:qs-new-name" --data "config.rename.querystring=qs2-old-name:qs2-new-name" --data "config.rename.body=param-old:param-new" --data "config.rename.body=param2-old:param2-new" --data "config.add.headers=x-new-header:value" --data "config.add.headers=x-another-header:something" --data "config.add.querystring=new-param:some_value" --data "config.add.querystring=another-param:some_value" --data "config.add.body=new-form-param:some_value" --data "config.add.body=another-form-param:some_value"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=request-transformer" --data "config.remove.headers=x-toremove" --data "config.remove.headers=x-another-one" --data "config.remove.querystring=qs-old-name:qs-new-name" --data "config.remove.querystring=qs2-old-name:qs2-new-name" --data "config.remove.body=formparam-toremove" --data "config.remove.body=formparam-another-one" --data "config.rename.headers=header-old-name:header-new-name" --data "config.rename.headers=another-old-name:another-new-name" --data "config.rename.querystring=qs-old-name:qs-new-name" --data "config.rename.querystring=qs2-old-name:qs2-new-name" --data "config.rename.body=param-old:param-new" --data "config.rename.body=param2-old:param2-new" --data "config.add.headers=x-new-header:value" --data "config.add.headers=x-another-header:something" --data "config.add.querystring=new-param:some_value" --data "config.add.querystring=another-param:some_value" --data "config.add.body=new-form-param:some_value" --data "config.add.body=another-form-param:some_value"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=request-transformer" --data "config.remove.headers=x-toremove" --data "config.remove.headers=x-another-one" --data "config.remove.querystring=qs-old-name:qs-new-name" --data "config.remove.querystring=qs2-old-name:qs2-new-name" --data "config.remove.body=formparam-toremove" --data "config.remove.body=formparam-another-one" --data "config.rename.headers=header-old-name:header-new-name" --data "config.rename.headers=another-old-name:another-new-name" --data "config.rename.querystring=qs-old-name:qs-new-name" --data "config.rename.querystring=qs2-old-name:qs2-new-name" --data "config.rename.body=param-old:param-new" --data "config.rename.body=param2-old:param2-new" --data "config.add.headers=x-new-header:value" --data "config.add.headers=x-another-header:something" --data "config.add.querystring=new-param:some_value" --data "config.add.querystring=another-param:some_value" --data "config.add.body=new-form-param:some_value" --data "config.add.body=another-form-param:some_value"
  • 参数执行顺序
    删除 -> 重命名 -> 替换 -> 添加 -> 追加

Response Transformer

配置信息

  • 基本描述
属性 描述
转换策略 响应转换
插件作用域 服务、路由、消费者、全局
适用协议 http、https
  • 参数
参数 描述
name 插件名称、此处为response-transformer
service_id 绑定的服务Id
route_id 绑定的路由Id
enabled 是否启用该插件，默认是true
consumer_id 绑定的消费者Id
config.remove.headers 删除响应头
config.remove.json 删除响应体
config.replace.headers 替换响应头，形式为键值对
config.replace.json 替换响应体，形式为键值对
config.add.headers 添加响应头，形式为键值对，如果原响应中没有该参数，添加一个；如果原响应中已经有了，直接忽略
config.add.json 添加响应体，形式为键值对，如果原响应中没有该参数，添加一个；如果原响应中已经有了，直接忽略
config.append.headers 追加响应头，形式为键值对，如果原响应中没有该参数，添加一个；如果原响应中已经有了，再原样添加一个
config.append.json 追加响应体，形式为键值对，如果原响应中没有该参数，添加一个；如果原响应中已经有了，再原样添加一个

使用详情

  • 在服务上添加插件
curl -X POST http://kong:8001/services/{service}/plugins --data "name=response-transformer" --data "config.remove.headers=x-toremove, x-another-one" --data "config.remove.json=json-key-toremove, another-json-key" --data "config.add.headers=x-new-header:value,x-another-header:something" --data "config.add.json=new-json-key:some_value, another-json-key:some_value" --data "config.append.headers=x-existing-header:some_value, x-another-header:some_value"
  • 在路由上添加插件
curl -X POST http://kong:8001/routes/{route}/plugins --data "name=response-transformer" --data "config.remove.headers=x-toremove, x-another-one" --data "config.remove.json=json-key-toremove, another-json-key" --data "config.add.headers=x-new-header:value,x-another-header:something" --data "config.add.json=new-json-key:some_value, another-json-key:some_value" --data "config.append.headers=x-existing-header:some_value, x-another-header:some_value"
  • 在消费者上添加插件
curl -X POST http://kong:8001/consumers/{consumer}/plugins --data "name=response-transformer" --data "config.remove.headers=x-toremove, x-another-one" --data "config.remove.json=json-key-toremove, another-json-key" --data "config.add.headers=x-new-header:value,x-another-header:something" --data "config.add.json=new-json-key:some_value, another-json-key:some_value" --data "config.append.headers=x-existing-header:some_value, x-another-header:some_value"
  • 参数执行顺序
    删除 -> 替换 -> 添加 -> 追加

你可能感兴趣的:(Kong插件向导)

  • Android和IOS应用开发-Flutter应用让屏幕在 app 运行期间保持常亮的方法 江上清风山间明月 FlutterandroidiosflutterKeepAlive屏幕常亮wakelock熄屏
    文章目录Flutter应用让屏幕在app运行期间保持常亮的方法方法一：使用系统插件方法二：使用Widgets注意事项Flutter应用让屏幕在app运行期间保持常亮的方法在Flutter开发中，可以使用以下两种方法让屏幕在app运行期间保持常亮：方法一：使用系统插件Flutter社区中已经有很多相关插件可供使用，比如wakelock:https://pub.dev/packages/wakeloc
  • lodash插件 吃我一锅 一些插件
    安装npminstalllodash引入importorderByfrom'lodash/orderBy'使用orderBy(要排序的变量，要排序的字段，升序还是降序)//例如，评论按照点赞数量排序orderBy(lilst,'like','desc')
  • ES-LTR粗排模块 poins jenkins运维
    ES-LTR粗排模块官方资源：https://github.com/HeiBoWang/elasticsearch-learning-to-rankElasticsearch学习排名插件使用机器学习提高搜索相关性排名。它为维基媒体基金会和Snagajob等地方的搜索提供了动力！这个插件有什么功能此插件：允许您在Elasticsearch中存储特征（Elasticsearch查询模板）记录特征得分（
  • Ai插件脚本合集安装包，免费教程视频网盘分享 全网优惠分享君
    随着人工智能技术的不断发展，越来越多的插件脚本涌现出来，为我们的生活和工作带来了便利。然而，如何快速、方便地获取和使用这些插件脚本呢？今天，我将为大家分享一个非常实用的资源——AI插件脚本合集安装包，以及免费教程视频网盘分享。首先，让我们来了解一下这个AI插件脚本合集安装包。它是一个集合了众多AI插件脚本的资源包，涵盖了各种领域，如数据分析、自动化办公、智能客服等等。通过这个安装包，用户可以轻松地
  • flutter boost 如何从native跳转到flutter页面 Icarus_ flutterflutter
    FlutterBoost是一个Flutter插件，它可以帮助开发者在原生应用和Flutter应用之间无缝跳转。以下是一些基本步骤，展示了如何使用FlutterBoost从原生（Native）页面跳转到Flutter页面。1.配置FlutterBoost在你的Flutter项目中集成FlutterBoost插件。这通常涉及到修改`pubspec.yaml`文件来添加依赖项，并根据FlutterBoo
  • eclipse导入项目 warning报错 org.springframework.ide.eclipse.core.springnature zhangfeng1133 ideeclipsejava
    报错org.springframework.ide.eclipse.core.springnature报错信息"org.springframework.ide.eclipse.core.springnature"通常表示EclipseIDE中与Spring框架集成的插件出现了问题。这个错误可能是因为SpringIDE插件没有正确安装或配置，或者Eclipse的更新过程中出现了问题。解决方法：确认S
  • Pytest 自定义HOOK函数 咖啡加剁椒④ 软件测试pytestpython开发语言软件测试功能测试自动化测试程序人生
    除了系统提过的HOOK函数外，也可以通过自定义HOOK的方式实现想要的功能。首先创建一个py文件，里面定义自己的HOOK函数，主要pytest里面的hook函数必须以pytest开头。#myhook.pydefpytest_myhook(user):"""自定义HOOK函数"""defpytest_myhook2():"""自定义HOOK函数"""其次创建自己的插件类，user类的重写__init
  • html版本号 webpack_html-webpack-plugin详解 weixin_39994949 html版本号webpack
    引言最近在react项目中初次用到了html-webapck-plugin插件，用到该插件的两个主要作用：为html文件中引入的外部资源如script、link动态添加每次compile后的hash，防止引用缓存的外部文件问题可以生成创建html入口文件，比如单页面可以生成一个html文件入口，配置N个html-webpack-plugin可以生成N个页面入口有了这种插件，那么在项目中遇到类似上面
  • RockyLinux8 & RockyLinux9安装postgresql16-devel开发包 ynzhangyao postgresql
    1、PG的插件扩展有些需要自行编译，需要安装PG开发包2、RockyLinux8安装#创建用户先useraddpostgressudodnfinstall-yhttps://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpmsudodnf-qymoduledisa
  • webpack快速基础 风漫漫雨歇歇 webpackwebpack前端前端框架
    文章目录webpack快速基础1.概念1.1入口1.2输出(output)1.3loader1.4插件（plugin)2.建立项目，用于测试功能2.1安装webpack，2.2创建webpack配置文件,2.3配置package.json，运行项目3.配置mode开发环境4.配置entry编译入口5.配置output编译出口6.配置加载csswebpack快速基础1.概念webpack是现代Jav
  • 强大的文本编辑器：Sublime Text for Mac注册激活版 macw_q 后端
    SublimeTextforMac是一款功能强大的文本编辑器，特别适合程序员和开发者使用。它提供了丰富的功能，如智能代码补全、语法高亮、自定义快捷键、项目管理、多行选择、自动保存等，以提高代码编写效率和舒适度。此外，SublimeText还支持插件扩展，用户可以根据自己的需求安装各种插件，进一步增强编辑器的功能。软件下载：SublimeTextforMac注册激活版下载在Mac上使用Sublime
  • MyBatis面试专题 XMYX-0 面试mybatis面试职场和发展
    文章目录什么是MyBatis？讲下MyBatis的缓存一级缓存二级缓存Mybatis是如何进行分页的？分页插件的原理是什么？分页插件的原理举例说明简述Mybatis的插件运行原理，以及如何编写一个插件？插件运行原理编写一个插件的基本步骤Mybatis动态sql是做什么的？都有哪些动态sql？能简述一下动态sql的执行原理不？动态SQL的执行原理#{}和${}的区别是什么？为什么说Mybatis是半
  • idea中常见快捷键及插件操作 程序员老石 intellij-ideajavaide
    1、双击shift【万能】（1）输入pull，回车可以更新代码（2）输入commit，回车可以提交代码（3）输入history,可以查看提交记录（4）输入break，回车可以查看所有断点（5）输入类名，方法名，url地址都可以检索到2、安装EasyJavadoc插件（1）在方法上ctrl+\，自动生成方法的注释信息；（2）在类上ctrl+shift+\，自动生成类相关的注释信息3、安装Mybati
  • vue-pdf 预览pdf (数据流) reembarkation vue.jspdfjavascript
    页面有个要预览pdf的需求，数据是从后台传递过来的数据流：1.安装插件：npminstallvue-pdf2.在页面引用：importpdffrom'vue-pdf'...components:{pdf},3.html中添加：4.通过接口获取数据：downloadFile({id:this.id}).then((res)=>{if((!res&&res.status!=200)||(res.dat
  • elasticsearch同步mysql数据库神器之go-mysql-elasticsearch 强哥的博客 数据库
    go-mysql-elasticsearch是国内作者开发的一款插件。测试表明：该插件优点：能实现同步增、删、改、查操作。不足之处（待完善的地方）：1、日志不是很详细，但是能满足基本需求；2、初始化时，无法自动同步mysql中存在的以前的数据，需要自行解决初始导入（如重建索引批量导入）go-mysql-elasticsearch安装步骤1：安装goyuminstallgo步骤2：安装godepgo
  • 开发chrome扩展（ 禁止指定域名使用插件） 徐同保 chrome前端
    mainfest.json:{"manifest_version":3,"name":"ChatGPT学习","version":"0.0.2","description":"ChatGPT,GPT-4,Claude3,Midjourney,StableDiffusion,AI,人工智能,AI","icons":{"16":"./images/logo.png","48":"./images/lo
  • ppt插件构思 溢彩风华 powerpoint
    功能：1.编辑代码2.代码运行3.代码检查4.代码格式化5.运行简单的可视化、游戏化、交互式这是一个针对PPT（MicrosoftPowerPoint）的插件概念描述，该插件旨在提升PPT在演示编程相关内容时的功能丰富度。以下是这个插件的主要功能点：编辑代码：用户可以在PPT内部直接编写和修改代码片段，无需跳转到外部IDE（集成开发环境），方便快捷地展示编程过程或示例。代码运行：插件具备执行所编辑
  • 拖拽插件的使用（vue-draggable-resizable） Nancy哇 笔记vue.jsjavascript前端
    拖拽功能使用插件（vue-draggable-resizable）用于可拖动和可调整大小元素的Vue2组件。1.使用-安装插件依赖npminstall--savevue-draggable-resizable-在项目中引用importVueDraggableResizablefrom"vue-draggable-resizable";exportdefault{components:{VueDra
  • WordPress Plugin NotificationX插件 SQL注入漏洞复现（CVE-2024-1698） OidBoy_G 漏洞复现sqlweb安全安全
    0x01产品简介WordPress和WordPressplugin都是WordPress基金会的产品。WordPress是一套使用PHP语言开发的博客平台。该平台支持在PHP和MySQL的服务器上架设个人博客网站。0x02漏洞概述WordPresspluginNotificationX是一个应用插件。2.8.2版本及之前存在安全漏洞，该漏洞源于对用户提供的参数转义不充分以及对现有SQL查询缺乏充分
  • vite和webpack的区别 小王学前端️ vue3webpack前端javascript
    vite和webpack的区别从底层原理上来说，Vite是基于esbuild预构建依赖。而esbuild是采用go语言编写，因为go语言的操作是纳秒级别，而js是以毫秒计数，所以vite比用js编写的打包器快10-100倍。Vite和Webpack都是现代前端开发中的常见打包工具，但在实际使用过程中，它们存在五个主要区别：1.开发模式不同；2.打包效率不同；3.插件生态不同；4.配置复杂度不同；5
  • 【插件html2canvas】页面元素生成图片 不吃香菜的蟹老板 前端javascriptvue
    插件html2canvas将页面元素转换成图片点击【复制】按钮，将页面某个区域的内容以图片的形式复制到剪切板，粘贴后是一张图片。点击【下载】按钮，将页面某个区域的内容以图片的形式下载到本地。1安装插件npmihtml2canvas2目标页面元素html2canvas复制下载3核心逻辑3.1html2canvas绘制页面元素通过插件【html2canvas】转换成图片base64letcanvas=
  • jenkins指定jdk版本打包和运行项目 Grey_fantasy jenkinsjava
    背景：因为jdk8安装jenkins有很多插件有问题，导致很多自动化编译都有问题，所以我jenkins使用jdk11进行安装。全局变量配置了jdk11，直接一键式命令安装jdk8会导致jenkins异常。1、第一步，去下载jdk8版本解压。下载地址：https://repo.huaweicloud.com:8443/artifactory/java-local/jdk/8u181-b13/百度云链
  • Flask中session失效时间设置 忘了呼吸的那只猫
    最近需要使用Python开发web系统，主要用到的框架就是Flask，前端使用Jinja2模板引擎和Bootstrap，web容器使用Cherrypy，其中关于Login管理的使用了Flask-Login插件。基本上也是从零学起，前前后后花了有好几个月的时间，还是在借鉴了已有的一些项目基础上。在开发的过程中有很多的想法和体会，记录下来，有不对的地方欢迎大家指正。在处理登录管理的部分，在Flask-
  • vscode ctrl + s 保持时自动格式化 my木子
    安装插件eslintvetur在文件-首选项-设置中打开settings.json，复制以下内容{//vscode默认启用了根据文件类型自动设置tabsize的选项"editor.detectIndentation":false,//重新设定tabsize"editor.tabSize":2,//#每次保存的时候自动格式化"editor.formatOnSave":true,//#每次保存的时候将
  • 使用postcss-plugin-px2rem和postcss-pxtorem(postcss-px2rem)-px自动转换rem的配置方法-vue-cli3.0 JackieDYH Vuepx2remvuepx转换remrempostcss-px2rem
    在vue-cli3.0中使用postcss-plugin-px2rem插件插件的作用是自动将vue项目中的px转换为rempostcss-plugin-px2rem优势：因为postcss-plugin-px2rem这个插件配置选项上有exclude属性，它可以配置是否对某个文件夹下的所有css文件不进行从px到rem的转换。所以我们可以利用这个特性，把项目中的node_module文件夹排除掉。
  • 如何使用IDE端通义灵码 小邋遢2.0 json
    如何使用IDE端通义灵码第一步：安装IDE插件（VSCode和JetBrains二选一）如何下载安装VSCode：https://code.visualstudio.com如何下载安装JetBrains：https://www.jetbrains.com/idea/download第二步：如何在IDE里装通义灵码插件：通义灵码安装教程-阿里云
  • openGauss SQL引擎插件开发指导 openGaussMan sql数据库openGauss
    开发流程①在openGauss社区Plugin仓进行兼容性相关开发(openGauss/Plugin)②通过fastcheck自测以及CI门禁③提供checkin测试报告和开发文档并通过SIG组评审开发要点开放接口函数DLL_PUBLICPG_FUNCTION_INFO_V1_PUBLIC统一管理为了避免插件与内核同名函数所产生的符号冲突，我们在makefile中使用-fvisibility=hi
  • 关于k8s中 storageclass 的 is-default-sc 默认存储设置 网络飞鸥 Kuberneteskubernetes容器云原生
    为什么要改变默认存储类？取决于安装模式，你的Kubernetes集群可能和一个被标记为默认的已有StorageClass一起部署。这个默认的StorageClass以后将被用于动态的为没有特定存储类需求的PersistentVolumeClaims配置存储。更多细节请查看PersistentVolumeClaim文档。如果准入控制器插件被启用，则管理员可以设置一个默认的StorageClass。所
  • Maven的含义以及使用方法 北枫寒夜 mavenjava
    Maven的含义：Maven是一个项目管理工具，它主要用于Java项目的构建、依赖管理和项目信息管理。下面是一些Maven的核心含义及作用：项目对象模型（ProjectObjectModel，POM）：POM是Maven的核心概念，它是一个XML文件，描述了一个Maven项目的配置信息，包括项目的依赖、插件、构建目标等。坐标（Coordinates）：坐标用来唯一标识一个项目或者一个库，通常由gr
  • 【问题记录】Vue项目中input用v-model绑定数据不生效 虾仁不眨眼ok 问题记录vue
    HI，这里是富婆李姐，记录一些工作中遇到的bug问题复现1、首先用vue插件查看数据是否有值，发现问题：代码中的type是有值的，但是插件中的type是空字符串2、仔细查看代码，发现我写了两个type，最下面的type是空字符串，我一直在更改上面的type，浪费俺十分钟时间，吐了
  • 用MiddleGenIDE工具生成hibernate的POJO（根据数据表生成POJO类） AdyZhang POJOeclipseHibernateMiddleGenIDE
    推荐:MiddlegenIDE插件,   是一个Eclipse   插件.     用它可以直接连接到数据库,   根据表按照一定的HIBERNATE规则作出BEAN和对应的XML ，用完后你可以手动删除它加载的JAR包和XML文件!     今天开始试着使用
  • .9.png Cb123456 android
      “点九”是andriod平台的应用软件开发里的一种特殊的图片形式，文件扩展名为：.9.png 　　智能手机中有自动横屏的功能,同一幅界面会在随着手机(或平板电脑)中的方向传感器的参数不同而改变显示的方向,在界面改变方向后,界面上的图形会因为长宽的变化而产生拉伸,造成图形的失真变形。 　　我们都知道android平台有多种不同的分辨率，很多控件的切图文件在被放大拉伸后，边
  • 算法的效率 天子之骄 算法效率复杂度最坏情况运行时间大O阶平均情况运行时间
    算法的效率 效率是速度和空间消耗的度量。集中考虑程序的速度，也称运行时间或执行时间，用复杂度的阶(O)这一标准来衡量。空间的消耗或需求也可以用大O表示，而且它总是小于或等于时间需求。   以下是我的学习笔记：   1.求值与霍纳法则，即为秦九韶公式。   2.测定运行时间的最可靠方法是计数对运行时间有贡献的基本操作的执行次数。运行时间与这个计数成正比。
  • java数据结构 何必如此 java数据结构
    Java 数据结构 Java工具包提供了强大的数据结构。在Java中的数据结构主要包括以下几种接口和类： 枚举（Enumeration） 位集合（BitSet） 向量（Vector） 栈（Stack） 字典（Dictionary） 哈希表（Hashtable） 属性（Properties） 以上这些类是传统遗留的，在Java2中引入了一种新的框架-集合框架(Collect
  • MybatisHelloWorld 3213213333332132
    //测试入口TestMyBatis package com.base.helloworld.test; import java.io.IOException; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibat
  • Java|urlrewrite|URL重写|多个参数 7454103 javaxmlWeb工作
     个人工作经验！ 如有不当之处，敬请指点 1.0  web -info 目录下建立     urlrewrite.xml  文件 类似如下： <?xml version="1.0" encoding="UTF-8" ?>   <!DOCTYPE u
  • 达梦数据库+ibatis darkranger sqlmysqlibatisSQL Server
    --插入数据方面 如果您需要数据库自增... 那么在插入的时候不需要指定自增列. 如果想自己指定ID列的值, 那么要设置 set identity_insert  数据库名.模式名.表名; ----然后插入数据; example: create table zhabei.test( id bigint identity(1,1) primary key, nam
  • XML 解析 四种方式 aijuans android
    XML现在已经成为一种通用的数据交换格式,平台的无关性使得很多场合都需要用到XML。本文将详细介绍用Java解析XML的四种方法。 XML现在已经成为一种通用的数据交换格式,它的平台无关性,语言无关性,系统无关性,给数据集成与交互带来了极大的方便。对于XML本身的语法知识与技术细节,需要阅读相关的技术文献,这里面包括的内容有DOM(Document Object
  • spring中配置文件占位符的使用 avords
    1.类 <?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.o
  • 前端工程化-公共模块的依赖和常用的工作流 bee1314 webpack
    题记： 一个人的项目，还有工程化的问题嘛？   我们在推进模块化和组件化的过程中，肯定会不断的沉淀出我们项目的模块和组件。对于这些沉淀出的模块和组件怎么管理？另外怎么依赖也是个问题？ 你真的想这样嘛？   var BreadCrumb = require(‘../../../../uikit/breadcrumb’); //真心ugly。  
  • 上司说「看你每天准时下班就知道你工作量不饱和」，该如何回应？ bijian1013 项目管理沟通IT职业规划
    问题：上司说「看你每天准时下班就知道你工作量不饱和」，如何回应         正常下班时间6点，只要是6点半前下班的，上司都认为没有加班。   Eno-Bea回答，注重感受，不一定是别人的         虽然我不知道你具体从事什么工作与职业，但是我大概猜测，你是从事一项不太容易出现阶段性成果的工作
  • TortoiseSVN，过滤文件 征客丶 SVN
    环境： TortoiseSVN 1.8 配置： 在文件夹空白处右键 选择  TortoiseSVN -> Settings 在 Global ignote pattern 中添加要过滤的文件： 多类型用英文空格分开 *name ： 过滤所有名称为 name 的文件或文件夹 *.name ： 过滤所有后缀为 name 的文件或文件夹 --------
  • 【Flume二】HDFS sink细说 bit1129 Flume
    1. Flume配置   a1.sources=r1 a1.channels=c1 a1.sinks=k1 ###Flume负责启动44444端口 a1.sources.r1.type=avro a1.sources.r1.bind=0.0.0.0 a1.sources.r1.port=44444 a1.sources.r1.chan
  • The Eight Myths of Erlang Performance bookjovi erlang
    erlang有一篇guide很有意思： http://www.erlang.org/doc/efficiency_guide 里面有个The Eight Myths of Erlang Performance： http://www.erlang.org/doc/efficiency_guide/myths.html   Myth: Funs are sl
  • java多线程网络传输文件(非同步)-2008-08-17 ljy325 java多线程socket
    利用 Socket 套接字进行面向连接通信的编程。客户端读取本地文件并发送；服务器接收文件并保存到本地文件系统中。 使用说明:请将TransferClient, TransferServer, TempFile三个类编译，他们的类包是FileServer. 客户端: 修改TransferClient: serPort, serIP, filePath, blockNum,的值来符合您机器的系
  • 读《研磨设计模式》-代码笔记-模板方法模式 bylijinnan java设计模式
    声明： 本文只为方便我个人查阅和理解，详细的分析以及源代码请移步 原作者的博客http://chjavach.iteye.com/ import java.sql.Connection; import java.sql.DriverManager; import java.sql.PreparedStatement; import java.sql.ResultSet;
  • 配置心得 chenyu19891124 配置
    时间就这样不知不觉的走过了一个春夏秋冬，转眼间来公司已经一年了，感觉时间过的很快，时间老人总是这样不停走，从来没停歇过。 作为一名新手的配置管理员，刚开始真的是对配置管理是一点不懂，就只听说咱们公司配置主要是负责升级，而具体该怎么做却一点都不了解。经过老员工的一点点讲解，慢慢的对配置有了初步了解，对自己所在的岗位也慢慢的了解。 做了一年的配置管理给自总结下： 1.改变 从一个以前对配置毫无
  • 对“带条件选择的并行汇聚路由问题”的再思考 comsci 算法工作软件测试嵌入式领域模型
    2008年上半年，我在设计并开发基于”JWFD流程系统“的商业化改进型引擎的时候，由于采用了新的嵌入式公式模块而导致出现“带条件选择的并行汇聚路由问题”(请参考2009-02-27博文)，当时对这个问题的解决办法是采用基于拓扑结构的处理思想，对汇聚点的实际前驱分支节点通过算法预测出来，然后进行处理，简单的说就是找到造成这个汇聚模型的分支起点，对这个起始分支节点实际走的路径数进行计算，然后把这个实际
  • Oracle 10g 的clusterware 32位 下载地址 daizj oracle
    Oracle 10g 的clusterware 32位 下载地址 http://pan.baidu.com/share/link?shareid=531580&uk=421021908 http://pan.baidu.com/share/link?shareid=137223&uk=321552738 http://pan.baidu.com/share/l
  • 非常好的介绍：Linux定时执行工具cron dongwei_6688 linux
    Linux经过十多年的发展，很多用户都很了解Linux了，这里介绍一下Linux下cron的理解，和大家讨论讨论。cron是一个Linux 定时执行工具，可以在无需人工干预的情况下运行作业，本文档不讲cron实现原理，主要讲一下Linux定时执行工具cron的具体使用及简单介绍。 新增调度任务推荐使用crontab -e命令添加自定义的任务（编辑的是/var/spool/cron下对应用户的cr
  • Yii assets目录生成及修改 dcj3sjt126com yii
    assets的作用是方便模块化，插件化的，一般来说出于安全原因不允许通过url访问protected下面的文件，但是我们又希望将module单独出来，所以需要使用发布，即将一个目录下的文件复制一份到assets下面方便通过url访问。 assets设置对应的方法位置 \framework\web\CAssetManager.php   assets配置方法 在m
  • mac工作软件推荐 dcj3sjt126com mac
    mac上的Terminal + bash ＋ screen组合现在已经非常好用了，但是还是经不起iterm＋zsh＋tmux的冲击。在同事的强烈推荐下，趁着升级mac系统的机会，顺便也切换到iterm＋zsh＋tmux的环境下了。 我为什么要要iterm2 切换过来也是脑袋一热的冲动，我也调查过一些资料，看了下iterm的一些优点： * 兼容性好，远程服务器 vi 什么的低版本能很好兼
  • Memcached(三)、封装Memcached和Ehcache frank1234 memcachedehcachespring ioc
    本文对Ehcache和Memcached进行了简单的封装，这样对于客户端程序无需了解ehcache和memcached的差异，仅需要配置缓存的Provider类就可以在二者之间进行切换，Provider实现类通过Spring IoC注入。 cache.xml <?xml version="1.0" encoding="UTF-8"?>
  • Remove Duplicates from Sorted List II hcx2013 remove
    Given a sorted linked list, delete all nodes that have duplicate numbers, leaving only distinct numbers from the original list. For example,Given 1->2->3->3->4->4->5,
  • Spring4新特性——注解、脚本、任务、MVC等其他特性改进 jinnianshilongnian spring4
    Spring4新特性——泛型限定式依赖注入 Spring4新特性——核心容器的其他改进 Spring4新特性——Web开发的增强 Spring4新特性——集成Bean Validation 1.1(JSR-349)到SpringMVC  Spring4新特性——Groovy Bean定义DSL Spring4新特性——更好的Java泛型操作API  Spring4新
  • MySQL安装文档 liyong0802 mysql
      工作中用到的MySQL可能安装在两种操作系统中，即Windows系统和Linux系统。以Linux系统中情况居多。   安装在Windows系统时与其它Windows应用程序相同按照安装向导一直下一步就即，这里就不具体介绍，本文档只介绍Linux系统下MySQL的安装步骤。   Linux系统下安装MySQL分为三种：RPM包安装、二进制包安装和源码包安装。二
  • 使用VS2010构建HotSpot工程 p2p2500 HotSpotOpenJDKVS2010
    1. 下载OpenJDK7的源码：      http://download.java.net/openjdk/jdk7      http://download.java.net/openjdk/      2. 环境配置     ▶
  • Oracle实用功能之分组后列合并 seandeng888 oracle分组实用功能合并
    1       实例解析 由于业务需求需要对表中的数据进行分组后进行合并的处理，鉴于Oracle10g没有现成的函数实现该功能，且该功能如若用JAVA代码实现会比较复杂，因此，特将SQL语言的实现方式分享出来，希望对大家有所帮助。如下： 表test 数据如下： ID,SUBJECTCODE,DIMCODE,VALUE 1&nbs
  • Java定时任务注解方式实现 tuoni javaspringjvmxmljni
    Spring 注解的定时任务，有如下两种方式： 第一种： <?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans"  xmlns:xsi="http
  • 11大Java开源中文分词器的使用方法和分词效果对比 yangshangchuan word分词器ansj分词器Stanford分词器FudanNLP分词器HanLP分词器
    本文的目标有两个： 1、学会使用11大Java开源中文分词器 2、对比分析11大Java开源中文分词器的分词效果 本文给出了11大Java开源中文分词的使用方法以及分词结果对比代码，至于效果哪个好，那要用的人结合自己的应用场景自己来判断。 11大Java开源中文分词器，不同的分词器有不同的用法，定义的接口也不一样，我们先定义一个统一的接口： /** * 获取文本的所有分词结果, 对比
按字母分类： ABCDEFGHIJKLMNOPQRSTUVWXYZ其他