Integración de Avaya IP Office con Avaya Spaces

para inicio de sesión único (SSO) y mensajería

unificada con IX Workplace y habilitación de
Spaces Calling

V 2.0 Septiembre 2021

1
 CONTENIDO

1. Resumen general
2. Cuenta de Avaya Spaces y verificación de dominio
3. API Key y API Secret de Avaya Spaces
4. Configuración de seguridad y Avaya Cloud Services en IP
Office
5. Configuración de usuarios en IP Office
6. Sincronización de SSO
7. Habilitación de Spaces Calling
8. Recursos adicionales

2
Resumen general
En este manual encontrarás una guía detallada con los pasos a seguir para realizar la integración
de SSO y mensajería en IX Workplace con Avaya Spaces para usuarios de IP Office. Únicamente
se requiere de tener un dominio verificado o registrado con Avaya Spaces, ya que esto nos
permitirá hacer la sincronización de usuarios con el IP Office y así ya no será necesario ingresar
la URL completa del 46xxsettings para firmarse en el IX Workplace, ahora solo con el correo del
usuario se puede iniciar la extensión telefónica y mensajería. Además, la sincronización de
usuarios es el primer paso para completar la configuración para habilitar Spaces Calling, por lo
que terminaremos habilitando esta funcionalidad.

Cuenta de Avaya Spaces y verificación de dominio

La parte clave de la integración requiere contar con una cuenta en Avaya Spaces y tener
registrada una empresa con un dominio valido y verificado. Esto se realiza de manera automática
si ya se adquirieron licencias de Avaya Spaces (ya sean Business o Power).

Podemos comprobar si el dominio ya se encuentra verificado y registrado desde el Portal de

Administrador, a este podemos acceder desde la cuenta de Avaya Spaces de la persona que haya
sido registrada como Administrador de las licencias adquiridas.

Acceso al Portal de Administración

En la sección de Settings, encontraremos la parte dedicada a dominios.

3
En caso de que no se cuente con licenciamiento de Avaya Spaces o no ver el dominio verificado
de manera correcta, solicitar la verificación del dominio directamente con Avaya a través de su
ejecutivo de cuenta.

API Key y API Secret de Avaya Spaces

Para la sincronización de los usuarios de IP Office con Avaya Spaces, el IP Office requiere mandar
los detalles de cada usuario al servidor de Spaces, para esto lo primero que necesitamos es
generar las llaves que permitirán el intercambio de información entre la cuenta de Avaya Spaces
y el IP Ofice.
Estas llaves las tenemos que generar desde la cuenta de Administrador de Spaces, para lo cual
nos tenemos que dirigir a la opción de Profile & Account desde el Dashboard de Spaces.

Después, en la sección de Manage Companies seleccionamos el registro correspondiente a

nuestra organización.

Dentro de la configuración de nuestra organización, nos dirigimos a la sección de API Key, para
que creemos llaves nuevas para la integración.

4
Al crearlas tenemos que elegir la opción de IP Office y presionamos Agregar. Con esto ya
tendremos disponibles nuestra API Key y API Secret, estas tenemos que copiarlas y guardarlas ya
que mas tarde se tendrán que ingresar en la configuración de seguridad de IP Office.

Creación del API Key

El valor de API Key y API Secrete será requerido mas adelante en la configuración del IP Office.

5
Configuración de seguridad y Avaya Cloud Services
en IP Office
Ahora que ya tenemos las llaves de seguridad de Spaces, tenemos que ingresarlas dentro de la
configuración de seguridad de IP Office, para ello, desde el manager de escritorio nos conectamos
al IP Office e ingresamos en la sección de Seguridad.
En el apartado de seguridad seleccionamos System.

Ahí ingresamos el API Key y el API Secret en los campos correspondientes y guardamos los
cambios.

De ahí, nos vamos a la configuración de IP Office e ingresamos a la opción de System.

6
Dentro de System, elegimos la pestaña de Avaya Cloud Services, y aquí crearemos el perfil de
conexión hacia Spaces.

2 4
3

1. Nombre que asignamos al perfil de conexión que estamos creando, en general puede ser
cualquier cadena de texto, de preferencia definirla con algún nombre sencillo o corto.
2. El Zang URL indica el servidor de Spaces al que se va a hacer la conexión, este campo suele
auto llenarse con la URL de Avaya Cloud Accounts, en caso de que no suceda, definir
manualmente la siguiente URL: accounts.avayacloud.com.
3. Dominio verificado en la cuenta de Avaya Spaces.
4. Habilitar la opción “Enable for current IP Office node”. Esta opción genera de manera
automática la configuración necesaria para que Avaya Spaces pueda autenticar a los usuarios de
IP Office a través de Avaya Accounts al iniciar sesión en el cliente IX Workplace. Por detrás lo que
sucede es que se le indica al servidor de Spaces la ruta para apuntar hacia el 46xxttings del IPO y
poder firmar el Workplace. A la vez, seleccionar siempre la opción de “Enable User
Synchronization”.
5. La sección de Avaya Cloud Authorization nos permitirá sincronizar la configuración realizada
en los pasos anteriores para realizar SSO desde IX Workplace, para esto hay que habilitar la
opción de “Enable Avaya Cloud Account Authorization”.
Finalmente, guardamos y cargamos todos los cambios realizados al IP Office, en este caso los
cambios se realizan como Merge, por lo que el IP Office no se reiniciará.
En caso de que el SSO no esté funcionando despues de haber realizado la configuración
anterior, podemos realizar la sincronización de manera manual.
Como se mencionó antes, el punto número 4 se refería a generar de manera automática la
configuración para que Avaya Spaces sepa a que URL de 46xxsettings apuntar para poder iniciar
sesión en Workplace, pero también podemos configurar está URL directamente en la
administración de Spaces en caso de que la sincronización automática falle.

