# 概述

认证信息管理用于维护认证信息数据。认证信息是在发送请求时候，附带于请求头、Query参数上，会作为请求参数传递给后台。

# 认证信息列表

菜单位置：文档管理 > 认证信息管理。点击菜单后进入认证信息列表页面，如图所示。

manager_document_authentication_list_query

# 新增认证信息

点击 新增 按钮弹出新增页面，如图所示。

manager_document_authentication_add_1

manager_document_authentication_add_2

名称：认证信息名称，必填；
描述：认真信息描述；
请求头认证信息：包括 参数名、是否必填、描述、示例值；
Query参数认证信息： 包括 参数名、是否必填、描述、示例值；

# 编辑认证信息

点击 编辑 按钮弹出编辑页面，如图所示。

manager_document_authentication_edit_1

manager_document_authentication_edit_2

# 函数使用

版本要求：v3.2或以上版本

如果需要在认证信息添加函数，可以使用语法:

{{ 函数调用 }}

函数相关文档请参考：内置函数列表>>

示例：

fizz-appid: {{env.appAuth["fizz-appid"] || "备用fizz-appid，建议对该fizz-appid进行限制"}}
fizz-ts: {{fn.date.timestamp()}}
fizz-sign: {{fn.codec.md5(env.appAuth["fizz-appid"]+"_"+fn.date.timestamp()+"_"+env.appAuth["fizz-secret"])}}

函数可以进行嵌套使用，但是无法嵌套引用变量。如在header中有：

引用成功示例

fizz-appid: {{env.appAuth["fizz-appid"] || "备用fizz-appid，建议对该fizz-appid进行限制"}}
fizz-secret: {{env.appAuth["fizz-secret"] || "备用fizz-secret，建议对该fizz-secret进行限制"}}
fizz-sign:  {{fn.codec.md5(headers["fizz-appid"]+"_"+fn.date.timestamp()+"_"+headers["fizz-secret"])}}

引用失败示例

fizz-appid: "示例fizz-appid"
fizz-secret: "示例fizz-secret"
fizz-sign:  {{fn.codec.md5(headers["fizz-appid"]+"_"+fn.date.timestamp()+"_"+headers["fizz-secret"])}}

函数可以使用的环境变量有：

{
    env: {
        appAuth: {
            fizz-appid: "fizz-appid",
            fizz-secret: "fizz-secret"
        },
        reqUrl: "http://127.0.0.1",
        env: "生产环境"
    },
    headers: {

    },
    query: {

    },
    body: {

    }
}

# 删除认证信息

点击 “删除” 按钮弹出删除确认窗口，如图所示。
注意： 如果认证信息存在关联的文档时，需要将关联的文档全部删除后才能删除该认证信息。

manager_document_authentication_delete_1

manager_document_authentication_delete_2

← 环境信息 →