<!-- review: finished -->

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

# RDP Preread

Cuando se utiliza el protocolo RDP, este módulo permite extraer cookies,
que se utilizan para la identificación y gestión de sesiones,
antes de tomar una decisión de balanceo de carga.

Al [compilar desde el código fuente](https://es.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild),
el módulo debe habilitarse con la
`‑‑with‑stream_rdp_preread_module`
[opción de compilación](https://es.angie.software//angie/docs/installation/sourcebuild.md#configure).
En paquetes e imágenes de [nuestros repositorios](https://es.angie.software//angie/docs/installation/index.md#install-packages),
el módulo está incluido en la compilación.

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

## Ejemplo de configuración

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

### Vinculación al Servidor Emisor de Cookies

Esta configuración utiliza el modo `learn` de la directiva [sticky](https://es.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>

## Directivas

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

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

### rdp_preread

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `rdp_preread` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|-------------------------------|
| Predeterminado                                                                             | `rdp_preread off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                |

Controla la extracción de información de las cookies del protocolo RDP
durante la
[fase de prelectura](https://es.angie.software//angie/docs/configuration/processing.md#stream-sessions).
Si la configuración es `on`,
las variables listadas a continuación se completarán
en el contexto donde se especifica.

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

## Variables integradas

La semántica de los valores de las cookies depende de la versión del protocolo RDP.

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

### `$rdp_cookie`

El valor completo de la cookie.

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

### `$rdp_cookie_<name>`

El valor del campo de la cookie con el nombre especificado.
