Inicio de sesión único y Control Hub

El inicio de sesión único (SSO) es un proceso de autenticación de sesiones o usuarios que permite que el usuario proporcione credenciales para acceder a una o varias aplicaciones. El proceso autentica a los usuarios para todas las aplicaciones que tengan derecho a usar. Elimina la aparición de mensajes adicionales cuando los usuarios cambian de una aplicación a otra durante una sesión en particular.

Se utiliza el Protocolo de federación del Lenguaje de marcado de aserción de seguridad (Security Assertion Markup Language, SAML 2.0) para proporcionar autenticación de SSO entre la nube de Webex y su proveedor de servicios de identidad (IdP).

Perfiles

La aplicación de Webex solo es compatible con el explorador web SSO perfil. En el perfil del explorador SSO web, la aplicación de Webex admite los siguientes enlaces:

SP initiated POST -> POST binding
SP initiated REDIRECT -> POST binding

Formato NameID

El protocolo SAML 2.0 proporciona soporte para varios formatos de NameID a fin de comunicar información sobre un usuario específico. La aplicación de Webex admite los siguientes formatos de NameID.

urn:oasis:names:tc:SAML:2.0:nameid-format:transient
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

En los metadatos que carga desde su IdP, la primera entrada está configurada para ser utilizarla en Webex.

SingleLogout

La aplicación de Webex es compatible con el perfil de cierre de sesión único. En la aplicación de Webex , un usuario puede cerrar sesión de la aplicación, lo que utiliza el protocolo de descontación único de SAML para finalizar la sesión y confirmar que se está finalizando sesión en su IdP. Asegúrese de que el IdP esté configurado para SingleLogout.

Integrar Control Hub con ADFS

Las guías de configuración muestran un ejemplo específico para la integración del SSO, pero no proporcionan una configuración exhaustiva para todas las posibilidades. Por ejemplo, se documentan los pasos de integración para el formato de “nameid” urn:oasis:names:tc:SAML:2.0:nameid-format:transient. Otros formatos como urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified o urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress funcionarán para la integración del SSO, pero están fuera del alcance de nuestra documentación.

Configure esta integración para los usuarios de su organización de Webex (incluida la aplicación Webex , Webex Meetings , y otros servicios administrados en Control Hub ). Si su sitio de Webex está integrado en Control Hub, el sitio de Webex hereda la administración de usuarios. Si no puede acceder a Webex Meetings de esta manera y no se administra en Control Hub, debe realizar una integración aparte para habilitar SSO para Webex Meetings. (Consulte Configurar el inicio de sesión único para Webex para obtener más información sobre la Integración del SSO en la Administración del sitio).

Según cuál sea la configuración en los mecanismos de autenticación de ADFS, la Autenticación de Windows integrada (IWA) puede estar habilitada de manera predeterminada. Si está habilitado, las aplicaciones que se inician a través de Windows (como la aplicación de Webex y Cisco Conector de directorios ) se autentican como el usuario que ha iniciado sesión, independientemente de la dirección de correo electrónico que se introduce durante el mensaje de correo electrónico inicial.

Descargue los metadatos de Webex en su sistema local

Desde la vista del cliente en , vaya a Administración > Configuración de la organización y, a continuación, desplácese hasta Autenticación y, a continuación, active el ajuste del inicio de sesión único para iniciar el asistente https://admin.webex.com de configuración.

Elija el tipo de certificado para su organización:

Autofirmado porCisco: recomendamos esta opción. Permítanos firmar el certificado para que solo tenga que renovarlo una vez cada cinco años.
Firmado por una autoridad de certificación pública: más seguro, pero deberá actualizar los metadatos con frecuencia (a menos que su proveedor de IdP admitaanclajes de confianza).

Los anclajes de confianza son claves públicas que actúan como autoridad para verificar el certificado de una firma digital. Para obtener más información, consulte su documentación de IdP.

Descargue el archivo de metadatos.

El nombre del archivo de metadatos de Webex es idb-meta-<org-ID>-SP.xml.

Instalar metadatos de Webex en ADFS

Antes de comenzar

Control Hub es compatible con ADFS 2.x o versiones posteriores.

Windows 2008 R2 solo incluye ADFS 1.0. Debe instalar ADFS 2.x, como mínimo, de Microsoft.

Para SSO servicios de Webex y de Webex, los proveedores de servicios de identidad (IdP) deben cumplir con la siguiente especificación SAML 2.0:

