Requisitos de residencia en colaboración

• El servicio de autenticación debe residir en grupo con las aplicaciones Xsi, ya que dichas interfaces deben aceptar tokens de larga duración para obtener autorización del servicio. El servicio de autenticación debe validar esos tokens.

• El servicio de autenticación y Xsi pueden ejecutarse en el mismo puerto, si es necesario.

• Puede separar los demás servicios o aplicaciones según sea necesario para su escala (campo XSP de administración de dispositivos dedicado, por ejemplo).

• Puede localizar en forma compartida las aplicaciones Xsi, CTI, del servicio de autenticación y de DMS.

• No instale otras aplicaciones ni servicios en los XSP que se utilizan para integrar BroadWorks con Webex.

• No ubique de forma co-ubique la aplicación NPS con ninguna otra aplicación.

Xsi Interfaces

Instale y configure las aplicaciones Xsi-Actions y Xsi-Events como se describe en Guía de configuración de la interfaz de servicios Xtended de Cisco BroadWorks.

Configurar el servicio de autenticación (con validación de token de CI)

Utilice este procedimiento para configurar el servicio de autenticación de modo que utilice la validación de token de CI con TLS. Se recomienda este método de autenticación si está ejecutando R22 o una versión superior y el sistema lo admite.

Tls mutuo (mTLS) se admite como un método de autenticación alternativo para el servicio de autenticación. Si se aplican las siguientes condiciones a su sistema, configure la autenticación mTLS en lugar de la validación de token de CI: Está ejecutando R21SP1. Tiene varias organizaciones de Webex ejecutándose en el mismo servidor XSP. En este caso, debe utilizar la autenticación mTLS, ya que la validación de token de CI no admite varias conexiones al mismo servicio de autenticación XSP. Para configurar la autenticación mTLS para el servicio de autenticación, consulte el Apéndice. También tenga en cuenta que si está ejecutando R22 o una versión superior y actualmente utiliza mTLS para el servicio de autenticación, no es obligatorio que vuelva a configurar la validación de token de CI con TLS.

1. Cree una solicitud de servicio con su contacto de incorporación, o con TAC, para aprovisionar su cuenta de cliente de (Webex Common Identity) OAuth. Title your service request "XSP AuthService Configuration" (Configuración de servicio de autenticación XSP). Cisco le proporciona un ID de cliente de autenticación automática, un secreto del cliente y un token de actualización que es válido durante 60 días. Si el token caduca antes de que usted lo utilice con su XSP, puede generar otra solicitud.

2. Instale las siguientes revisiones en cada servidor XSP. Instale las revisiones que correspondan a su versión:

   • Para R22:

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

   • Para R23:

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • Para R24: no se necesita ninguna revisión

3. Instale la AuthenticationService aplicación en cada servicio XSP.

   1. Ejecute el siguiente comando para activar la aplicación AuthenticationService en el XSP para la ruta de contexto de /authService.

      XSP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService

   2. Ejecute este comando para implementar AuthenticationService en el XSP:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...

4. Configure los proveedores de identidad mediante la ejecución de los siguientes comandos en cada servidor de XSP:

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set enabled true

   • set clientId <client id>

   • set clientSecret <secret from TAC service request>

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName <URL> —Para la URL, introduzca la URL de IssuerName que se aplica a su grupo de CI. Consulte la tabla siguiente.

   • set issuerUrl <URL> —Para la URL, introduzca la Url del emisor que se aplica a su grupo de CI. Consulte la tabla siguiente.

   • set tokenInfoUrl <IdPProxy URL>: introduzca la URL del proxy de IdP que se aplica a su grupo de Teams. Consulte la tabla siguiente.

   Tabla 1. Proveedor de servicios de identidad URL

   URL de IssuerURL y IssuerName		IdP Proxy URL
   Si el grupo de CI es...	Defina IssuerURL y IssuerName en...	Si el grupo de Teams está...	Configurar URL del proxy IdP en...
   EE. UU.-A	https://idbroker.webex.com/idb	Achm	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   Ue	https://idbroker-eu.webex.com/idb	Afra	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   EE. UU.-B	https://idbroker-b-us.webex.com/idb	AORTE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   * Si no conoce su grupo de CI o el grupo de Teams , puede obtener la información desde la Mesa de ayuda en Control Hub. En Detalles del cliente, consulte el valor de los campos Grupo de CI y Grupo de equipos.   Para realizar pruebas, puede verificar que la URL es válida reemplazando el enlace " idp/authenticate" parte de la URL con " ping".

5. Especifique la autorización de Webex que debe estar presente en la perfil de usuario Webex mediante la ejecución del siguiente comando:

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user

6. Configure los proveedores de identidad para la federación de Cisco mediante los siguientes comandos en cada servidor de XSP:

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

   • set flsUrl https://cifls.webex.com/federation

   • set refreshPeriodInMinutes 60

   • set refreshToken <token from service request>

7. Ejecute el siguiente comando para validar que su configuración de FLS esté funcionando. Este comando devolverá la lista de proveedores de identidad:

   XSP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get

8. Configure la administración de tokens mediante los siguientes comandos en cada servidor XSP:

   • XSP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

