Key Auth 中间件

Key Auth 中间件提供了一个基于 key 的验证方式。

  • 对于有效的 key，它将调用下一个处理程序。
  • 对于无效的 key，它发送”401 - Unauthorized”的响应。
  • 对于空的 key，它发送”400 - Bad Request”。

使用

  1. e.Use(middleware.KeyAuth(func(key string) bool {
  2.   return key == "valid-key"
  3. }))

自定义配置

使用

  1. e := echo.New()
  2. e.Use(middleware.KeyAuthWithConfig(middleware.KeyAuthConfig{
  3.   KeyLookup: "query:api-key",
  4. }))

配置

  1. // KeyAuthConfig defines the config for KeyAuth middleware.
  2. KeyAuthConfig struct {
  3.   // Skipper defines a function to skip middleware.
  4.   Skipper Skipper
  6.   // KeyLookup is a string in the form of "<source>:<name>" that is used
  7.   // to extract key from the request.
  8.   // Optional. Default value "header:Authorization".
  9.   // Possible values:
  10.   // - "header:<name>"
  11.   // - "query:<name>"
  12.   KeyLookup string `json:"key_lookup"`
  14.   // AuthScheme to be used in the Authorization header.
  15.   // Optional. Default value "Bearer".
  16.   AuthScheme string
  18.   // Validator is a function to validate key.
  19.   // Required.
  20.   Validator KeyAuthValidator
  21. }

默认配置

  1. DefaultKeyAuthConfig = KeyAuthConfig{
  2.   Skipper:    defaultSkipper,
  3.   KeyLookup:  "header:" + echo.HeaderAuthorization,
  4.   AuthScheme: "Bearer",
  5. }