Establezca el atributo del formato de NameID en urn:oasis:names:tc:SAML:2.0:nameid-format:transient
Configure una instancia de reclamo en el IdP para incluir el nombre de atributo uid con un valor que se asignó al atributo que se elige en Cisco Conector de directorios o el atributo de usuario que coincida con el que se eligió en el servicio de identidad de Webex. (por ejemplo, este atributo podría ser Direcciones de correo electrónico o Nombre principal de usuario). Consulte la información sobre atributos personalizados en https://www.cisco.com/go/hybrid-services-directory para obtener orientación.

1	Inicie sesión en el servidor de ADFS con permisos de administrador.
2	Abra la consola de administración de ADFS y vaya a Relaciones de confianza > Relaciones de confianza para usuario autenticado > Agregar relación de confianza para usuario autenticado.
3	En la ventana del Asistente para agregar partes de confianza, seleccione Iniciar.
4	En el paso para Seleccionar fuente de datos, seleccione Importar datos sobre la parte de confianza desde un archivo , busque el archivo de metadatos de Control Hub que descargó y seleccione Siguiente .
5	En el paso para Especificar nombre para mostrar , cree un nombre en pantalla para esta parte de confianza, como Webex, y seleccione Siguiente.
6	En el paso para Elegir reglas para la autorización de la emisión, seleccione Permitir que todos los usuarios accedan a esta parte de confianza y seleccione Siguiente.
7	En Listo para agregar confianza, seleccione Siguiente y termine de agregar la relación de confianza para usuario autenticado a ADFS.

Crear reglas de reclamos para la autenticación de Webex

En el panel principal de ADFS, seleccione la relación de confianza que creó y, luego, seleccioneEditar reglas de reclamos. En la ficha de Reglas para transformar emisiones, seleccione Agregar regla.

En el paso para Elegir el tipo de regla, seleccione la opción para Enviar atributos LDAP como reclamos; luego, seleccione Siguiente.

Introduzca un Nombre de regla de reclamo.
Seleccione Active Directory como Almacén de atributos.
Asigne el atributo LDAP E-mail-Addresses al tipo de reclamo saliente uid.

La regla le indica a ADFS qué campos debe asignar a Webex para identificar a un usuario. Escriba los tipos de reclamos salientes exactamente como se muestran.
Guarde los cambios.

Vuelva a seleccionar Agregar regla, seleccione Enviar reclamos utilizando una regla personalizada y, luego, seleccione Siguiente.

Esta regla le proporciona a ADFS el atributo "spname qualifier" que Webex no puede ofrecer.

Abra su editor de texto y copie el siguiente contenido.
c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname"] => issue(Type = "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier", Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer, Value = c.Value, ValueType = c.ValueType, Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format"] = "urn:oasis:names:tc:SAML:2.0:nameid-format:transient", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/namequalifier"] = "URL1", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/spnamequalifier"] = "URL2");

Reemplace URL1 y URL2 en el texto de la siguiente manera:
- URL1 es el valor de entityID del archivo de metadatos de ADFS que descargó.
  Por ejemplo, lo que sigue es una muestra de lo que verá: <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="http://ad0a.identitylab20.ciscolabs.com/adfs/services/trust" ID="_55515dde-8147-4183-8a85-b704d26b5dba">
  
  Copie solo el entityID del archivo de metadatos de ADFS y péguelo en el archivo de texto para reemplazar a URL1.
- URL2 está en la primera línea del archivo de metadatos de Webex que descargó.
  Por ejemplo, lo que sigue es una muestra de lo que verá: <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/35a15b0a-0eg1-4029-9f63-a8c54df5df59">
  
  Copie solo el entityID del archivo de metadatos de Webex y péguelo en el archivo de texto para reemplazar a URL2.
Con las URL actualizadas, copie la regla desde su editor de texto (a partir de "c:") y péguela en el cuadro de regla personalizada de su servidor ADFS.

La regla completada se debería ver así:
Seleccione Finalizar para crear la regla; luego, salga de la ventana para Editar reglas de reclamo.

Seleccione la Parte de confianza en la ventana principal y, luego, Propiedades en el panel derecho.

Cuando aparezca la ventana de Propiedades, diríjase a la ficha Avanzadas, SHA-256, y, luego, seleccione Aceptar para guardar sus cambios.