9. Generar y compartir claves RSA. Debe generar claves en un XSP y luego copiarlas a todos los otros XSP. Esto se debe a los siguientes factores:

   • Debe utilizar los mismos pares de claves públicas/privadas para el cifrado y descifrado de tokens en todas las instancias del servicio de autenticación.

   • El servicio de autenticación genera el par de claves cuando se le exige por primera vez emitir un token.

   Si cambia las teclas de ciclo o cambia la longitud de la clave, debe repetir la siguiente configuración y reiniciar todos los XSP.

   1. Seleccione un XSP para generar un par de claves.

   2. Utilice un cliente para solicitar un token cifrado desde ese XSP; para ello, solicite la siguiente URL del explorador del cliente:

      https://<XSP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)

      (Esto genera un par de clave privada/pública en el XSP, si todavía no había uno)

   3. La ubicación del almacén de claves no es configurable. Exporte las claves:

      XSP_CLI/Applications/authenticationService/KeyManagement> exportKeys

   4. Copiar el archivo exportado /var/broadworks/tmp/authService.keys a la misma ubicación en los otros XSP, sobrescribiendo una anterior .keys archivo si es necesario.

   5. Importe las claves en cada una de las otras XSP:

      XSP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

10. Proporcione la URL del servicio de autenticación al contenedor web. El contenedor web de XSP necesita la URL de servicio de autenticación para que pueda validar los tokens. En cada una de las XSP:

    1. Agregue la URL del servicio de autenticación como servicio de autenticación externo para la utilidad BroadWorks Communications:

       XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Agregue la URL del servicio de autenticación al contenedor:

       XSP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

       Esto permite que Cisco Webex servicio de autenticación para validar los tokens presentados como credenciales.

    3. Compruebe el parámetro con get.

    4. Reinicie XSP.

Configuración de TLS y cifrados en las interfaces HTTP (para XSI y el servicio de autenticación)

Las aplicaciones de Servicio de autenticación, Xsi-Actions y Xsi-Events utilizan interfaces del servidor HTTP. Los niveles de configuración de TLS para estas aplicaciones son los siguientes:

Más general = Transporte > sistema > HTTP > interfaz del servidor HTTP = Más específico

Los contextos de la CLI que utiliza para ver o modificar las diferentes configuraciones de SSL son los siguientes:

Lectura de la configuración de la interfaz TLS del servidor HTTP en XSP

1. Inicie sesión en XSP y navegue hasta XSP_CLI/Interface/Http/HttpServer>

2. Introduzca el get y lea los resultados. Verá las interfaces (direcciones IP) y, para cada una, si son seguras y si requieren autenticación de cliente.

Apache tomcat exige un certificado para cada interfaz segura; el sistema genera un certificado de firma propia si necesita uno.

XSP_CLI/Interface/Http/HttpServer> get

Adición del protocolo TLS 1.2 a la interfaz del servidor HTTP

Este procedimiento se aplica a R22 y versiones posteriores. Para configurar la versión de TLS en R21(SP1), debe utilizar la opción de contenedor de plataforma XSP bw.apache.sslenabledprotocols.

La interfaz HTTP que está interactuando con la Cisco Webex privada debe configurarse para TLSv1.2. La nube no negocia versiones anteriores del protocolo TLS.

Para configurar el protocolo TLSv1.2 en la interfaz del servidor HTTP:

1. Inicie sesión en XSP y navegue hasta XSP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

2. Introduzca el comando get <interfaceIp> 443 para ver cuáles protocolos ya están utilizados en esta interfaz.

3. Introduzca el comando add <interfaceIp> 443 TLSv1.2 para asegurarse de que la interfaz pueda usar TLS 1.2 al comunicarse con la nube.

Editar la configuración de cifrados TLS en la interfaz del servidor HTTP

Este procedimiento se aplica a R22 y versiones posteriores. Para configurar cifrados TLS en R21(SP1), debe utilizar la opción de contenedor de plataforma XSP bw.apache.sslciphersuite.

Para configurar los cifrados necesarios:

1. Inicie sesión en XSP y navegue hasta XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

2. Introduzca el comando get <interfaceIp> 443 para ver cuáles cifrados ya están utilizados en esta interfaz. Debe haber al menos uno de los conjuntos recomendados de Cisco (consulte Requisitos de seguridad y identidad de XSP en la sección Descripción general).

3. Introduzca el comando add <interfaceIp> 443 <cipherName> para agregar un cifrado a la interfaz del servidor HTTP.

   La CLI de XSP requiere el nombre de la suite de cifrado estándar de IANA, no el nombre de la suite de cifrado openSSL. Por ejemplo, para agregar el cifrado openSSL ECDHE-ECDSA-CHACHA20-POLY1305 a la interfaz del servidor HTTP, utilizará: XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 Consulte https://ciphersuite.info/ para encontrar la suite por cualquiera de los dos nombres.

Configurar la administración de dispositivos en XSP, en el servidor de aplicaciones y en el servidor de perfil

