<!-- review: finished -->

<a id="stream-rdp-preread"></a>

# RDP Preread

Ao usar o protocolo RDP, este módulo permite extrair cookies,
que são usados para identificação e gerenciamento de sessão,
antes de tomar uma decisão de balanceamento de carga.

Ao [compilar a partir do código-fonte](https://pt.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild),
o módulo deve ser habilitado com a
`‑‑with‑stream_rdp_preread_module`
[opção de compilação](https://pt.angie.software//angie/docs/installation/sourcebuild.md#configure).
Em pacotes e imagens dos [nossos repositórios](https://pt.angie.software//angie/docs/installation/index.md#install-packages),
o módulo está incluído na compilação.

<a id="configuration-example-66"></a>

## Exemplo de Configuração

<a id="binding-to-the-cookie-issuing-server"></a>

### Vinculação ao Servidor Emissor de Cookie

Esta configuração usa o modo `learn` da diretiva [sticky](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-sticky):

```nginx
stream {

    rdp_preread on;

    upstream rdp {

        server 127.0.0.1:3390 sid=a;
        server 127.0.0.1:3391 sid=b;

        sticky learn lookup=$rdp_cookie create=$rdp_cookie zone=sessions:1m;
    }
}
```

<a id="directives-75"></a>

## Diretivas

<a id="index-0"></a>

<a id="s-rdp-preread"></a>

### rdp_preread

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `rdp_preread` `on` | `off`;   |
|-------------------------------------------------------------------------------------------|-------------------------------|
| Padrão                                                                                    | `rdp_preread off;`            |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | stream, server                |

Controla a extração de informações dos cookies do protocolo RDP
durante o
[estágio de pré-leitura](https://pt.angie.software//angie/docs/configuration/processing.md#stream-sessions).
Se a configuração for `on`,
as variáveis listadas abaixo serão preenchidas
no contexto onde for especificada.

<a id="built-in-variables-21"></a>

## Variáveis Integradas

A semântica dos valores de cookie depende da versão do protocolo RDP.

<a id="v-rdp-cookie"></a>

### `$rdp_cookie`

O valor completo do cookie.

<a id="id2"></a>

### `$rdp_cookie_<name>`

O valor do campo do cookie com o nome especificado.
