plugins {
  kotlin("jvm")
  id("okhttp.publish-conventions")
  id("okhttp.jvm-conventions")
  id("okhttp.quality-conventions")
  id("okhttp.testing-conventions")
}

project.applyOsgi(
  "Fragment-Host: com.squareup.okhttp3; bundle-version=\"\${range;[==,+);\${version_cleanup;${projects.okhttp.version}}}\"",
  "Bundle-SymbolicName: com.squareup.okhttp3.urlconnection",
  "-removeheaders: Private-Package",
)

  <configuration default="false" name="Debug Elasticsearch" type="Remote">
    <option name="USE_SOCKET_TRANSPORT" value="true" />
    <option name="SERVER_MODE" value="true" />
    <option name="SHMEM_ADDRESS" />
    <option name="HOST" value="localhost" />
    <option name="PORT" value="5005" />
    <option name="AUTO_RESTART" value="true" />
    <RunnerSettings RunnerId="Debug">
      <option name="DEBUG_PORT" value="5005" />

{* ../../docs_src/advanced_middleware/tutorial001_py310.py hl[2,6] *}

## `TrustedHostMiddleware` { #trustedhostmiddleware }

Примушує, щоб усі вхідні запити мали коректно встановлений заголовок `Host`, щоб захиститися від атак HTTP Host Header.

{* ../../docs_src/advanced_middleware/tutorial002_py310.py hl[2,6:8] *}

Підтримуються такі аргументи:

class CustomTrust {
  // PEM files for root certificates of Comodo and Entrust. These two CAs are sufficient to view
  // https://publicobject.com (Comodo) and https://squareup.com (Entrust). But they aren't
  // sufficient to connect to most HTTPS sites including https://godaddy.com and https://visa.com.
  // Typically developers will need to get a PEM file from their organization's TLS administrator.
  val comodoRsaCertificationAuthority =
    """

    /**
     * Gets DFS referrals for the specified path.
     *
     * @param ctx the CIFS context
     * @param name the DFS path to resolve
     * @param targetHost the target host name
     * @param targetDomain the target domain
     * @param rn the referral number
     * @return dfs referral
     * @throws SmbException if an SMB error occurs
     * @throws CIFSException if a CIFS error occurs

* [X-Forwarded-Proto](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-Proto)
* [X-Forwarded-Host](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-Host)

///

### Proxy-Forwarded-Header aktivieren { #enable-proxy-forwarded-headers }

    /**
     * Test for getRemoteHostName() method.
     * Verifies that the method returns the correct remote host name.
     */
    @Test
    void testGetRemoteHostName() {
        when(smbTreeHandle.getRemoteHostName()).thenReturn("test-server");
        assertEquals("test-server", smbTreeHandle.getRemoteHostName(), "Remote host name should be test-server");
    }

    /**
     * Test for getTreeType() method.

        }
        final int domainLength = domain.length;
        byte[] server = {};
        try {
            final String host = NbtAddress.getLocalHost().getHostName();
            if (host != null) {
                try {
                    server = host.getBytes(UNI_ENCODING);
                } catch (final IOException ex) {}
            }
        } catch (final UnknownHostException ex) {}

* [X-Forwarded-Proto](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-Proto)
* [X-Forwarded-Host](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-Host)

///

### Habilitar headers reenviados por el Proxy { #enable-proxy-forwarded-headers }

The next sections are **not necessarily "advanced"**.

And it's possible that for your use case, the solution is in one of them.

///

## Read the Tutorial first { #read-the-tutorial-first }

You could still use most of the features in **FastAPI** with the knowledge from the main [Tutorial - User Guide](../tutorial/index.md).