Multimarca - Uso de varios URL con inicio de sesión único JWT

¿Qué plan tengo?

Suite

Growth, Professional, Enterprise o Enterprise Plus

Support

Enterprise

Descargo de responsabilidad: Este artículo se ofrece con fines de instrucción únicamente. Zendesk no ofrece soporte para el código personalizado ni lo garantiza.

La multimarca le permite controlar todas las marcas de su compañía en una sola cuenta de Zendesk Support. Sin embargo, la configuración de seguridad solo le permite configurar un URL para los inicios de sesión remotos, algo que puede ser problemático si tiene varias bases de datos de usuarios para cada una de sus marcas.

El nuevo método le permitirá crear un script entre Zendesk Support y el script de inicio de sesión único (SSO) en su servidor con el que podrá dirigir a los clientes a URL específicos conforme a la marca a la que deseen acceder.

Este procedimiento supone que ya ha configurado JWT en su servidor. Si no es así, asegúrese de seguir las instrucciones que se describen en el artículo Activar el inicio de sesión único con JWT.

El ejemplo en este artículo utiliza PHP, pero se puede adaptar a otros lenguajes si fuera necesario.

Este artículo contiene las siguientes secciones:

• Dos o más marcas o más configuración
• Dos o más sistemas de autenticación de usuario configurados con SSO con JWT
• Los scripts
• Actualizar configuración de seguridad
• Consideraciones importantes
• Resolución de problemas

Configuración de dos o más marcas

Se tienen que configurar por lo menos dos marcas para poder seguir este procedimiento. Si desea ver detalles, consulte Configuración de varias marcas (complemento de Professional, incluido en Enterprise).

Después de configurarlas, guarde el URL de la marca y el URL de la marca con mapeo de host. Los usaremos con el script más adelante.

Dos o más sistemas de autenticación de usuario configurados con SSO con JWT

Como se mencionó anteriormente, tiene que tener configurado el SSO con JWT en sus sistemas de autenticación de usuario. Podría tener uno por cada marca, pero tome en cuenta que el secreto compartido que obtiene de sus opciones de seguridad tiene que ser el mismo en todos los sistemas de autenticación.

Guarde el URL de inicio de sesión y el URL de cierre de sesión junto con la información de la sección anterior.

Los scripts

La lista de URL guardados podría ser parecida a esta:

Marca 1

URL sin mapeo de host: https://brand1.zendesk.com

URL con mapeo de host: https://support1.example.com

Marca 2

URL sin mapeo de host: https://brand2.zendesk.com

URL con mapeo de host: https://support2.example.com

Sistema 1

URL de inicio de sesión: https://page1.example.com/zdlogin.php

URL de cierre de sesión: https://page1.example.com/zdlogout.php

Sistema 2

URL de inicio de sesión: https://page2.example.com/zdlogin.php

URL de cierre de sesión: https://page2.example.com/zdlogout.php

A continuación, cree el script. Elimine https:// del URL para el URL de cada marca. Consérvelos en los vínculos de sitio web.

Estos scripts también se pueden encontrar aquí:

• zdlogin.php
• zdlogout.php

Script de inicio de sesión

<?

$brand_URLs = array(
	"brand1.zendesk.com" => "https://page1.example.com/yourcustomloginjwtscript.php",
	"support1.example.com" => "https://page1.example.com/yourcustomloginjwtscript.php",
	"brand2.zendesk.com" => "https://page2.example.com/yourcustomloginjwtscript2.php",
	"support2.example.com" => "https://page2.example.com/yourcustomloginjwtscript2.php"
	);

foreach($brand_URLs as $k => $v){
	if(strpos($_GET['return_to'],$k)){
		header("Location: ". $v);
		die();
	}
}

?>

Script de cierre de sesión

<?

$brand_URLs = array(
	"brand1.zendesk.com" => "https://page1.example.com/yourcustomlogoutjwtscript.php",
	"support1.example.com" => "https://page1.example.com/yourcustomlogoutjwtscript.php",
	"brand2.zendesk.com" => "https://page2.example.com/yourcustomlogoutjwtscript.php",
	"support2.example.com" => "https://page2.example.com/yourcustomlogoutjwtscript.php"
	);

foreach($brand_URLs as $k => $v){
	if(strpos($_GET['return_to'],$k)){
		header("Location: ". $v);
		die();
	}
}
?>

Actualizar configuración de seguridad

1. En el Centro de administración, haga clic en Cuenta en la barra lateral y luego seleccione Seguridad > Inicio de sesión único.
2. Haga clic en Crear configuración de SSO y luego seleccione Token Web JSON.
3. Ingrese un Nombre de configuración único.
4. Para el URL de inicio de sesión remoto, ingrese el script de inicio de sesión del URL.
5. Para el URL de cierre de sesión remoto, ingrese el script de cierre de sesión del URL.
6. Para evitar conflictos si se da el caso de que algunos de sus clientes tienen una cuenta en más de un sistema de autenticación de usuarios con la misma dirección de correo electrónico, se sugiere seleccionar Activado para la opción ¿Actualizar ID externas?
7. Proporcione el Secreto compartido al equipo de TI. Lo necesitarán para su implementación de JWT.
8. Guarde los cambios.

Consideraciones importantes

• El riesgo de seguridad es reducido si usa el script tal como está. En cambio, si lo modifica considerablemente (excepto por los cambios aquí mencionados), podría crear una vulnerabilidad en la seguridad de su propio servidor (no el de Zendesk).
• Puesto que solo ofrecemos un token JWT, todos los scripts SSO usarán los mismos tokens en sus sistemas de autenticación. Si uno de sus sistemas se ve comprometido, existe la posibilidad de que todas sus marcas se vean comprometidas.
• Si recibe un error "Solicitud de JWT no válida" cuando intenta usar SSO, consulte las instrucciones de Resolución de problemas a continuación.

Resolución de problemas

Para evitar errores de solicitud de JWT no válida, codifique https://(subdominiopredeterminado).zendesk.com/ como /access/jwt?jwt= para ambas marcas donde (subdominiopredeterminado) es el subdominio de la marca principal. Por ejemplo, midominio.zendesk.com.

1. Codifique https://(subdominiopredeterminado).zendesk.com en un script de SSO, para que la carga JWT siempre sea enviada a https://(subdominiopredeterminado).zendesk.com/access/jwt
2. Implemente ese fragmento en el script para usar “return_to” para que el usuario final sea redirigido de nuevo al Centro de ayuda de origen. Asegúrese de anexar la carga para los URL de ambas marcas como fijos “(subdominiopredeterminado)” y anexe “return_to”.
   
   El fragmento para su referencia:
   

if(isset($_GET["return_to"])) {
  $location .= "&return_to=" . urlencode($_GET["return_to"]);
}