7
Para ello, nuevamente vamos a la sección de Profile & Account en nuestro Dashboard de Spaces
y ahí seleccionamos nuestra organización en la parte de Manage Companies.
Después, seleccionamos la pestaña de Apps, y elegimos configurar una nueva aplicación.

Ahí, primero seleccionamos Equinox Cloud Cliente en la opción de Producto.

Ahora, en el modulo de Public Settings, tenemos que agregar un pequeño código en formato
JSON para indicar la URL del IP Office. El código a agregar debe tener la siguiente estructura:

El Profile Name tiene que ser el mismo que se definió en la configuración de Avaya Cloud Services
en la parte del IP Office y el Client Settings File Url es la URL que apunta hacia el archivo
46xxsettings del IP Office, ya sea utilizando el dominio del IPO o la URL pública.

8
Finalizamos guardando esto cambios y de regreso en la configuración del IP Office, cambiamos la
opción de Enable Settings file URL sync a Disabled.

Configuración de usuarios en IP Office

Ya con los pasos anteriores, está completa la sincronización de usuarios e inicio de sesión entre
Spaces y IP Office, solo resta indicar al IPO con que correo se tiene que autenticar cada usuario
al iniciar el Workplace.
Esto lo indicamos en la configuración de usuarios en el IP Office, tenemos que ingresar a cada
uno de los usuarios y definir el campo de Unique Identity con el correspondiente correo que cada
persona usa para su cuenta de Avaya Spaces.

9
Sincronización de SSO
Como último paso, tenemos que activar la sincronización del SSO desde la configuración web del
IP Office. Para esto, abrimos la administración del IP Office desde el Web Manager y en la sección
de Solution, seleccionamos el sistema IP Office y en la opción de Actions, hacemos click en
Synchronize Single Sign-On Configuration.

Habilitación de Spaces Calling

Para habilitar la funcionalidad de Spaces Calling, nuevamente nos dirigimos a la configuración de
nuestra organización desde la cuenta de Administrador de Avaya Spaces, y ahí seleccionamos la
pestaña de Apps.

10
Dentro de la pestaña de Apps, presionamos Configure New App, y ahí elegimos como producto
Avaya Spaces Calling Extension. Después, en la sección de Data Configuration definimos un
objeto tipo JSON en el cual se configuran los parámetros que apuntan hacia el IP Office.
El objeto JSON tiene la siguiente estructura:

El parámetro Name puede ser cualquier nombre, al igual que en la creación del perfil para la
sincronización de usuarios, se recomienda un nombre sencillo o fácil de identificar. El parámetro
Address se refiere a la IP pública o dominio del IP Office y por último, AccountsToken se refiere a
si se quiere implementar SSO o no dentro de la extensión de Spaces Calling.

*Cabe mencionar que este es el esquema de configuración mas sencillo, ya que se pueden
agregar algunos parámetros mas correspondientes a temas de planes de marcación e integración
a través de SBC.

11
Ahora, nos dirigimos al Portal de Administrador desde la cuenta de Avaya Spaces, ahí
seleccionamos la opción de Settings y en la parte inferior habilitamos la opción de Enable Avaya
Spaces Calling y Avaya Spaces Calling Chrome Extension.

Con esto, la configuración de Spaces Calling estaría completa, solo no hay que olvidar que cada
usuario que necesite la funcionalidad de Calling, tiene que contar con una licencia de Power User
(en el caso de IP Office en esquema perpetuo) o UC User (en el caso de IP Office en esquema de
Subscription).

12
Finalmente, para la instalación de la extensión de Chrome, nos tenemos que dirigir a la sección
de descargas en nuestro Dashboard de Spaces.

Dentro de Descargas, buscamos la opción que dice Avaya Spaces Calling Chrome Extension

Esto nos llevará a la Chrome Web Store, y solo tenemos que hacer click en Add to Chrome, y
despues en Add Extension.

13
Al completar la instalación de la extensión, esta se ejecutará y solo resta iniciar sesión con
nuestras credenciales de usuario del IP Office.

14
Y así es como veremos nuestra interfaz de Avaya Spaces con la extensión de Spaces Calling
firmada.

Recursos Adicionales
Configuración de IP Office para Avaya Spaces
https://downloads.avaya.com/css/P8/documents/101065732

Configuración para sincronización de SSO

https://ipofficekb.avaya.com/businesspartner/ipoffice/mergedProjects/webmanager/_frame2.
html?SolutionActionsSyncSSOConfg.html
Configuración de Avaya Spaces Calling
https://ipofficekb.avaya.com/subscription/ipoffice/mergedProjects/sipphoneinst/_frame2.html
?Spaces_Calling.html?zoom_highlight=spaces+calling

15