HTTP ヘッダー

このページでは、Privacy Proxy が認証、位置情報、可観測性に使う HTTP ヘッダーを説明します。可観測性の詳細は GraphQL Analytics API と OpenTelemetry を参照してください。

クライアントは Privacy Proxy へ接続するとき、次のヘッダーを付けます。

クライアントをプロキシへ認証します。すべてのリクエストで必須です。

事前共有キーの形式:

Proxy-Authorization: Preshared <key>

Privacy Pass トークンの形式:

Proxy-Authorization: PrivateToken token=<base64-encoded-token>

GraphQL Analytics API で Privacy Proxy のメトリクスを問い合わせるときは、https://api.cloudflare.com/client/v4/graphql へ POST します。必要なヘッダーと認証の詳細は GraphQL Analytics API を参照してください。

エグレス IP の選択に使う、クライアントの地理的位置を指定します。任意ですが、正確な位置情報のために推奨します。

sec-ch-geohash: <geohash>-<country_code>

sec-ch-geohash: u4pruydqqvj-GB

この例は、イギリス国内の位置を指定しています。

Privacy Proxy は、レスポンスに次のヘッダーを付けます。

プロキシ処理のタイミング情報です。OpenTelemetry の可観測性パイプラインの一部です。

Server-Timing: proxy;dur=<milliseconds>

Server-Timing: proxy;dur=8.2

GraphQL API が返すレスポンスヘッダーは GraphQL Analytics API を参照してください。

Privacy Proxy への完全な CONNECT リクエストは、次のようになります。

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

プロキシは、成功または失敗を示すステータスコードを返します。