← Cloudflare Privacy Gateway / privacy-gateway

Начало работы

Реализация Privacy Gateway состоит из трех основных частей:

1. Конфигурация сервера шлюза приложения или бэкенда (управляется вами).
2. Конфигурация клиента (управляется вами).
3. Подключение к серверу ретрансляции Privacy Gateway (управляется Cloudflare).

Privacy Gateway в настоящее время находится в закрытом бета-тестировании. Если вы заинтересованы, свяжитесь с нами ↗.

Как клиент Privacy Gateway, вы также должны добавить серверную поддержку OHTTP, реализовав сервер шлюза приложения. Шлюз приложения отвечает за расшифровку входящих запросов, пересылку внутренних запросов по назначению и шифрование соответствующего ответа обратно клиенту.

реализация сервера будет обрабатывать входящие запросы и формировать ответы, а также предоставлять клиентам доступ к своей конфигурации открытого ключа. Конфигурация открытого ключа создается безопасным способом и становится доступной через API. См. README ↗ для получения сведений о настройке.

Приложения также могут реализовать эту функциональность самостоятельно. Сведения об этом доступны настройка открытого ключа ↗, HTTP-сообщение шифрование и дешифрование ↗, а также детали, специфичные для сервера ↗ можно найти в спецификации OHTTP.

Используйте следующие ресурсы, чтобы получить помощь по настройке сервера:

• Go:
  • Пример сервера шлюза ↗
  • Библиотека шлюза ↗
• Rust: Библиотека шлюза ↗
• JavaScript / TypeScript: Библиотека шлюза ↗

Как клиент Privacy Gateway, вы должны настроить поддержку шлюза на стороне клиента. Клиенты отвечают за шифрование запросов, их отправку в Cloudflare Privacy Gateway и последующую расшифровку соответствующих ответов.

Кроме того, разработчикам приложений необходимо настройка клиента для получения или иного способа обнаружения конфигурации открытого ключа шлюза. Это зависит от того, как шлюз предоставляет доступ к своей конфигурации открытого ключа. Если вам нужна помощь с настройкой, свяжитесь с нами ↗.

Используйте следующие ресурсы, чтобы получить помощь по настройке клиента:

• Objective C: Пример приложения ↗
• Rust: Клиентская библиотека ↗
• JavaScript / TypeScript: Клиентская библиотека ↗

После настройки клиента и сервера проверьте приложение и убедитесь, что вы отправляете в Cloudflare и бэкенд приложения только предназначенные для этого данные. В частности, данные приложения не должны содержать ничего уникального для конкретного пользователя, поскольку это сведет на нет преимущества OHTTP.

• Приложениям следует удалять идентифицирующие данные пользователя из запросов, передаваемых через Privacy Gateway. Это касается, например, имен, адресов электронной почты, номеров телефонов и так далее.
• Приложениям следует рекомендовать пользователям отключать отправку отчетов о сбоях при использовании Privacy Gateway. Отчеты о сбоях могут содержать конфиденциальную информацию и данные пользователя, включая адреса электронной почты.
• По возможности данные приложения следует шифровать на устройстве клиента ключом, известным только клиенту. Например, iOS обычно хорошо поддерживает шифрование на стороне клиента (и синхронизация ключей через KeyChain) ↗. В Android, вероятно, доступны аналогичные функции.

Прежде чем отправлять какие-либо запросы, сначала настройте учетную запись Cloudflare. Для этого требуется обратившись к нам ↗ и указав URL-адрес сервера шлюза приложения.

Затем убедитесь, что вы перенаправляете запросы на согласованный URL-адрес, соответствующий приведённым ниже правилам.

https://privacy-relay.cloudflare.com/<GATEWAY_SERVER_NAME>