> Source: https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/SsoPreAuthData/

# Pre-authentication Web SSO data

> **Ventana interna del módulo Applications**
>
> Se accede a esta ventana desde el módulo **Applications**, en una aplicación cuyo tipo de servicio es **Web** y cuyo **SSO type** es **Pre-authentication**: el botón **Configure pre-authentication steps** abre la lista de pasos, donde el submenú del botón de adición ofrece añadir un **data creation step**. La ventana lleva un icono de ayuda que abre la página de ayuda del módulo.

La ventana **Pre-authentication Web SSO data** permite a un administrador definir un dato que el Mediation Controller debe **almacenar** en el navegador (variable local, variable de sesión o cookie) antes de la fase final de preautenticación de una aplicación Web SSO.

## Campos del formulario

| Campo | Descripción |
|---|---|
| **Type** | Obligatorio, lista desplegable no editable. Opciones: **Local variable** *(predeterminado)*, **Session variable**, **Cookie**. El valor seleccionado determina la visualización de los campos propios de las cookies, más abajo. |
| **Name** | Obligatorio. Se rechaza una cadena compuesta únicamente de espacios. Identifica el dato. |
| **Value** | Valor que debe almacenarse. De forma predeterminada puede contener elementos interpretados por el motor de preautenticación: un mensaje situado debajo del campo recuerda que **This field follows a special syntax. Please consult the help page for more informations.** Véase la sección 3. |
| **Disable special syntax** | Casilla de verificación. Una vez marcada, el valor se toma tal cual y el mensaje sobre la sintaxis desaparece. Las entradas creadas con esta opción se muestran **en cursiva** en la lista de pasos. |
| **Handle as JSON data** | Casilla de verificación. El valor se trata entonces como un objeto JSON y no como una cadena. |

El **Type** determina dónde se almacena el dato:

| Type | Ubicación |
|---|---|
| **Local variable** | Almacenamiento local del navegador. |
| **Session variable** | Almacenamiento de sesión del navegador. |
| **Cookie** | Una cookie establecida en el navegador, con los campos de la sección 2. |

## Campos propios de las cookies

Cuando **Type** vale **Cookie**, aparecen cuatro campos adicionales y la ventana se agranda:

| Campo | Descripción |
|---|---|
| **Path** | Restringe la cookie a las URL que coinciden con la ruta indicada. Valor predeterminado `/`, que la hace disponible en todas las URL; se añade un `/` inicial al guardar cuando la entrada no lo lleva. |
| **Lifetime (hours)** | Número entero. La fecha de caducidad se calcula al ejecutarse el SSO, sumando esta duración a la hora actual. ⚠ Un **valor nulo o negativo hace que la cookie caduque de inmediato**. Si se deja vacío, no se envía ninguna fecha de caducidad y la cookie se convierte en una cookie de sesión. |
| **Secured cookie** | Casilla de verificación. La cookie solo puede utilizarse entonces cuando la conexión con el sitio es segura (HTTPS). |
| **SameSite** | Lista desplegable no editable: **Strict**, **Lax** *(predeterminado)* o **None**. Define cómo se comporta la cookie con las solicitudes procedentes de otro sitio. |

## Sintaxis especial de los valores

El campo **Value** admite cadenas de sustitución, reemplazadas al ejecutarse el SSO. La misma sintaxis se aplica a los parámetros, encabezados y cuerpos de las [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Sustitución | Efecto |
|---|---|
| `%user%` | Login que debe utilizarse para el SSO. |
| `%password%` | Contraseña que debe utilizarse para el SSO. |
| `%base64([...])%` | Codifica el contenido de los corchetes en base 64. |
| `%lowercase([...])%` | Convierte el contenido a minúsculas. |
| `%uppercase([...])%` | Convierte el contenido a mayúsculas. |
| `%trim([...])%` | Elimina los espacios iniciales y finales del contenido. |
| `%uriencoded([...])%` | Sustituye los caracteres especiales poco habituales por su codificación UTF-8, para su uso en una URL. |

También hay disponibles funciones de cifrado:

| Función | Parámetros esperados |
|---|---|
| `%sha256([...])%` | El dato que debe cifrarse (SHA-256). |
| `%md5([...])%` | El dato que debe cifrarse (MD5). |
| `%hmacmd5([...])%` | Dos parámetros: el dato que debe cifrarse y después la clave de cifrado. |
| `%rsa([...])%` | Dos parámetros: la clave pública y después el dato que debe cifrarse. |
| `%rsaoaep([...])%` | Dos parámetros: la clave pública en formato PEM y después la cadena que debe cifrarse. |
| `%reqresult([...])%` | El número de orden de la solicitud cuyo resultado debe reutilizarse y, opcionalmente, el nombre de la clave que debe tomarse cuando ese resultado contiene varios parámetros. |

> **Dos convenciones de escritura**
>
> Los parámetros de una función se separan con **`%,%`**. Para introducir un signo de porcentaje literal, escriba **`\%`**.

## Guardar

Pulse **Validate** para añadir o actualizar el dato en el paso de preautenticación actual. **Cancel** cierra la ventana sin guardar.
