Configurar el SSO empresarial con OIDC
Acerca del SSO empresarial con OIDC
El inicio de sesión único (SSO) empresarial permite a tu organización usar tu proveedor de identidad existente para autenticar a los usuarios en todos tus negocios de Square. La implementación de Square admite el SSO iniciado por el proveedor de servicios (SP) y el SSO iniciado por el proveedor de identidad (IDP).
Cuando activas el SSO para un negocio, se aplica automáticamente a todos los usuarios de tus dominios verificados para ese negocio. Esto garantiza políticas de autenticación consistentes en toda tu organización, al tiempo que mantiene la administración centralizada de usuarios en tu proveedor de identidad.
Antes de comenzar
Tienes 2 opciones para los proveedores de identidad:
Okta como tu proveedor de identidad
Microsoft Entra ID (anteriormente Azure AD) como tu proveedor de identidad
También necesitas lo siguiente:
Acceso administrativo a tu proveedor de identidad (Okta o Entra ID). Asegúrate de haber iniciado sesión en tus proveedores de identidad:
Capacidades de verificación de propiedad del dominio (acceso DNS o acceso de administrador de correo electrónico).
El permiso Administrar inicio de sesión único en todos los negocios de Square para los que quieras activar el inicio de sesión único. Si tienes Acceso completo o eres el Propietario de la cuenta, lo tendrás automáticamente para dicho negocio. El propietario de la cuenta de cada negocio puede invitarte al negocio de Square y otorgarte el permiso.
Importante: Cuando activas el SSO para un negocio, se aplica automáticamente a todas las personas de tus dominios verificados que tengan acceso a ese negocio. Activar el SSO también elimina los números de teléfono de inicio de sesión de todas las cuentas de sus dominios verificados, así como las contraseñas y llaves de acceso de las cuentas que solo usan SSO. Planifique la implementación en consecuencia y asegúrate de que tu proveedor de identidad esté configurado correctamente antes de activar el inicio de sesión único. Podrás probar el SSO con cuentas individuales antes de activarlo para todo el negocio.
Paso 1: Configura tu proveedor de identidad en el Panel de datos Square
Puedes configurarlo desde el Panel de Datos Square de cualquier negocio. Podrás seleccionar si aplica solo para ese negocio o para todos tus negocios en el Paso 2.
Inicia sesión en el Panel de Datos Square, ve a Ajustes > Cuenta y configuración > Mi negocio> Seguridad.
Haz clic en Configurar en Proveedor de identidad
Selecciona Okta o Microsoft Entra ID y proporciona un nombre para esta configuración de proveedor de identidad. Este nombre es solo para tu referencia durante la configuración.
Sigue las instrucciones para verificar tus dominios mediante un registro TXT.
-
Agrega el registro TXT a través de tu proveedor de DNS y vuelve a Square para iniciar la verificación. Confirma que el estado de verificación sea Verificado.
Si la verificación falla, asegúrate de que se haya aplicado el registro TXT e intenta verificarlo nuevamente de forma periódica. La propagación puede tardar hasta 72 horas.
Selecciona los negocios que quieres administrar con este proveedor de identidad. Esto no activa automáticamente el SSO para esos negocios.
Una vez que tu proveedor de identidad aparezca como Activo, puedes continuar con la activación del SSO para tu negocio.
Paso 2: Configura y activa el SSO para tu negocio
Qué cambia cuando activas el SSO
Cuando activas el SSO para un negocio, los siguientes métodos de inicio de sesión cambian para las cuentas de tus dominios verificados a fin de garantizar que cada cuenta use los métodos de autenticación previstos:
Método de inicio de sesión |
Cuentas que solo usan SSO |
Cuentas con SSO opcional |
|---|---|---|
Contraseña |
Se elimina |
Se conserva |
Llaves de acceso |
Se eliminan |
Se conservan |
Número de teléfono para inicio de sesión |
Se elimina |
Se elimina |
Los métodos de inicio de sesión eliminados no se restauran si desactivas el SSO.
Antes de activar el SSO para todo un negocio, configura tus cuentas de emergencia (cuentas de respaldo que pueden iniciar sesión si el SSO falla) estableciendo el SSO como Opcional, lo que permite iniciar sesión mediante SSO o contraseña. Confirma que cada una pueda iniciar sesión con su contraseña o llave de acceso.
Inicia sesión en el Panel de Datos Square, ve a Ajustes > Cuenta y configuración > Mi negocio> Seguridad.
Haz clic en Configurar en Inicio de sesión único.
Sigue las instrucciones en pantalla para conectar el inicio de sesión único con tu proveedor de identidad.
-
Activa el inicio de sesión único para cuentas individuales.
Cuando configuras una cuenta como Opcional, esta puede iniciar sesión mediante SSO o con métodos de inicio de sesión tradicionales. Esta configuración reemplaza cualquier configuración establecida para todo el negocio y puede usarse para las cuentas de emergencia.
Cuando configuras una cuenta como Obligatorio, solo puede iniciar sesión mediante SSO.
Cuando estés listo para implementar el inicio de sesión único como Obligatorio en todo el negocio, selecciona Administrar SSO para negocios en el menú desplegable.
Selecciona los negocios para los que quieres activar el inicio de sesión único. Puedes elegir entre los negocios administrados por tu proveedor de identidad.
Selecciona las cuentas individuales que deben tener el inicio de sesión único como Opcional. Esta configuración reemplaza la configuración establecida para todo el negocio. Estas serán tus cuentas de emergencia.
Importante: Una vez que se active el inicio de sesión único para un negocio, todos los usuarios que trabajen para ese negocio y tengan direcciones de correo electrónico pertenecientes a tus dominios verificados deberán usar el inicio de sesión único para iniciar sesión.
La configuración no cerrará automáticamente las sesiones de las cuentas. Una vez completados los pasos de configuración, la próxima vez que una cuenta con SSO Obligatorio ingrese su dirección de correo electrónico en la página de inicio de sesión de Square, será redirigida al proveedor de identidad para iniciar sesión.
Paso 3: Inicia sesión mediante SSO iniciado por el proveedor de servicios
Todas las cuentas y usuarios de los negocios que tengan el SSO activado podrán iniciar sesión mediante el inicio de sesión único tanto en el Panel de Datos Square como en Punto de venta. Los inicios de sesión mediante código de dispositivo y código de acceso no se ven afectados.
Cada método de inicio de sesión responde de manera diferente al SSO:
Método de inicio de sesión |
¿Se ve afectado por el SSO? |
Notas |
|---|---|---|
Inicio de sesión web de Square (correo electrónico y contraseña) |
Sí |
Las cuentas con SSO Obligatorio se redirigen a tu proveedor de identidad. |
Llaves de acceso |
Sí |
Las cuentas con SSO Obligatorio no pueden usar llaves de acceso. Las cuentas con SSO Opcional sí pueden hacerlo. |
Aplicaciones de Square para iOS y Android |
Sí |
Las cuentas con SSO Obligatorio se redirigen a tu proveedor de identidad. |
Inicio de sesión mediante código de dispositivo |
No |
|
Inicio de sesión mediante código de acceso |
No |
-
Ingresa tu correo electrónico y haz clic en Continuar.
Haz clic en Iniciar sesión con SSO si la cuenta está configurada como Opcional.
Recomendaciones
Activa la autenticación de dos factores
Usuarios de Okta: Activa las políticas de autenticación multifactor (MFA) en la consola de administración de Okta para todos los usuarios que accedan a Square.
Usuarios de MicrosoftEntra ID: Activa la MFA de Azure AD para todos los usuarios en tus políticas de acceso condicional.
La autenticación sólida a nivel de proveedor de identidad es fundamental, ya que el SSO elude la seguridad de inicio de sesión nativa de Square.
Mantén el acceso de emergencia
Puedes configurar cuentas de emergencia activando el inicio de sesión único como Opcional para cuentas individuales. Consulta el Paso 2 para configurar esta opción.
Prueba el acceso a la cuenta de emergencia con regularidad.
Documenta los procedimientos de emergencia para tu equipo de TI.
Guarda las credenciales de las cuentas de emergencia de forma segura y separadas de tus sistemas principales.
Las cuentas de Propietario de la cuenta o con Acceso completo que tengan acceso a todos los negocios para los que vas a activar el inicio de sesión único son buenas opciones como cuentas de emergencia.
Haz pruebas antes de implementarlo por completo
Empieza con un grupo piloto de usuarios.
Prueba el acceso mediante inicio de sesión único en distintas aplicaciones de Square: Panel de Datos, Punto de venta y aplicaciones de Square para iOS y Android.
Ingresa el correo electrónico de una cuenta con SSO Obligatorio en la página web de inicio de sesión. Confirma que se redirija a tu proveedor de identidad.
Verifica que los permisos y roles de los usuarios se mantengan después de iniciar sesión mediante SSO.
Confirma que las cuentas de emergencia funcionen según lo previsto, incluido el inicio de sesión con su contraseña o llave de acceso.
Confirma que el inicio de sesión mediante código de dispositivo siga funcionando en los dispositivos que usa tu equipo.
Cuando venza tu suscripción a Square Premium
Square Premium es necesario para usar SSO. Si vence la suscripción de un negocio:
El SSO se desactiva de inmediato para ese negocio.
Las cuentas vuelven a usar el inicio de sesión de Square. Las cuentas con SSO Obligatorio ya no tienen que usar tu proveedor de identidad.
Las contraseñas de las cuentas con SSO Obligatorio se eliminaron cuando activaste el SSO. Después de que venza la suscripción, podrán iniciar sesión con un código de un solo uso enviado a su correo electrónico. Luego, se les pedirá que agreguen una contraseña.
Las llaves de acceso y los números de teléfono de inicio de sesión no se restauran. Deberás agregarlos nuevamente.
Soluciona problemas comunes
Error en la verificación de dominio
Problema: La verificación del dominio no se completa correctamente
Soluciones:
Método DNS: Asegúrate de que el registro TXT se haya agregado correctamente a los ajustes de DNS de tu dominio. La propagación del DNS puede demorar hasta 72 horas
Varios dominios: Si tienes varios dominios, verifica cada uno por separado.
Los usuarios no pueden iniciar sesión después de activar el inicio de sesión único
Problema: Los usuarios reciben errores al intentar iniciar sesión en Square
Soluciones:
El dominio no coincide: Asegúrate de que las direcciones de correo electrónico de los usuarios coincidan exactamente con tus dominios verificados.
Asignación de usuario: Verifica que los usuarios estén asignados a la aplicación OIDC en tu proveedor de identidad
Estado de cuenta: Verifica que las cuentas de usuario estén activas en tu proveedor de identidad
Problemas con el navegador: Borra la memoria caché y las cookies del navegador o prueba una sesión de navegación incógnita/privada
Permisos de la aplicación: Asegúrate de que la aplicación OIDC tenga los permisos necesarios para leer la información del perfil de usuario.
Una cuenta con SSO Obligatorio no puede iniciar sesión con una contraseña
Problema: La contraseña de una cuenta con SSO Obligatorio no funciona en la página de inicio de sesión de Square.
Soluciones:
Comportamiento esperado: El SSO elimina las contraseñas de las cuentas con SSO Obligatorio. Inicia sesión a través de tu proveedor de identidad.
SSO desactivado: Inicia sesión con un código de un solo uso enviado a tu correo electrónico. Luego, se te pedirá que agregues una contraseña.
El inicio de sesión único no funciona en todos los negocios
Problema: Los ajustes de Inicio de sesión único no se aplican de manera consistente en varios negocios
Soluciones:
Asociación de negocios: Asegúrate de que todos los negocios estén configurados correctamente en los ajustes del proveedor de identidad y en los ajustes de Inicio de sesión único desde el Panel de datos Square
Verificación del dominio: Comprueba que todos los dominios utilizados estén verificados desde el Panel de Datos Square.
Tiempo de propagación: Espera hasta 30 minutos para que los ajustes de Inicio de sesión único se propaguen a todos los negocios