> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fuente de diccionario HTTP(S)

> Configure un endpoint HTTP o HTTPS como fuente de diccionario en ClickHouse.

El uso de un servidor HTTP(S) depende de [cómo se almacena el diccionario en memoria](/es/reference/statements/create/dictionary/layouts/overview). Si el diccionario se almacena con `cache` y `complex_key_cache`, ClickHouse solicita las claves necesarias enviando una solicitud mediante el método `POST`.

Ejemplo de configuración:

<Tabs>
  <Tab title="DDL">
    ```sql theme={null}
    SOURCE(HTTP(
        url 'http://[::1]/os.tsv'
        format 'TabSeparated'
        credentials(user 'user' password 'password')
        headers(header(name 'API-KEY' value 'key'))
    ))
    ```
  </Tab>

  <Tab title="Archivo de configuración">
    ```xml theme={null}
    <source>
        <http>
            <url>http://[::1]/os.tsv</url>
            <format>TabSeparated</format>
            <credentials>
                <user>user</user>
                <password>password</password>
            </credentials>
            <headers>
                <header>
                    <name>API-KEY</name>
                    <value>key</value>
                </header>
            </headers>
        </http>
    </source>
    ```
  </Tab>
</Tabs>

<br />

Para que ClickHouse pueda acceder a un recurso HTTPS, debe [configurar OpenSSL](/es/reference/settings/server-settings/settings#openssl) en la configuración del servidor.

Campos de configuración:

| Configuración | Descripción                                                                                                |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| `url`         | La URL de la fuente.                                                                                       |
| `format`      | El formato del archivo. Se admiten todos los formatos descritos en [Formats](/es/reference/formats/index). |
| `credentials` | Autenticación HTTP Basic. Opcional.                                                                        |
| `user`        | Nombre de usuario necesario para la autenticación.                                                         |
| `password`    | Contraseña necesaria para la autenticación.                                                                |
| `headers`     | Todas las entradas de encabezados HTTP personalizados que se usan en la solicitud HTTP. Opcional.          |
| `header`      | Una única entrada de encabezado HTTP.                                                                      |
| `name`        | Nombre identificador usado para el encabezado enviado en la solicitud.                                     |
| `value`       | Valor establecido para un nombre identificador específico.                                                 |

Al crear un diccionario mediante el comando DDL (`CREATE DICTIONARY ...`), los hosts remotos de los diccionarios HTTP se validan con el contenido de la sección `remote_url_allow_hosts` de la configuración para evitar que los usuarios de la base de datos accedan a servidores HTTP arbitrarios.