El servidor de perfil y XSP son obligatorios para la administración de dispositivos. Deben configurarse de acuerdo con las instrucciones de la Guía de configuración de la Administración de dispositivos de BroadWorks (https://xchange.broadsoft.com/node/1031995).

Configurar el servidor de aplicaciones para suscripciones de CTI

Actualice clientIdentity en el servidor de aplicaciones con el nombre nombre común (CN) del certificado de cliente CTI de Webex para BroadWorks.

Para cada servidor de aplicaciones que utilice con Webex, agregue la identidad del certificado a ClientIdentity de la siguiente manera:

AS_CLI/System/ClientIdentity> add bwcticlient.webex.com

La nombre común certificado del cliente de Webex para BroadWorks es bwcticlient.webex.com.

Configurar TLS y cifrados en la interfaz de CTI

Los niveles de configuración para la interfaz CTI de XSP son los siguientes:

Más general = Transporte > sistema > interfaces CTI > interfaz CTI = Más específica

Los contextos de la CLI que utiliza para ver o modificar las diferentes configuraciones de SSL son los siguientes:

Lectura de la configuración de la interfaz TLS de CTI en el XSP

1. Inicie sesión en XSP y navegue hasta XSP_CLI/Interface/CTI/SSLSettings>

   En BroadWorks R21: navegar hasta XSP_CLI/Interface/CTI/SSLConfiguration>

2. Introduzca el get y lea los resultados. Verá las interfaces (direcciones IP) y, para cada una, si requieren un certificado de servidor y si requieren autenticación de cliente.

   

Agregar el protocolo TLS 1.2 a la interfaz de CTI

Este procedimiento se aplica a R22 y versiones posteriores. Para configurar la versión TLS en la interfaz CTI para R21(SP1), debe utilizar la opción contenedor de tomcat bw.cti.sslenabledprotocols.

La interfaz CTI de XSP que está interactuando con Cisco Webex privada debe configurarse para TLS v1.2. La nube no negocia versiones anteriores del protocolo TLS.

Para configurar el protocolo TLSv1.2 en la interfaz CTI:

1. Inicie sesión en XSP y navegue hasta XSP_CLI/Interface/CTI/SSLSettings/Protocols>

2. Introduzca el comando get <interfaceIp> para ver cuáles protocolos ya están utilizados en esta interfaz.

3. Introduzca el comando add <interfaceIp> TLSv1.2 para asegurarse de que la interfaz pueda usar TLS 1.2 al comunicarse con la nube.

Editar la configuración de cifrados TLS en la interfaz de CTI

Este procedimiento se aplica a R22 y versiones posteriores. Para configurar los cifrados en la interfaz CTI para R21(SP1), debe utilizar la opción contenedor de tomcat bw.cti.enabledciphers.

Para configurar los cifrados obligatorios en la interfaz de CTI:

1. Inicie sesión en XSP y navegue hasta XSP_CLI/Interface/CTI/SSLSettings/Ciphers>

2. Introduzca el get para ver qué cifrados ya se utilizan en esta interfaz. Debe haber al menos uno de los conjuntos recomendados de Cisco (consulte Requisitos de seguridad y identidad de XSP en la sección Descripción general).

3. Introduzca el comando add <interfaceIp> <cipherName> para agregar un cifrado a la interfaz de CTI.

   La CLI de XSP requiere el nombre de la suite de cifrado estándar de IANA, no el nombre de la suite de cifrado openSSL. Por ejemplo, para agregar el cifrado openSSL ECDHE-ECDSA-CHACHA20-POLY1305 a la interfaz CTI, utilizará: XSP_CLI/Interface/CTI/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 Consulte https://ciphersuite.info/ para encontrar la suite por cualquiera de los dos nombres.

Actualizar anclajes de confianza para la interfaz CTI (R22 y versiones posteriores)

Este procedimiento supone que los XSP son tanto para Internet como para personas que se enfrentan a Internet a través de un proxy de transferencia. La configuración del certificado es diferente para un proxy de conexión (consulte Requisitos del certificado TLS para el proxy TLS-bridge).

Por cada XSP de su infraestructura que esté publicando eventos CTI en Webex, haga lo siguiente:

1. Inicie sesión en el Concentrador de socios.

2. Vaya a Configuración y > BroadWorks y haga clic en Descargar certificado de CA de Webex para obtener CombinedCertChain.txt en su computadora local.

   Este archivo contiene dos certificados. Debe dividir el archivo antes de cargarlo en los XSP.

3. Divida la cadena de certificados en dos certificados:

   1. Abierto combinedcertchain.txt en un editor de texto.

   2. Seleccione y corte el primer bloque de texto, incluidas las líneas -----BEGIN CERTIFICATE----- y una -----END CERTIFICATE----- y pegue el bloque de texto en un archivo nuevo.

   3. Guarde el nuevo archivo como broadcloudroot.txt.

   4. Guarde el archivo original como broadcloudissuing.txt.

      El archivo original ahora solo debería tener un bloque de texto, envueludo por líneas -----BEGIN CERTIFICATE----- y una -----END CERTIFICATE-----.

4. Copie ambos archivos de texto en una ubicación temporal en la XSP que está asegurando, por ejemplo. /tmp/broadcloudroot.txt y una /tmp/broadcloudissuing.txt.

5. Inicie sesión en XSP y navegue hasta /XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. (Opcional) Ejecutar help updateTrust para ver los parámetros y el formato de los comandos.

7. Cargue los archivos de certificado en los anclajes de confianza nuevos:

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexroot /tmp/broadcloudroot.txt

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexissuing /tmp/broadcloudissuing.txt

   webexroot y una webexissuing son alias de ejemplo para los anclajes de confianza; puede usar los suyos propios.

8. Confirme que los anclajes estén actualizados:

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get

     Alias   Owner                                   Issuer
   =============================================================================
   webexissuing    BroadCloud Commercial Issuing CA – DA3     BroadCloud Commercial Trusted Root CA
   webexroot       BroadCloud Commercial Trusted Root CA      BroadCloud Commercial Trusted Root CA[self-signed]

9. Permitir que los clientes se autentiquen con certificados:

   XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

Actualizar anclajes de confianza para la interfaz CTI (R21)

Este procedimiento supone que los XSP son tanto para Internet como para personas que se enfrentan a Internet a través de un proxy de transferencia. La configuración del certificado es diferente para un proxy de conexión (consulte Requisitos del certificado TLS para el proxy TLS-bridge).

Por cada XSP de su infraestructura que esté publicando eventos CTI en Webex, haga lo siguiente:

1. Inicie sesión en el Concentrador de socios.

2. Vaya a Configuración y > BroadWorks y haga clic en Descargar certificado de CA de Webex para obtener CombinedCertChain.txt en su computadora local.

   Este archivo contiene dos certificados. Debe dividir el archivo antes de cargarlo en los XSP.

3. Divida la cadena de certificados en dos certificados:

   1. Abierto combinedcertchain.txt en un editor de texto.

   2. Seleccione y corte el primer bloque de texto, incluidas las líneas -----BEGIN CERTIFICATE----- y una -----END CERTIFICATE----- y pegue el bloque de texto en un archivo nuevo.

   3. Guarde el nuevo archivo como broadcloudroot.txt.

   4. Guarde el archivo original como broadcloudissuing.txt.

      El archivo original ahora solo debería tener un bloque de texto, envueludo por líneas -----BEGIN CERTIFICATE----- y una -----END CERTIFICATE-----.

4. Copie ambos archivos de texto en una ubicación temporal en la XSP que está asegurando, por ejemplo. /tmp/broadcloudroot.txt y una /tmp/broadcloudissuing.txt.

5. Inicie sesión en XSP y navegue hasta /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts>

6. (Opcional) Ejecutar help updateTrust para ver los parámetros y el formato de los comandos.

7. Actualice anclajes de confianza nuevos con los certificados:

   /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> updateTrust webexroot /tmp/broadcloudroot.txt

   /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> updateTrust webexissuing /tmp/broadcloudissuing.txt

   (donde "webexroot" y "webexissuing" son alias de ejemplo para los anclajes de confianza, puede elegir uno propio)

8. Confirme que ambos certificados estén cargados:

   /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> get

   XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> get
                Alias                                   Owner                                           Issuer
   ===========================================================================================================
        webexissuing   BroadCloud Commercial Issuing CA - DA3 BroadCloud Commercial Trusted Root CA
           webexroot   BroadCloud Commercial Trusted Root CA  BroadCloud Commercial Trusted Root CA[self-signed]

9. Permitir que los clientes se autentiquen con certificados:

   XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

Agregar interfaz CTI y habilitar mTLS

1. Agregue la interfaz SSL CTI.

   El contexto de la CLI depende de su versión de BroadWorks. El comando crea un certificado de servidor de firma propia en la interfaz y obliga a la interfaz a requerir un certificado de cliente.

   • En BroadWorks 22 y 23.0:

     XSP_CLI/Interface/CTI/SSLSettings> add <Interface IP> true true

   • En BroadWorks 21.sp1:

     XSP_CLI/Interface/CTI/SSLConfiguration> add <Interface IP> true true

2. Habilitar y definir el puerto CTI seguro en XSP:

   XSP_CLI/Interface/CTI> set securePortEnabled true

   XSP_CLI/Interface/CTI> set securePort 8012

3. Reemplace el certificado y la clave del servidor en las interfaces CTI de XSP. Para esto, necesitará la dirección IP de la interfaz CTI. puede leerlo en el siguiente contexto:

   • En BroadWorks 22 y 23.0:

     XSP_CLI/Interface/CTI/SSLSettings> get

   • En BroadWorks 21.sp1:

     XSP_CLI/Interface/CTI/SSLConfiguration> get

     Luego, ejecute los siguientes comandos para reemplazar el certificado de firma propia de la interfaz por su propio certificado y su propia clave privada:

     En BroadWorks 22.0 y 23.0:

     XSP_CLI/Interface/CTI/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>

     En BroadWorks 21.sp1:

     XSP_CLI/Interface/CTI/SSLConfiguration> sslUpdate <interface IP> keyFile </path/to/certificate key file> certificateFile </path/to/server certificate> chainFile </path/to/chain file>

4. Reinicie XSP.

Abrir puertos de entrada para la interfaz CTI segura

Abra el puerto seguro para CTI en su firewall (TCP 8012 de manera predeterminada) para una conexión TLS entrante a su interfaz CTI de XSP.

Para verificar que el puerto seguro esté habilitado y su número de puerto:

1. Inicie sesión en la CLI de XSP y navegue hasta el XSP_CLI/Interface/CTI> Contexto.

2. Introducir get.

Entre otra información, debe ver lo siguiente:

securePort = 8012

Esto garantiza que Webex pueda iniciar una conexión cifrada.

Webex solo utiliza el puerto seguro, por lo que le recomendamos que configure portEnabled = false para deshabilitar el puerto no seguro.

Habilitar el acceso a eventos CTI de BroadWorks en Cisco Webex

Tiene que agregar y validar la interfaz CTI cuando configure sus grupos en el Concentrador de socios. Consulte Configurar su organización de socio en control Hub para obtener instrucciones detalladas.

• Especifique la dirección CTI mediante la cual Cisco Webex suscribirse a BroadWorks CTI Events.

• Las suscripciones de CTI se establecen y mantienen solo por suscriptor, mientras que ese suscriptor se proporciona para Webex para BroadWorks.

Experiencia del usuario

• Usuarios de Windows: Haga clic imagen de perfil y luego en Configuración > llamadas > Atención propia .

• Usuarios de Mac: Haga clic imagen de perfil y luego Preferencias > Llamadas > Atención propia

Instalar vista web de configuración de llamadas en XSP

La aplicación de CSWV debe estar en los mismos XSP que alojan la interfaz de Xsi-Actions en su entorno. Es una aplicación no administrada en XSP, por lo que debe instalar e implementar un archivo de archivo web.

1. Inicie sesión en Xchange y busque "BWCallSettingsWeb" en la sección de descarga del software.

2. Busque y descargue la versión más reciente del archivo.

   Por ejemplo, BWCallSettingsWeb_1.8.2_1.war ( ) fue el más reciente al momento dehttps://xchange.broadsoft.com/node/1057167escribir.

3. Instale, active e implemente el archivo web de acuerdo con la Guía de configuración de la plataforma de servicio Xtended correspondiente a su versión XSP. (La versión R23 es https://xchange.broadsoft.com/node/1033484).

   1. Copie el archivo .war en una ubicación temporal de XSP, por ejemplo: /tmp/.

   2. Navegue hasta el siguiente contexto de CLI y ejecute el comando de instalación:

      XSP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war

      El administrador de software BroadWorks valida e instala el archivo.

   3. [Opcional] Eliminar /tmp/BWCallSettingsWeb_1.7.5_1.war(ya no es necesario este archivo).

   4. Active la aplicación:

      XSP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      El nombre y la versión son obligatorios para cualquier aplicación, pero para CSWV también debe proporcionar una contextPath porque es una aplicación no gestionado. Puede utilizar cualquier valor que no sea utilizado por otra aplicación, por ejemplo, /callsettings.

   5. Implemente la aplicación Configuración de llamadas en la ruta de contexto seleccionada:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

4. Ahora puede pronosticar la URL de configuración de llamadas que especificará para los clientes como se muestra a continuación:

   https://<XSP-FQDN>/callsettings/

   Notas:

   • Debe suministrar la barra de finales en esta URL cuando la introduzca en el archivo de configuración del cliente.

   • El archivo XSP-FQDN debe coincidir con el FQDN de acciones Xsi, ya que CSWV necesita utilizar acciones de Xsi, y CORS no es compatible.

5. Repita este procedimiento para otros XSP en su entorno de Webex para BroadWorks (si es necesario)

La aplicación Webview de configuración de llamadas ahora está activa en los XSP.

Configuración adicional para XSP R21

Si está implementando la aplicación de CSWV en un R21 XSP:

1. Navegue hasta el contexto de la aplicación de configuración de llamadas y ejecute obtener para leer su configuración: XSP_CLI/Applications/BWCallSettingsWeb_1.7.5/General> get

   Debería ver los siguientes parámetros y valores:

   xsiActionsContextOrURL=/com.broadsoft.xsi-actions
   displayCriteriaOrScheduleName=criteria
   applicationMode=prod
   

2. Utilizar set(si fuera necesario) para cambiar los parámetros a los valores mostrados anteriormente.

3. Repita estos pasos para otros R21 XSP si es necesario.

Descripción general del proxy de NPS

Para ser compatible con Webex para BroadWorks, se debe instalar una revisión de su CNPS para admitir la característica de proxy NPS, Push Server para VoIP en UCaaS.

La característica implementa un nuevo diseño en el servidor de push de notificación para resolver la vulnerabilidad de seguridad de compartir claves privadas del certificado de notificación de push con proveedores de servicios para clientes móviles. En lugar de compartir certificados y claves de notificación de push con el proveedor de servicios, NPS utiliza una nueva API para obtener un token de notificación de push emergente corto de Webex para backend de BroadWorks, y usa este token para la autenticación con los servicios API de Apple y Google FCM.

La característica también mejora la capacidad del servidor de push de notificación para enviar notificaciones a los dispositivos Android a través de la nueva API de Mensajería en la nube de Google Firebase (FCM) HTTPv1.

• Para obtener más información, consulte el Servidor de push VoIP en descripción de características de UCaaS en Xchange: https://xchange.broadsoft.com/node/1045458.

• Las revisiones de BroadWorks para la característica están disponibles en Xchange: https://xchange.broadsoft.com/node/1046235.

• Puede encontrar más información sobre el servidor ADP en https://xchange.broadsoft.com/node/1051580.

Configurar sus grupos de BroadWorks

[una vez por grupo]

Esto se hace por los siguientes motivos:

• Para habilitar la nube de Webex para autenticar sus usuarios contra BroadWorks (a través del servicio de autenticación alojado en XSP).

• Para permitir que las aplicaciones de Webex utilicen la interfaz Xsi para el control de llamadas.

• Para habilitar que Webex escuche los eventos CTI publicados por BroadWorks (presencia telefónica).

El asistente de grupos valida automáticamente las interfaces a medida que las agrega. Puede continuar editando el grupo si alguna de las interfaces no valida con éxito, pero no puede guardar un grupo si hay entradas noválidas. Evitamos esto porque un grupo mal configurado podría causar problemas difíciles de resolver.

Lo que debe hacer:

1. Inicie sesión en el Partner Hub (admin.webex.com) con sus credenciales de administrador de socios.

2. Abra la página configuración en el menú lateral, y busque Configuración de llamadas de BroadWorks.

3. Haga clic en Agregar grupo.

   Esto inicia un asistente donde usted suministra sus interfaces XSP (URL). Puede agregar un puerto a la URL de la interfaz si está utilizando un puerto no estándar.

4. Asigne un nombre a este grupo y haga clic en Siguiente.

   El concepto de los grupos aquí es simplemente una colección de interfaces, generalmente reasignadas en un servidor o campo de XSP, que permiten que Webex lea información de su servidor de aplicaciones (AS). Es posible que tenga un XSP por grupo de AS, o varios XSP por grupo, o varios grupos de AS por XSP. Los requisitos de escala para su sistema de BroadWorks están fuera de alcance aquí.

5. (Opcional) Introduzca un Nombre de cuenta y contraseña de usuario de BroadWorks que sepa que está dentro del sistema de BroadWorks al que se está conectando Webex; luego, haga clic en Siguiente.

   Las pruebas de validación pueden utilizar esta cuenta para validar las conexiones a las interfaces del grupo.

6. Agregue sus acciones de XSI y las URL de eventos de XSI.

7. Haga clic en Siguiente.

8. Agregue la URL de su interfaz CTI y haga clic en Siguiente.

9. Agregue la URL de su servicio de autenticación.

10. Seleccione Servicio de autenticación con validación de token deCI.

    Esta opción no requiere que mTLS protéjase la conexión de Webex, ya que el servicio de autenticación valida correctamente el token del usuario con relación al servicio de identidad de Webex antes de que reenvíe el token largo al usuario.

11. Revise sus entradas en la pantalla final y, a continuación, haga clic en Crear. Debería ver un mensaje de éxito.

    El Concentrador de socios pasa las direcciones URL a diversos microservicios de Webex que prueban las conexiones a las interfaces proporcionadas.

12. Haga clic en Ver grupos y verá su nuevo grupo, y si la validación se hizo correctamente.

13. Es posible que el botón Crear se deshabilite en la pantalla final (vista preliminar) del asistente. Si no puede guardar la plantilla, indica un problema con una de las integraciones que acaba de configurar.

    Implementamos esta verificación para evitar errores en las tareas subsiguientes. Puede volver a través del asistente mientras configura su implementación, que puede requerir modificaciones en su infraestructura (p. ej.: XSP, nivelador de carga o firewall) tal como se documenta en esta guía, antes de poder guardar la plantilla.

Verificar las conexiones a sus interfaces de BroadWorks

1. Inicie sesión en el Partner Hub (admin.webex.com) con sus credenciales de administrador de socios.

2. Abra la página configuración en el menú lateral, y busque Configuración de llamadas de BroadWorks.

3. Haga clic en Ver grupos.

4. Partner Hub inicia pruebas de conectividad desde los diversos microservicios hacia las interfaces en los grupos.

   Una vez que finalizan las pruebas, en la página de la lista de grupos se muestra un mensaje de estado junto a cada grupo.

   Debería ver los mensajes de éxito verdes. Si ve un mensaje de Error rojo, haga clic en el nombre del grupo afectado para ver qué configuración está causando el problema.

Configurar las plantillas del cliente

Las plantillas de clientes son la forma en la que aplicará la configuración compartida a uno o más clientes a medida que los incorpore a través de los métodos de aprovisionamiento. Debe asociar cada plantilla con un grupo (que creó en la sección anterior).

Puede crear tantas plantillas como necesite, pero solo se puede asociar una plantilla con un cliente.

1. Inicie sesión en el Partner Hub (admin.webex.com) con sus credenciales de administrador de socios.

2. Abra la página configuración en el menú lateral, y busque Configuración de llamadas de BroadWorks.

3. Haga clic en Agregar plantilla.

   Esto inicia un asistente donde puede suministrar la configuración para los clientes que utilizarán esta plantilla.

4. Utilice la lista desplegable Grupo para elegir el grupo que desea utilizar con esta plantilla.

5. Introduzca un Nombre de plantillay, a continuación, haga clic en Siguiente.

6. Configure su modo de aprovisionamiento con los siguientes ajustes recomendados:

   Tabla 2. Configuración de aprovisionamiento recomendada para distintos modos de aprovisionamiento

   Nombre de la configuración	Aprovisionamiento de flujo con correos electrónicos confiables	Aprovisionamiento de flujo directo sin correos electrónicos	Aprovisionamiento automático del usuario
   Habilitar flujo de BroadWorks a través del aprovisionamiento (incluya las credenciales de la cuenta de aprovisionamiento si está en)	Activado Proporcione el nombre de cuenta y la contraseña de aprovisionamiento según la configuración de BroadWorks.	Activado Proporcione el nombre de cuenta y la contraseña de aprovisionamiento según la configuración de BroadWorks.	Desactivar
   Crear automáticamente nuevas organizaciones en Control Hub	El†	El†	El†
   Proveedor de servicios de correo electrónico de la aplicación	Seleccione una dirección de correo electrónico de la lista desplegable (puede escribir algunos caracteres para encontrar la dirección si es una lista larga). Esta dirección de correo electrónico identifica al administrador de su organización de socio a quien se le otorgará acceso de administrador delegado a todas las organizaciones nuevas del cliente creadas con la plantilla del cliente.
   País	Elija qué país utiliza para esta plantilla. El país que elija coincide con las organizaciones del cliente que se crean con esta plantilla con una región en particular. Actualmente, la región podría ser (EMEAR) o (América del Norte y resto del mundo). Consulte las asignaciones de país a región en esta hoja decálculo.
   Modo de BroadWorks Empresarial activo	Habilite esto si los clientes que aprovisiona con esta plantilla son empresas de BroadWorks. Si son grupos, deje este conmutador desactivado. Si tiene una combinación de empresas y grupos en sus BroadWorks, debe crear diferentes plantillas para esos diferentes casos.

   • Notas de la tabla:

   • † Este cambio garantiza que se cree una nueva organización del cliente si el dominio de correo electrónico de un suscriptor no coincide con una organización de Webex existente.

     Esto debería estar siempre activo, a menos que esté utilizando un proceso de solicitud y cumplimiento manual (a través de Cisco Commerce Workspace) para crear organizaciones de clientes en Webex (antes de comenzar a aprovisionar usuarios en esas organizaciones). A esa opción se la conoce con frecuencia como el modelo de "aprovisionamiento híbrido", y está fuera del alcance de este documento.

7. Seleccione el paquete de servicios predeterminado para los clientes que utilizan esta plantilla (consulte Paquetes en la sección Descripción general); ya sea Básica, Estándar, Premium o Softphone.

   Puede anular esta configuración para usuarios individuales a través del Concentrador de socios.

8. Seleccione el modo de autenticación predeterminado (autenticación de BroadWorks o autenticación deWebex) para los clientes que utilizan esta plantilla.

   (Consulte Modo de autenticación en la sección Preparar su entorno).

9. Configure la forma en que los usuarios verifican sus identidades en Webex. La configuración de esta página se corresponda con el modo de aprovisionamiento de usuario elegido como se muestra en la tabla:

   Tabla 3. Configuración de verificación de usuarios recomendada para distintos modos de aprovisionamiento

   Nombre de la configuración	Aprovisionamiento de flujo con correos electrónicos confiables	Aprovisionamiento de flujo directo sin correos electrónicos	Aprovisionamiento automático del usuario
   Verificación de usuarios	Correos electrónicos de BroadWorks de confianza	Correos electrónicos no confiables	Correos electrónicos no confiables
   El primer usuario aprovisionado es el administrador	Recomendado*	Recomendado*	No aplicable
   Permitir que los usuarios se activen automáticamente	No aplicable	No aplicable	Obligatorio

   • Notas de la tabla:

   • * El primer usuario al que asigna Im&P integrada en BroadWorks asume la función de administrador del cliente si se crea una nueva organización del cliente en Webex. Elija esta configuración para tener cierto control sobre quién asume el rol. Si desmarca esta configuración, el primer usuario que se vuelva activo en la nueva organización será el administrador del cliente.

     Puede modificar las funciones de usuario del cliente en partner Hub después del aprovisionamiento, si es necesario.

10. Seleccione si desea rellenar previamente las direcciones de correo electrónico de los usuarios en la página de inicio desesión.

    Solo debe usar esta opción si seleccionó Autenticación de BroadWorks y también ha colocar las direcciones de correo electrónico de los usuarios en el atributo ID alternativo en BroadWorks. De lo contrario, tendrán que utilizar su nombre de usuario de BroadWorks. La página de conexión ofrece la opción de cambiar el usuario, si es necesario, pero esto puede provocar problemas de conexión.

11. Elija si desea Habilitar la sincronización de directorios.

    Esta opción permite que Webex lea los contactos de BroadWorks en la organización del cliente, de modo que los usuarios puedan buscarlos y llamarlos desde la aplicación Webex.

12. Introduzca un Administrador de socios.

    Este nombre se utiliza en la aplicación automática mensaje de correo electrónico Webex, que invita a los usuarios a validar sus direcciones de correo electrónico.

13. Asegúrese de que la alternancia Aprovisionar organizaciones existentes esté Activa (el ajuste predeterminado es Activar).

14. Revise sus entradas en la pantalla final. Puede hacer clic en los controles de navegación en la parte superior del asistente para volver y modificar cualquier detalle. Haga clic en Crear.

    Debería ver un mensaje de éxito.

15. Haga clic en Ver plantillas y verá su nueva plantilla listada con otras plantillas.

16. Si es necesario, haga clic en el nombre de la plantilla para modificarla o eliminarla.

    No es necesario que vuelva a introducir los detalles de la cuenta de aprovisionamiento. Los campos vacíos de confirmación de contraseña/contraseña están disponibles para cambiar las credenciales si es necesario, pero déjelos vacíos para conservar los valores que proporcionó al asistente.

17. Agregue más plantillas si tiene diferentes configuraciones compartidas que desea proporcionar a los clientes.

    Mantenga la página Ver plantillas abierta, ya que es posible que necesite detalles de las plantillas para una siguiente tarea.

Agregar Webex para BroadWorks a una organización existente

Si es administrador de socios de que agrega Webex para los servicios de BroadWorks a una organización del cliente que existe en Control Hub, pero que todavía no está asociada con una organización de CI, el administrador de la organización del cliente debe aprobar el acceso de administrador para que la solicitud tenga éxito.

Es necesaria la aprobación del administrador de la organización si se cumple alguna de las siguientes condiciones:

• No hay una relación administrada por entre el Proveedor de servicios y la organización del cliente y la dirección de correo electrónico de uno de los usuarios de la organización coincide con la dirección de correo electrónico de un usuario de CI en una organización de al menos 100 usuarios.

• La organización tiene un dominio de correo electrónico verificado

• No se ha reclamado el dominio de la organización

Los administradores de socios pueden completar el siguiente procedimiento para agregar servicios de llamadas de BroadWorks a una organización de Webex existente:

En el Concentrador de socios, la alternancia de organizaciones existentes de aprovisionamiento debe estar habilitada dentro de la configuración de la Plantilla de clientes de esa organización (la alternancia está activada de manera predeterminada).

1. En BroadWorks, aprovisionese como usuario para esa organización.

2. Aprovisione Webex para BroadWorks para el cliente. Recibirá una notificación por correo electrónico titulada Su servicio de llamadas acaba de recibir una mejora.

3. En la notificación por correo electrónico, haga clic en el botón Entrar ahora. Después de hacer clic en el botón, ocurre lo siguiente:

   • Falla el archivo adjunto de organización con un 2017 error (No se puede aprovisionar al suscriptor en una organización de Webex existente).

   • Se genera un correo electrónico de solicitud de aprobación y se envía a los administradores de la organización del cliente (hasta cinco administradores). La notificación resalta el correo electrónico del administrador de socios (como se configura en la plantilla del cliente dentro del concentrador de socios) y solicita al administrador de la organización que apruebe la solicitud. Para completar el proceso de aprovisionamiento, el administrador de la organización debe aprobar la solicitud, otorgando al administrador de socios privilegios de administrador total a la organización del cliente.

4. Con acceso de administrador total, ahora puede aprovisionar los servicios de llamadas correctamente.

Agregar administrador externo

Para un procedimiento que los administradores de la organización del cliente puedan seguir para agregar al administrador del socio como administrador externo, consulte Aprobar solicitud de administrador externo.

Servidor de aplicaciones de revisiones

1. Aplique la revisión ap373197 (consulte Requisitos del software de BroadWorks en la sección Referencia).

2. Cambiar a la Maintenance/ContainerOptions Contexto.

3. Habilite el parámetro de la URL de aprovisionamiento:

   /AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true

Obtenga las URL de aprovisionamiento del concentrador de socios

Consulte la Guía de administración de la interfaz de línea de comandos del servidor de aplicaciones de Cisco BroadWorks para conocer los detalles (Interfaz > Mensajería y Servicio > IM&P integrado) de los comandos AS.

1. Inicie sesión en el Concentrador de socios y vaya a Configuración > Llamadas de BroadWorks.

2. Haga clic en Ver plantillas.

3. Seleccione la plantilla que está usando para aprovisionar a los suscriptores de este grupo/empresa en Webex.

   Los detalles de la plantilla se muestran en un panel desplegable a la derecha. Si aún no ha creado una plantilla, debe hacerlo antes de poder obtener la URL de aprovisionamiento.

4. Copie la URL del adaptador de aprovisionamiento.

Repita esta opción para otras plantillas si tiene más de una.

(Opción) Configurar los parámetros de aprovisionamiento para todo el sistema en el servidor de aplicaciones

Es posible que no quiera configurar el aprovisionamiento y el dominio de servicio en todo el sistema si está usando SaaS de UC-One. Consulte Puntos de decisión en la sección Preparar su entorno.

1. Inicie sesión en el servidor de aplicaciones y configure la interfaz de mensajería.

   1. AS_CLI/Interface/Messaging> set provisioningUrl EnterValueFromPartnerHubTemplate

   2. AS_CLI/Interface/Messaging> set provisioningUserId EnterValueFromPartnerHubTemplate

   3. AS_CLI/Interface/Messaging> set provisioningPassword EnterValueFromPartnerHubTemplate

   4. AS_CLI/Interface/Messaging> set enableSynchronization true

2. Active la interfaz imp integrada:

   1. /AS_CLI/Service/IntegratedIMP> set serviceDomain example.com

   2. /AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true

Debe introducir el nombre totalmente calificado para el provisioningURL parámetro, como se le dio en Control Hub. Si su servidor de aplicaciones no puede acceder al DNS para resolver el nombre de host, debe crear la asignación en el cuadro de diálogo /etc/hosts en el as.

(Opción) Configurar parámetros de aprovisionamiento por empresa en el servidor de aplicaciones

1. En la interfaz de usuario de BroadWorks, abra la empresa que quiera configurar y vaya a Servicios > IM&Pintegrado.

2. Seleccione Usar dominio de servicio e introduzca un valor simulado (Webex ignora este parámetro. Podría usar example.com).

3. Seleccione Usar servidor de mensajería.

4. En el campo URL, pegue la URL de aprovisionamiento que copió de su plantilla en el concentrador de socios.

   Debe introducir el nombre totalmente calificado para el provisioningURL parámetro, tal como se le dio en el Concentrador de socios. Si su servidor de aplicaciones no puede acceder al DNS para resolver el nombre de host, debe crear la asignación en el cuadro de diálogo /etc/hosts en el as.

5. En el campo Nombre de usuario, ingrese un nombre para el administrador de aprovisionamiento. Esto debe coincidir con el valor de la plantilla en el concentrador de socios.

6. Ingrese una contraseña para el administrador de aprovisionamiento. Esto debe coincidir con el valor de la plantilla en el concentrador de socios.

7. En Identidad de usuario predeterminada para ID de IM&P , seleccione Principal.

8. Haga clic en Aplicar.

9. Repita para otras empresas que quiera configurar para flujo a través del aprovisionamiento.

Agregar plantillas de configuración de aplicaciones de Webex al servidor de aplicaciones BroadWorks

Las aplicaciones Webex se configuran con archivos DTAF. Los clientes descargan un archivo XML de configuración desde el servidor de aplicaciones, a través del servicio de Administración de dispositivos en el XSP.

1. Obtenga los archivos DTAF requeridos (consulte Perfiles de dispositivos en la sección Preparar su entorno).

2. Verifique que tenga los conjuntos de etiquetas correctos en BroadWorks System > Resources > Device Management Sets.

3. Para cada cliente que está aprovisionando:

   1. Descargue y extraiga el archivo zip DTAF para el cliente en particular.

   2. Importar archivos DTAF a BroadWorks en System > Resources > de identidad/perfil del dispositivo

   3. Abra el perfil del dispositivo recientemente agregado para editar e introduzca el Protocolo de acceso a dispositivos FQDN del campo XSP.

   4. Modifique las plantillas según su entorno (consulte la tabla siguiente).

   5. Guarde el perfil.

4. Haga clic en Archivos y autenticación y seleccione la opción para reconstruir todos los archivos del sistema.

Personalizar clientes en Control Hub

Existen configuraciones de personalización individuales para clientes de escritorio y móviles, por lo que debe repetir este proceso de personalización si usa ambos:

1. Inicie sesión en Control Hub y vaya a Configuración > clientes.

2. Busque el área de Personalice la página de configuración del cliente.

3. Actualice el logotipo y el color barra de navegación principal. Para obtener más información, consulte Agregar la imagen de marca de su empresa a Webex.

El portal de activación de usuarios utiliza el mismo logotipo que agregó para la imagen de marca del cliente.

Personalizar los informes de problemas y las URL de ayuda

Consulte https://help.webex.com/n0cswhcb "Personalizar marca e informes de problemas para los clientes".