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插件向导)

  • Python爬虫解析工具之xpath使用详解 eqa11 python爬虫开发语言
    文章目录Python爬虫解析工具之xpath使用详解一、引言二、环境准备1、插件安装2、依赖库安装三、xpath语法详解1、路径表达式2、通配符3、谓语4、常用函数四、xpath在Python代码中的使用1、文档树的创建2、使用xpath表达式3、获取元素内容和属性五、总结Python爬虫解析工具之xpath使用详解一、引言在Python爬虫开发中，数据提取是一个至关重要的环节。xpath作为一门
  • ExpRe[25] bash外的其它shell：zsh和fish tritone ExpRebashlinuxubuntushell
    文章目录zsh基础配置实用特性插件`autojump`语法高亮自动补全fish优点缺点时效性本篇撰写时间为2021.12.15，由于计算机技术日新月异，博客中所有内容都有时效和版本限制，具体做法不一定总行得通，链接可能改动失效，各种软件的用法可能有修改。但是其中透露的思想往往是值得学习的。本篇前置：ExpRe[10]Ubuntu[2]准备神秘软件、备份恢复软件https://www.cnblogs
  • 解决Obsidian写笔记中的＜img＞标签无法显示图片的问题 全能全知者 笔记
    Obsidian中写md笔记如果使用标签会显示不出图案，后来才知道因为Obsidian的问题导致只能用绝对路径定位。所以我本人写了一个py插件，将md笔记里的img标签批量替换成Obsidian能够读取的形式。安装FixObsImgDpy:pipinstallFixObsImgDpy安装完成后在需要修复的md文件的父目录下运行命令:FixObsImgDpy就会自动修复父目录以下的全部md文件 仓库
  • 【算法练习】IDEA集成leetcode插件实现快速刷 2401_84102892 2024年程序员学习算法intellij-idealeetcode
    ============点击右侧边leetcode->设置->配置地址、用户名、密码、存放目录、文件模板用户名要登录后在账号信息里看模板代码1.codefilename!velocityTool.camelC
  • 使用datepicker和uploadify的冲突解决（IE双击才能打开附件上传对话框） zhanglb12
    在开发的过程当中，IE的兼容无疑是我们的一块绊脚石，在我们使用的如期的datepicker插件和使用上传附件的uploadify插件的时候，两者就产生冲突，只要点击过时间的插件，uploadify上传框要双才能打开ie浏览器提示错误Missinginstancedataforthisdatepicker解决方案//if(.browser.msie&&'9.0'===.browser.version
  • uniapp使用内置地图选择插件，实现地址选择并在地图上标点 神夜大侠 Uniappvue.jsuniapp
    uniapp使用内置地图选择插件，实现地址选择并在地图上标点代码如下：page{background:#F4F5F6;}::-webkit-scrollbar{width:0;height:0;color:transparent;}page{height:100%;width:100%;font-size:24rpx;}image,view,input,textarea,label,text,na
  • sublime个人设置 bawangtianzun sublimetext编辑器
    如何拥有jiangly蒋老师同款编译器(sublimec++配置竞赛向）_哔哩哔哩_bilibiliSublimeText4的安装教程（新手竞赛向）-知乎(zhihu.com)创建文件自动保存为c++打开SublimeText软件。转到"Tools"（工具）>"Developer"（开发者）>"NewPlugin"（新建插件）。在打开的新文件中，粘贴以下代码：importsublimeimport
  • vue2实现复制,粘贴功能 周bro vue.jsjavascript前端
    一、需求说明在项目中点击按钮复制某行文本是很常见的应用场景，在Vue项目中实现复制功能需要借助vue-clipboard2插件。二、代码实现1、安装vue-clipboard2依赖（出现错误的话，可以试试切换成淘宝镜像源npmconfigsetregistryhttps://registry.npm.taobao.org）npminstall--savevue-clipboard22、在main.
  • idea使用自定义checkstyle.xml配置文件 Gemkey
    1.下载插件image.png2.插件安装完后,找到设置中的checkstyle,点击"+",新增自定义规则image.png3.输入描述信息,点击Browse找到对应的文件image.pngimage.png4.可以把active勾上,则使用默认校验规则,点击OK,则可以开始使用自定义规则检测单个文件了image.png
  • maven-assembly-plugin 打包实例 带着二娃去遛弯
    1.先在pom.xml文件中添加assembly打包插件org.apache.maven.pluginsmaven-assembly-plugin2.6assembly/assembly.xmlmake-assemblypackagesingle说明:1.需要修改的可能就是descriptors标签下面的打包配置文件目录,指定assembly.xml的路径.2.可以添加多个打包配置文件,进行多种形
  • 访问网站被限制怎么办 Bearjumpingcandy 服务器运维
    访问网站被限制的情况下，可以通过以下几种方法来解决：检查是否安装了第三方查询软件或插件：有些第三方软件或插件可能会引起非人为的、高频次的访问系统而被限制访问。可以尝试卸载或禁用这些软件或插件，然后重新尝试访问网站。检查共用公网IP地址内的其他电脑：如果用户电脑所处的共用公网IP地址内的其他电脑存在机器访问行为，多次触发禁止访问规则，就会造成该公网IP地址被禁止访问。可以尝试与网络管理员联系，请求解
  • UI 自动化的页面对象管理神器 PO-Manager TesterHome
    原文由alex发表于TesterHome社区网站，点击原文链接可于作者直接交流。做UI自动化的同学都知道，UI自动化一个难点就是页面元素的变化，让自动化维护成为一个痛点。在此，为了减轻这个痛点，我在基于Page-Object模式的基础上开发了页面对象维护的工具。该工具为vscode的一个插件，可以通过vscode插件市场搜索PO-Manager来下载安装本文中的页面对象库文件基于json.一个元素
  • Sentinel实时监控不展示问题 朱杰jjj sentinelsentinel
    问题官方插件Endpoint支持，可以实时统计出SpringBoot的健康状况和请求的调用信息在使用Endpoint特性之前需要在Maven中添加spring-boot-starter-actuator依赖，并在配置中允许Endpoints的访问。SpringBoot1.x中添加配置management.security.enabled=false。暴露的endpoint路径为/sentinelS
  • 服务器状态监控php源码,服务器状态监控_监控Linux服务器网站状态的SHELL脚本 温糯米 服务器状态监控php源码
    摘要腾兴网为您分享:监控Linux服务器网站状态的SHELL脚本，蜗牛集市，同花顺，探客宝，手柄助手等软件知识，以及日期倒计时插件，云南省教育资源公共，rui手机桌面，小屁孩桌面便签，合金装备崛起复仇，朝夕日历，photoshop图像处理软件,一年级学生每日计划表，悟空找房，饿了吗外卖商家版，逃生，中国民宿网，realpolitiks，交通安全知识竞赛，雅思流利说等软件it资讯，欢迎关注腾兴网。1
  • 以太坊DApp开发指南 Kirn
    DApp架构设计DApp架构.png如上图，DApp的架构我们可以简单分为以上三种类型：轻钱包模式、重钱包模式和兼容模式。轻钱包模式轻钱包模式下我们需要有一个开放HttpRPC协议的节点与钱包通信，这个节点可以是任意链上的节点。轻钱包通常会作为一个浏览器插件存在，插件在运行时会自动注入Web3框架，DApp可以通过Web3与区块链节点通信。当DApp只是单纯的获取数据时是不需要钱包介入的，但是当D
  • Hexo框架Ayer主题搭建我的博客 @HZY giteehexoayerblog个人网站
    关于Hexoayer主题搭建Blog我的博客链接，欢迎来访:[RainのBlog](https://hzyqaqgitee.gitee.io/raining).https://hzyqaqgitee.gitee.io/raining使用的框架、插件Hexo常用命令页面展示我的博客链接，欢迎来访:RainのBlog.https://hzyqaqgitee.gitee.io/raining使用Hexo
  • Zotero引文计数插件使用教程 齐飞锴Timothea
    Zotero引文计数插件使用教程zotero-citationcountsZoteropluginforauto-fetchingcitationcountsfromvarioussources项目地址:https://gitcode.com/gh_mirrors/zo/zotero-citationcounts项目介绍Zotero引文计数插件是由非盈利组织DigitalScholarshipCo
  • html打开本地excel文件夹,html使用excel表格数据库-html读取本地excel文件并展示 睿理
    html表格如何导入到excel中在vs里面用添加数据源就可以啊,再使用数据控件,就可以操作.添加数据源可以用odbc数据源,两种方式1,是在控制面板的管理工具里在ODBC里先设置好.2,是使用连接字符串.用vs的添加数据源向导做.html中有没有类似excel表格，可以填数的表格控件？首先html不能读取本地excel文件其次就算是javascript也是不允许的这是为了安全考虑如果前端脚本可以
  • PyCharm配置及使用Git教程_pycharm配置git(2) 2401_84182146 程序员pycharmgitelasticsearch
    文章目录1.安装PyCharm2.安装Git3.在PyCharm中配置Git插件4.连接远程仓库5.Clone项目代码6.将本地文件提交到远程仓库6.1gitadd6.2gitcommit6.3gitpush6.4gitpull7.代码回滚8.分支操作8.1新建分支8.2切换分支8.3合并分支
  • K8S学习笔记02——K8S组件 沉淅尘 #Docker#K8Skubernetes
    Kubernetes组件一、控制平面组件（ControlPlaneComponents）(1)kube-apiserver(2)etcd(3)kube-scheduler(4)kube-controller-manager(5)cloud-controller-manager二、Node组件1.kubelet2.kube-proxy3.容器运行时（ContainerRuntime）三、插件（Add
  • 摄影家天堂新都桥 一头笨牛的备忘录
    作为川西高原上知名度较高的摄影天堂，队友不太严重的高反还是令大家担心，特此修整一天观察身体状况。一言不合就拍照高原早晨的空气湿润冷凉，吃过早饭，由本地的藏族大叔作向导，带我们游览小镇。秋季的新都桥是摄影家的天堂，夏天虽然不是最好的季节，但还是要感谢不曾错过的风景。格桑花格桑花风景几乎也都有了相对固定的游览路线，藏族大叔轻车熟路，沿途走走停停，感受光与影的世界。藏族大哥沿途介绍风景，兼及讲些当地的风
  • elementUI table排序 sortable Artsman 前端开发技术elementui前端javascript前端框架
    使用elementUI做后台程序时非常便利，但有时，插件的用法也会让人头疼。在列中设置sortable属性即可实现以该列为基准的排序，接受一个Boolean，默认为false。可以通过Table的default-sort属性设置默认的排序列和排序顺序。可以使用sort-method或者sort-by使用自定义的排序规则。如果需要后端排序，需将sortable设置为custom，同时在Table上监
  • webpack插件开发必会Tapable web老猴子 webpack前端javascript
    认识Tapable官方对tapable的定义是钩子，业界很多写tapable的觉得它是发布订阅模式，它确实很像发布订阅模式，但是不完全是，至于官方说的钩子，个人感觉在webpack内部可以称作钩子，因为是官方定义的，所以肯定是按照设计的想法来使用的，如果是你自己使用，操作不当可能就不是钩子了，毕竟只是一个工具，你拿扳手当锤子也没人说你什么，以上是个人见解，下面附上一些验证的思路。不喜欢论证，喜欢看
  • webpack的插件机制(Tapable) 若梦plus 前端工程化webpack前端
    webpack的插件机制(Tapable)在具体介绍webpack内置插件与钩子可视化工具之前，我们先来了解一下webpack中的插件机制。webpack实现插件机制的大体方式是：创建-webpack在其内部对象上创建各种钩子；注册-插件将自己的方法注册到对应钩子上，交给webpack；调用-webpack编译过程中，会适时地触发相应钩子，因此也就触发了插件的方法。Webpack本质上是一种事件流
  • vue 生成PDF(A4标准PDF分页) qq_39016177 HTML2CanvasjsPDF导出PDF转换DOM操作
    1.先安装两个插件//页面转图片npminstall--savehtml2canvas//图片转PDFnpminstalljspdf--save 2.在需要导出的dom节点增加ref='pdf'例如  这是待转换的页面，点击导出点击导出PDF3.定义导出方法handleExport(){   downloadPDF(this.$refs.pdf);},4.在页面导入 import{download
  • 四、webpack4.0 - tapable Razas WEBPACK4webpack4.0
    一、tapable介绍webpack中插件的时候，需要用到tapable。新建一个项目WEBPACK-Tapable。初始化package.json:npminit-y安装：npminstalltapable--savetapable是一个包。二、tapable三、AsyncParralleHook四、AsyncSeriesHook五、AsyncSeriesWaterfall
  • PostgreSQL进阶教程 爱分享的码瑞哥 postgresql
    PostgreSQL进阶教程目录事务和并发控制事务事务隔离级别锁高级查询联合查询窗口函数子查询CTE（公用表表达式）数据类型自定义数据类型数组JSON高级索引部分索引表达式索引GIN和GiST索引性能调优查询优化配置优化备份与恢复物理备份逻辑备份扩展与插件PostGISpg_cron集群与高可用StreamingReplicationPatroni事务和并发控制事务事务是一个或多个SQL语句的组合
  • tapable详解 风火一回 webpacktapablewebpack插件制作
    tapable详解tapable是webpack内部使用的一个流程管理工具，主要用来串联插件，完善事件流执行。1.安装tapableyarnaddtapable2.常用hooksimport{SyncHook,SyncBailHook,SyncWaterfallHook,SyncLoopHook,AsyncParallelHook,AsyncParallelBailHook,AsyncSeries
  • 前端同学必备：教你如何安装、使用Chrome的vue-devtools插件 界忆 前端编程Vue-devtools插件chromedevtools
    I.介绍vue-devtools插件Vue-devtools是一个Chrome浏览器插件，它是一个浏览器调试工具，用于开发Vue.js应用程序。它可以用于Vue.js应用程序的调试，可以更好地了解应用程序的结构和状态，以及帮助快速修复代码错误。Vue-devtools插件的作用和优势如下：1.调试Vue.js应用程序：Vue-devtools是一个强大的调试工具，可以帮助开发人员正确地调试应用程序
  • Tapable 信海利世 webpackwebpack前端
    一、Tapable是什么？Tapable是一个类似于Node.js的EventEmitter的库,主要是控制钩子函数的发布与订阅,控制着webpack的插件系统。Tapable库暴露了很多Hook（钩子）类，为插件提供挂载的钩子const{SyncHook,//同步钩子SyncBailHook,//同步熔断钩子即return一个非undefined的值，则不再继续执行后面的监听函数SyncWate
  • 用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其他