Diríjase a la siguiente URL en el servidor ADFS interno para descargar el archivo: https:// AD_FS_Server>/FederationMetadata/2007-06/FederationMetadata.xml

Es posible que deba hacer clic derecho sobre la página y ver el código fuente de la página para obtener el archivo xml con el formato correcto.

Guarde el archivo en su máquina local.

Qué hacer a continuación

Ya puede volver a importar los metadatos de ADFS a Webex desde el portal de administración.

Importar los metadatos del IdP y habilitar la inicio de sesión único después de una prueba

Después de exportar los metadatos de Webex, configurar su IdP y descargar los metadatos del IdP a su sistema local, estará en disposición de importarlos a su organización de Webex desde Control Hub.

Antes de comenzar

No pruebe la integración del SSO desde la interfaz del proveedor de servicios de identidad (IdP). Solo proporcionamos soporte para los flujos iniciados por el proveedor de servicios, por lo que debe utilizar la prueba de SSO de Control Hub para esta integración.

Elija una opción:

Regrese a la página de selección de certificados del Control Hub en su explorador y, luego, haga clic en Siguiente.
Si el Control Hub ya no está abierto en la ficha del navegador, desde la vista del cliente en , vaya a Administración > Configuración de la organización , desplácese hasta Autenticación y, a continuación, elija Acciones https://admin.webex.com > Importarmetadatos.

En la página Importar metadatos del IdP, arrastre y suelte el archivo de metadatos del IdP a la página o utilice la opción para examinar archivos y localizar y cargar el archivo de metadatos. Haga clic en Siguiente.

Debe utilizar la opción Más seguro, si puede. Esto solo es posible si su IdP utilizó una CA pública para firmar sus metadatos.

En todos los demás casos, debe utilizar la opción Menos seguro. Esto incluye si los metadatos no están firmados, autofirmados o firmados por una CA privada.

Seleccione Prueba SSO configuración y, cuando se abra una nueva ficha del navegador, autentique el IdP iniciando sesión.

Si recibe un error de autenticación, es posible que haya un problema con las credenciales. Controle el nombre de usuario y la contraseña e inténtelo nuevamente.

Un error de la aplicación de Webex suele significar que hay un problema con la SSO configuración. En este caso, repita los pasos, especialmente los pasos en los que copia y pega los metadatos de Control Hub en la configuración del IdP.

Para ver la SSO inicio de sesión de forma directa, también puede hacer clic en Copiar URL al portapapeles desde esta pantalla y pegarla en una ventana privada del explorador. Desde allí, puede realizar un recorrido para iniciar sesión con SSO. Este paso detiene los falsos positivos debido a un token de acceso que podría estar en una sesión existente de que usted haya iniciado sesión.

Vuelva a la ficha del navegador de Control Hub.

Si la prueba fue exitosa, seleccione Prueba exitosa. Active la SSO y haga clic en Siguiente.
Si la prueba no fue exitosa, seleccione Prueba no exitosa. Desactive el SSO y haga clic en Siguiente .

La SSO de ajustes no tendrá efecto en su organización a menos que elija el nombre botón de opciones y active SSO.

Qué hacer a continuación

Puede seguir el procedimiento en Suprimir correos electrónicos automatizados para deshabilitar los correos electrónicos que se envían a los nuevos usuarios de la aplicación deWebex en su organización. El documento también contiene las mejores prácticas para enviar las comunicaciones a usuarios de su organización.

Actualizar la parte de confianza de Webex en ADFS

Esta tarea se trata específicamente sobre la actualización de AD FS con nuevos metadatos de SAML de Webex. Hay artículos relacionados si tiene que configurar el SSO con AD FS o si tiene que actualizar un IdP (diferente) con los metadatos de SAML para un nuevo certificado de SSO de Webex.

Antes de comenzar

Tiene que exportar el archivo de metadatos saml desde Control Hub para poder actualizar la parte de confianza de Webex en AD FS.

Inicie sesión en el servidor de AD FS con permisos de administrador.

Cargue el archivo de metadatos SAML de Webex a una carpeta local temporal en el servidor de AD FS, por ejemplo. //ADFS_servername/temp/idb-meta-<org-ID>-SP.xml.

Abra Powershell.

Ejecutar Get-AdfsRelyingPartyTrust para leer todas las partes de confianza.

Tenga en cuenta la TargetName parámetro de la relación de confianza del usuario autenticado de Webex. Utilizamos el ejemplo “Cisco Webex”, pero podría ser diferente en su AD FS.

