<p class="shortdesc">Kong网关基础认证功能启动。</p> <section class="section" id="basic-auth__section_gcw_b5c_fsb"><h2 class="doc-tairway">使用说明</h2> <ol class="ol" id="basic-auth__ol_htf_d5c_fsb"> <li class="li">需要先创建consumer，consumer类似是一个用户。</li> <li class="li">需要创建Basic认证信息，认证信息关联一个consumer。<p class="p">前端在访问时需要在header中设置authorization或者proxy-authorization。</p><p class="p">格式如：Authorization: Basic base64(认证用户名：认证密码)</p><p class="p">示例如：Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l</p></li> </ol> </section> <section class="section" id="basic-auth__section_jsb_f5c_fsb"><h2 class="doc-tairway">配置参数说明</h2> <div class="p"> <table class="table" id="basic-auth__table_sm5_g5c_fsb"><caption></caption><colgroup><col style="width:20.298507462686572%"><col style="width:17.611940298507463%"><col style="width:14.92537313432836%"><col style="width:15.074626865671645%"><col style="width:32.08955223880597%"></colgroup><thead class="thead"> <tr class="row"> <th class="entry align-left" id="basic-auth__table_sm5_g5c_fsb__entry__1">参数名</th> <th class="entry align-left" id="basic-auth__table_sm5_g5c_fsb__entry__2">参数类型</th> <th class="entry align-left" id="basic-auth__table_sm5_g5c_fsb__entry__3">是否必须</th> <th class="entry align-left" id="basic-auth__table_sm5_g5c_fsb__entry__4">默认值</th> <th class="entry align-left" id="basic-auth__table_sm5_g5c_fsb__entry__5">参数说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__1 ">anonymous</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__2 ">string</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__3 ">N</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__4 "></td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__5 ">consumer id，如果认证失败会以这个consumer id为访问用户</td> </tr> <tr class="row"> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__1 ">hide_credentials</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__2 ">boolean</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__4 ">false</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__5 ">是否向后端服务隐藏认证Header。默认是false不隐藏。即前端传入的header会透传到后端服务。</td> </tr> <tr class="row"> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__1 ">whitelist</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__2 ">array</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__3 ">N</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__4 ">{}</td> <td class="entry align-left" headers="basic-auth__table_sm5_g5c_fsb__entry__5 ">即哪些认证用户名才可以认证。为空则是所有认证用户名都可以认证。此属性适用于对外公开接口时，可以针对不同渠道发放不同的认证用户（1.3.5及以上版本支持）</td> </tr> </tbody></table> </div> </section> <section class="section" id="basic-auth__section_knp_h5c_fsb"><h2 class="doc-tairway">配置示例</h2> <p class="p"><img class="image" id="basic-auth__image_vhj_l5c_fsb" src="https://obs-cn-shanghai.fincloud.pinganyun.com/pacloud/20220910180811-16762982966a.png" width="800"></p> </section>