如何在React中为Azure QnA Bot构建自定义UI并实现安全调用
完整实现流程(从Token生成到React接入)
核心原则:Bot密钥绝对不能泄露到前端静态代码里,必须通过后端服务生成临时访问Token,前端仅调用后端接口获取Token后再初始化Web Chat组件,全程不会暴露密钥。
1. 后端生成临时Token(以Node.js为例,其他后端语言逻辑一致)
// 后端接口逻辑,注意把这部分部署在你的服务端,绝对不要暴露给前端 const axios = require('axios'); const BOT_SECRET = '你在Azure Portal获取的Bot密钥'; const BOT_ID = '你的Azure Bot ID'; // 给前端暴露的获取Token接口 async function getBotToken(req, res) { try { const response = await axios.post( 'https://webchat.botframework.com/api/tokens', {}, { headers: { Authorization: `Bearer ${BOT_SECRET}`, 'Content-Type': 'application/json' } } ); // 返回临时Token给前端,这个Token有效期1小时 res.json({ token: response.data }); } catch (err) { res.status(500).json({ error: '获取Token失败' }); } }
2. React前端集成botframework-webchat
首先安装依赖:npm install botframework-webchat 或者 yarn add botframework-webchat
组件代码示例:
import React, { useState, useEffect } from 'react'; import ReactWebChat from 'botframework-webchat'; const QnAChatBot = () => { const [token, setToken] = useState(''); // 组件挂载时从自己的后端获取Token,不要直接调用Azure的Token接口! useEffect(() => { const fetchToken = async () => { try { // 这里调用你自己后端的Token接口,不是直接调用Bot Framework的接口 const res = await fetch('/api/get-bot-token'); const data = await res.json(); setToken(data.token); } catch (err) { console.error('获取Bot Token失败', err); } }; fetchToken(); }, []); return ( <div style={{ height: '600px', width: '400px' }}> {token ? ( <ReactWebChat directLine={{ token }} // 可以自定义样式、用户ID、用户名等参数 userID='自定义用户ID' username='访客' /> ) : ( <p>聊天组件加载中...</p> )} </div> ); }; export default QnAChatBot;
注意事项
- 生成的临时Token有效期为1小时,可根据业务需求增加定时刷新逻辑,在Token过期前重新调用后端接口获取新Token替换即可
- 后端的Token获取接口建议增加权限校验,比如校验用户登录态,避免接口被恶意调用消耗Bot服务配额
- 本地调试阶段如果暂时没有后端,可以临时用脚本本地生成Token复制到前端测试,正式上线必须走后端生成Token的逻辑,绝对不能把Bot密钥硬编码在前端代码或者构建产物里
内容的提问来源于stack exchange,提问作者Sharvani
相关产品推荐
相关产品推荐

