INTEGRITY Dokumentace

← Privacy Proxy / privacy-proxy / reference

HTTP hlavičky

Tato stránka popisuje HTTP hlavičky, které Privacy Proxy používá pro autentizaci, geolokaci a observabilitu. Podrobnosti o observabilitě najdete v GraphQL Analytics API a OpenTelemetry.

Hlavičky požadavku

Při připojování k Privacy Proxy klienti odesílají následující hlavičky.

Proxy-Authorization

Ověřuje klienta vůči proxy. Vyžadováno u všech požadavků.

Formát předsdíleného klíče:

Proxy-Authorization: Preshared <key>

Formát tokenu Privacy Pass:

Proxy-Authorization: PrivateToken token=<base64-encoded-token>
Parametr Popis
<key> Předsdílený klíč poskytnutý Cloudflare
<base64-encoded-token> Token Privacy Pass zakódovaný v base64

Hlavičky požadavků GraphQL Analytics API

Při dotazování na metriky Privacy Proxy prostřednictvím GraphQL Analytics API odešlete POST požadavek na https://api.cloudflare.com/client/v4/graphql. Podrobnosti o povinných hlavičkách a autentizaci najdete v GraphQL Analytics API.

sec-ch-geohash

Určuje geografickou polohu klienta pro výběr výstupní IP adresy. Volitelné, ale doporučené pro přesnou geolokaci.

sec-ch-geohash: <geohash>-<country_code>
Parametr Popis
<geohash> A geohash ↗ řetězec (obvykle 4 až 8 znaků)
<country_code> Kód země podle ISO 3166-1 alpha-2
Příklad
sec-ch-geohash: u4pruydqqvj-GB

Tento příklad určuje polohu ve Spojeném království.

Hlavičky odpovědi

Privacy Proxy zahrnuje do odpovědí následující hlavičky.

Server-Timing

Poskytuje informace o časování zpracování v proxy. Je součástí OpenTelemetry pipeline pro observabilitu.

Server-Timing: proxy;dur=<milliseconds>
Parametr Popis
<milliseconds> Doba zpracování v milisekundách vnesená proxy
Příklad
Server-Timing: proxy;dur=8.2

Hlavičky odpovědí GraphQL Analytics API

Informace o hlavičkách odpovědí vrácených GraphQL API najdete v GraphQL Analytics API.

CONNECT formát požadavku

Kompletní CONNECT požadavek na Privacy Proxy vypadá takto:

CONNECT example.com:443 HTTP/2
Host: example.com
Proxy-Authorization: Preshared abc123xyz
sec-ch-geohash: 9q8yy-US

Proxy odpoví stavovým kódem, který indikuje úspěch nebo selhání:

Stav Význam
200 OK Tunel úspěšně navázán
403 Forbidden Autentizace se nezdařila
502 Bad Gateway Nepodařilo se připojit k cíli
503 Service Unavailable Proxy dočasně nedostupná