Ejecutar Update-AdfsRelyingPartyTrust -MetadataFile "//ADFS_servername/temp/idb-meta-<org-ID>-SP.xml" -TargetName "Cisco Webex".

Asegúrese de sustituir el nombre del archivo y el nombre de destino por los valores correctos de su entorno.

Consulte .https://docs.microsoft.com/powershell/module/adfs/update-adfsrelyingpartytrust

Si ha descargado el certificado de 5 años de Webex SP y tiene activada la revocación de certificado de firma o cifrado, debe ejecutar estos dos comandos: Set-AdfsRelyingPartyTrust -SigningCertificateRevocationCheck None -EncryptionCertificateRevocationCheck None.

Inicie sesión en Control Hub y, a continuación, pruebe la integración del SSO:

Vaya a Administración > Configuración de la organización , desplácese hasta Autenticación y active el ajuste inicio de sesión único para iniciar el asistente de configuración.
Haga clic en Siguiente para omitir la página Importar metadatos del IdP.

No es necesario que repita ese paso, ya que anteriormente ha importado los metadatos del IdP.

Pruebe la conexión de SSO antes de habilitarla. Este paso funciona como una ejecución de prueba y no afecta la configuración de su organización hasta que habilite la SSO en el próximo paso.

Para ver la SSO inicio de sesión de forma directa, también puede hacer clic en Copiar URL al portapapeles desde esta pantalla y pegarla en una ventana privada del explorador. Desde allí, puede realizar un recorrido para iniciar sesión con SSO. Esto ayuda a eliminar cualquier información almacenada en caché en su explorador web que pueda proporcionar un resultado positivo falso al probar la configuración de SSO explorador.

Inicie sesión para completar la prueba.

Solución de problemas en ADFS

Errores de ADFS en registros de Windows

En los registros de Windows es posible que vea un código de error 364 en el registro de eventos de ADFS. Los detalles del evento identifican la presencia de un certificado no válido. En estos casos, el host de ADFS no tiene autorización para atravesar el firewall en el puerto 80 para validar el certificado.

Ocurrió un error durante un intento de crear la cadena de certificados para la parte de confianza

Al actualizar el SSO certificado, es posible que se le presente este error al iniciar sesión: Invalid status code in response.

Si ve ese error, verifique los registros del Visor de eventos en el servidor ADFS y busque el siguiente error: An error occurred during an attempt to build the certificate chain for the relying party trust 'https://idbroker.webex.com/<org-ID>' certificate identified by thumbprint '754B9208F1F75C5CC122740F3675C5D129471D80'. Las posibles causas son que se revocó el certificado, que no se pudo verificar la cadena de certificados como se especifica en la configuración de revocación de certificados de cifrado de la parte de confianza, o que el certificado no está dentro de su período de validez.

Si se produce este error, debe ejecutar los comandos Set-ADFSRelyingPartyTrust -TargetIdentifier https://idbroker.webex.com/<orgID> -EncryptionCertificateRevocationCheck None

ID de federación

El ID de federación distingue entre mayúsculas y minúsculas. Si esta es la dirección de correo electrónico de su organización, introd así lo envía ADFS; si no lo hace, Webex no podrá encontrar el usuario que coincida.

No se puede redactar una regla de reclamo personalizada para normalizar el atributo LDAP antes de enviarlo.

Importe sus metadatos desde el servidor de AD FS que configuró en su entorno.

Si es necesario, puede verificar la URL; para ello, navegue hasta Servicio > Extremos > Metadatos > Tipo: Metadatos de federación en la Administración de ADFS.

Sincronización de la hora

Asegúrese de que el reloj del sistema de su servidor ADFS esté sincronizado con una fuente de hora de Internet confiable que emplee el Protocolo de hora de red (Network Time Protocol, NTP). Utilice el siguiente comando de PowerShell para sesgar el reloj solo para la relación de parte de confianza de Webex.

Set-ADFSRelyingPartyTrust -TargetIdentifier "https://idbroker.webex.com/$ENTITY_ID_HEX_VALUE" -NotBeforeSkew 3

El valor hexadecimal es único para su entorno. Reemplace el valor a partir del valor de ID de EntityDescriptor del SP en el archivo de metadatos de Webex. Por ejemplo:

<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/c0cb726f-a187-4ef6-b89d-46749e1abd7a">