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

# Pre-authentication Web SSO data

> **Janela interna do módulo Applications**
>
> Esta janela é acedida a partir do módulo **Applications**, numa aplicação cujo tipo de serviço é **Web** e cujo **SSO type** é **Pre-authentication**: o botão **Configure pre-authentication steps** abre a lista de etapas, onde o submenu do botão de adição oferece adicionar uma **data creation step**. A janela tem um ícone de ajuda que abre a página de ajuda do módulo.

A janela **Pre-authentication Web SSO data** permite a um administrador definir um dado que o Mediation Controller deve **armazenar** no navegador (variável local, variável de sessão ou cookie) antes da fase final de pré-autenticação de uma aplicação Web SSO.

## Campos do formulário

| Campo | Descrição |
|---|---|
| **Type** | Obrigatório, lista suspensa não editável. Opções: **Local variable** *(predefinido)*, **Session variable**, **Cookie**. O valor selecionado determina a apresentação dos campos próprios dos cookies, mais abaixo. |
| **Name** | Obrigatório. Uma cadeia composta apenas de espaços é rejeitada. Identifica o dado. |
| **Value** | Valor a armazenar. Por predefinição pode conter elementos interpretados pelo motor de pré-autenticação: uma mensagem abaixo do campo recorda que **This field follows a special syntax. Please consult the help page for more informations.** Consulte a secção [Sintaxe especial dos valores](#special-syntax-of-values). |
| **Disable special syntax** | Caixa de verificação. Uma vez selecionada, o valor é tomado tal como está e a mensagem sobre a sintaxe desaparece. As entradas criadas com esta opção são apresentadas **em itálico** na lista de etapas. |
| **Handle as JSON data** | Caixa de verificação. O valor é então tratado como um objeto JSON e não como uma cadeia. |

O **Type** determina onde o dado é armazenado:

| Type | Localização |
|---|---|
| **Local variable** | Armazenamento local do navegador. |
| **Session variable** | Armazenamento de sessão do navegador. |
| **Cookie** | Um cookie definido no navegador, com os campos da secção [Campos próprios dos cookies](#cookie-specific-fields). |

## Campos próprios dos cookies

Quando **Type** vale **Cookie**, aparecem quatro campos adicionais e a janela aumenta:

| Campo | Descrição |
|---|---|
| **Path** | Restringe o cookie aos URL que correspondem ao caminho indicado. Valor predefinido `/`, que o torna disponível em todos os URL; é adicionado um `/` inicial ao guardar quando a entrada não o tem. |
| **Lifetime (hours)** | Número inteiro. A data de expiração é calculada quando o SSO é executado, somando esta duração à hora atual. ⚠ Um **valor nulo ou negativo faz o cookie expirar imediatamente**. Se for deixado vazio, não é enviada nenhuma data de expiração e o cookie passa a ser um cookie de sessão. |
| **Secured cookie** | Caixa de verificação. O cookie só pode então ser utilizado quando a ligação ao site é segura (HTTPS). |
| **SameSite** | Lista suspensa não editável: **Strict**, **Lax** *(predefinido)* ou **None**. Define como o cookie se comporta com os pedidos provenientes de outro site. |

## Sintaxe especial dos valores

O campo **Value** aceita cadeias de substituição, substituídas quando o SSO é executado. A mesma sintaxe aplica-se aos parâmetros, cabeçalhos e corpos dos [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/pt/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Substituição | Efeito |
|---|---|
| `%user%` | Login a utilizar para o SSO. |
| `%password%` | Palavra-passe a utilizar para o SSO. |
| `%base64([...])%` | Codifica o conteúdo dos parênteses retos em base 64. |
| `%lowercase([...])%` | Converte o conteúdo para minúsculas. |
| `%uppercase([...])%` | Converte o conteúdo para maiúsculas. |
| `%trim([...])%` | Remove os espaços iniciais e finais do conteúdo. |
| `%uriencoded([...])%` | Substitui os caracteres especiais pouco habituais pela sua codificação UTF-8, para utilização num URL. |

Também estão disponíveis funções de cifragem:

| Função | Parâmetros esperados |
|---|---|
| `%sha256([...])%` | O dado a submeter a hash (SHA-256). |
| `%md5([...])%` | O dado a submeter a hash (MD5). |
| `%hmacmd5([...])%` | Dois parâmetros: o dado a cifrar e depois a chave de cifragem. |
| `%rsa([...])%` | Dois parâmetros: a chave pública e depois o dado a cifrar. |
| `%rsaoaep([...])%` | Dois parâmetros: a chave pública no formato PEM e depois a cadeia a cifrar. |
| `%reqresult([...])%` | O número de ordem do pedido cujo resultado deve ser reutilizado e, opcionalmente, o nome da chave a tomar quando esse resultado contém vários parâmetros. |

> **Duas convenções de escrita**
>
> Os parâmetros de uma função são separados por **`%,%`**. Para introduzir um sinal de percentagem literal, escreva **`\%`**.

## Guardar

Clique em **Validate** para adicionar ou atualizar o dado na etapa de pré-autenticação atual. **Cancel** fecha a janela sem guardar.
