Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La seguridad de canales Web y Direct Line controla si los clientes deben proporcionar un secreto o token de Direct Line para conectarse con su agente de Copilot Studio. Sin acceso seguro, cualquiera que conozca el ID del agente puede conectarse a través de la web de demostración y los canales de la web personalizada .
Note
En la experiencia solo de Teams, no puedes generar secretos. Los tokens de acceso seguro se crean automáticamente y el acceso seguro está activado por defecto. Para los requisitos de licencia, consulte los Términos de Producto de Microsoft.
Activar Requerir acceso seguro para exigir a los clientes que presenten un secreto o token. Estas credenciales autorizan el acceso al canal Direct Line; no autentican al usuario final ni restringen el acceso a un sitio web concreto por sí mismas. Configura la autenticación de usuarios por separado cuando los usuarios necesiten iniciar sesión.
Puedes cambiar y regenerar secretos, tokens de actualización o desactivar el acceso seguro cuando ya no sea necesario.
Copilot Studio usa Bot Framework Direct Line canal para conectar la página web o la aplicación al agente.
Activa o desactiva la seguridad del canal web
Puede forzar el uso de secretos y tokens para cada agente individual.
Al activar esta opción, los canales necesitan que el cliente autentique sus solicitudes mediante un secreto o mediante un token que se genera mediante el secreto, obtenido en tiempo de ejecución.
Los intentos de acceder al agente que no proporcionan esta medida de seguridad no funcionan.
Vaya a la página Configuración del agente, seleccione Seguridad y, a continuación, seleccione Seguridad del canal web.
Active Requerir acceso seguro.
Warning
Cuando activas o desactivas Require secured access, puede tardar hasta dos horas en entrar en vigor la nueva configuración del sistema. Hasta entonces, la configuración anterior está en vigor. No es necesario publicar el agente para que este cambio surta efecto.
Planee con antelación para evitar exponer el agente involuntariamente.
Para desactivar la seguridad del canal web, desactiva Requerir acceso seguro y confirma el cambio. El cambio puede tardar hasta dos horas en hacer efecto.
Utilizar secretos o tokens
Para una aplicación de servicio a servicio, especifica el secreto en la cabecera de autorización de las solicitudes de tu servicio.
Si va a escribir una aplicación en la que el cliente se ejecuta en un explorador web o una aplicación móvil, o en la que el código pueda ser visible para los clientes, debe intercambiar su secreto por un token. Si no usa un token, el secreto puede verse comprometido. Al realizar la solicitud para obtener el token en el servicio, especifique el secreto en el encabezado de autorización.
Los tokens solo funcionan para una conversación individual, y expiran a menos que se actualicen.
Elija el modelo de seguridad que mejor se adapte a su situación.
Warning
No exponga el secreto en ningún código que se ejecute en el explorador, ya sea codificado de forma rígida o transferido a través de una llamada de red.
La adquisición del token mediante el secreto en el código de servicio es la manera más segura de proteger el agente de Copilot Studio.
Obtener los secretos
Necesitará el secreto para poder especificarlo en las solicitudes de encabezado de autorización de su aplicación o similares.
En el menú de navegación, en Configuración, seleccione Seguridad. A continuación, seleccione el icono Seguridad del canal web.
Seleccione Copiar para Secreto 1 o Secreto 2, para copiarlo al portapapeles. Para revelar el secreto, selecciona el icono de visibilidad y revisa el mensaje de advertencia.
Intercambiar claves secretas
Si necesita cambiar el secreto que usa el agente, puede cambiarlo sin tiempo de inactividad ni interrupción.
Copilot Studio proporciona dos secretos, que funcionan simultáneamente. Puede intercambiar el secreto que usa el agente con el otro secreto. Una vez intercambiados los secretos y todos los usuarios están conectados mediante el nuevo secreto, puede volver a generar el secreto.
Regenerar un secreto
Para regenerar un secreto, seleccione Regenerar junto al secreto.
Warning
El perfil de usuario que se conecta mediante el secreto original o un token obtenido de ese secreto está desconectado.
Generar un símbolo
Puedes generar un token para iniciar una conversación con un solo agente. Este procedimiento intercambia un secreto de Direct Line por un token de conversación en tu código de servicio. Para la opción de endpoint de token de Copilot Studio, aprende más en Get Direct Line token.
En tu código de servicio, envía la solicitud de generar token de muestra. Sustituye
<DirectLineSecret>por el secret que copiaste.
Ejemplo de solicitud de generación de token
POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>
Ejemplo de respuesta de generación de token
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
Si la solicitud tiene éxito, la respuesta contiene un token válido para una conversación y un valor expires_in que indica el número de segundos que transcurrirán hasta que el token expire.
Para mantener útil el token, debe actualizar el token antes de que expire.
Actualizar un token
Puede actualizar un token un número ilimitado de veces, siempre y cuando no haya expirado.
No se puede actualizar un token expirado.
Envía la solicitud de actualización de ejemplo. Sustituye <DirectLineToken> por el token no caducado que quieres actualizar. Usa el token de conversación, no el secreto de Direct Line.
Solicitud de actualización de prueba
POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>
Ejemplo de respuesta de recarga
Si la solicitud tiene éxito, la respuesta contiene un nuevo token válido para la misma conversación que el token anterior y un expires_in valor que indica el número de segundos que transcurrirán hasta que el nuevo token expire.
Para mantener útil el nuevo token, actualice el token de nuevo antes de que expire.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
Más información en Actualizar un token de Direct Line.