Configuración SAML

SmartOSH permite la autenticación de usuarios mediante el protocolo SAML. Esta guía está dirigida a administradores de entornos de autenticación y detalla cómo activar el enlace con un proveedor de identidad SAML.

Requisitos previos

El entorno SmartOSH debe estar configurado con una URL personalizada antes de iniciar la integración. Si existen entornos de PRE y PRO, el proceso debe realizarse en cada uno de ellos de forma independiente.

Entorno	Ejemplo de URL
PRO (producción)	https://cliente.smartosh.com
PRE (preproducción)	https://cliente.pre.smartosh.com

Intercambio de metadatos

El orden de estos pasos no es importante; pueden ejecutarse en el orden que resulte más conveniente para el cliente o el consultor.

Obtener y enviar la URL de metadatos al cliente

1. Accede a Ajustes del entorno SmartOSH.
2. Ve a la sección SSO.
3. Copia la URL de SAML metadata que aparece en esa sección.
4. Envía esa URL al cliente para que pueda descargar el fichero XML de metadatos de SmartOSH.

Cargar los metadatos del cliente

El cliente proporcionará su configuración SAML obtenida desde su propio proveedor de identidad.

1. Ve a Ajustes → Operaciones → Importar SAML Metadata.
2. Carga el fichero XML proporcionado por el cliente.

Consejo

La importación configura y activa automáticamente todos los campos de la sección SAML: nombre, URL, atributo y certificados. En este momento también puedes personalizar el texto del botón de acceso, por ejemplo «Entrar con CLIENTE».

Una vez completados estos pasos, el entorno estará listo para autenticarse mediante SAML.

Ejemplos de configuración

Azure Entra ID

Paso 1 — Crear la aplicación Enterprise

1. En Azure Portal, accede a Azure Entra ID → Enterprise Applications.
2. Haz clic en New application → Create your own application.
3. Nombre: SmartOSH.
4. Selecciona Integrate any other application you don’t find in the gallery (Non-gallery).
5. Haz clic en Create.

Paso 2 — Configurar SAML

1. En la aplicación creada, ve a Manage → Single sign-on.
2. Selecciona SAML.
3. En la sección Basic SAML Configuration, haz clic en Upload metadata file.
4. Sube el fichero XML de metadatos de SmartOSH.
5. Azure completará automáticamente:
   • Identifier (Entity ID): https://smartosh.com/samlsp
   • Reply URL (Assertion Consumer Service URL)
6. Haz clic en Save.

Paso 3 — Obtener los metadatos de Azure

1. En SAML Certificates, descarga el Federation Metadata XML.
2. Envía este fichero a SmartOSH para completar la configuración (ver Cargar los metadatos del cliente).

Paso 4 — Asignar usuarios

De acuerdo con los procedimientos internos del cliente, asigna los usuarios o grupos correspondientes a la aplicación recién creada.

---

Okta

Nota

Okta no admite la carga de configuraciones mediante fichero de metadatos. La configuración debe realizarse manualmente con los parámetros indicados a continuación.

Paso 1 — Acceder a aplicaciones

1. Inicia sesión en el panel de administración de Okta.
2. En el menú lateral, ve a Applications → Applications.

Paso 2 — Crear la integración

1. Haz clic en Create App Integration.
2. Selecciona SAML 2.0 → Siguiente.

Paso 3 — Configuración general

1. App name: SmartOSH
2. Siguiente.

Paso 4 — Configuración básica

Parámetro	Entorno PRO	Entorno PRE
Single sign-on URL	https://CLIENTE.smartosh.com/SAMLConsumeService.aspx	https://CLIENTE.pre.smartosh.com/SAMLConsumeService.aspx
Audience URI (SP Entity ID)	https://smartosh.com/samlsp	https://smartosh.com/samlsp
Application username	Email (o lo acordado con SmartOSH)	Email (o lo acordado con SmartOSH)

Marca la opción Use this for Recipient URL and Destination URL. El resto de parámetros pueden dejarse con los valores por defecto o ajustarse según el criterio del cliente.

Paso 5 — Configuración avanzada (Click “Show Advanced Settings”)

En Other Requestable SSO URLs, añade las siguientes entradas:

Entorno PRO:

URL	Index
https://CLIENTE.backend.my.smartosh.com/Account/SAMLCallbackNG	2
https://CLIENTE.backend.my.smartosh.com/Account/SAMLCallbackIonic	3

Entorno PRE:

URL	Index
https://CLIENTE.backend.pre-my.smartosh.com/Account/SAMLCallbackNG	2
https://CLIENTE.backend.pre-my.smartosh.com/Account/SAMLCallbackIonic	3

El resto de parámetros pueden dejarse con los valores por defecto o ajustarse según el criterio del cliente.

---

Fuente: KB041 – Configuración SAML, versión 1.0.00, 24/11/2025.