← Cloudflare Privacy Gateway / privacy-gateway

Začínáme

Implementace Privacy Gateway se skládá ze tří hlavních částí:

1. Konfigurace serveru brány aplikace / backendu (provozovaná vámi).
2. Konfigurace klienta (provozovaná vámi).
3. Připojení k serveru Privacy Gateway Relay Server (provozovanému Cloudflare).

Privacy Gateway je v současné době v uzavřené beta verzi. Pokud máte zájem, kontaktujte nás ↗.

Jako zákazník Privacy Gateway musíte také přidat podporu OHTTP na straně serveru, a to implementací serveru brány aplikace. Brána aplikace zajišťuje dešifrování příchozích požadavků, přeposílání vnitřních požadavků na jejich cíl a šifrování odpovídající odpovědi zpět klientovi.

implementace serveru bude zpracovávat příchozí požadavky a vytvářet odpovědi a zároveň bude klientům zpřístupňovat svou konfiguraci veřejného klíče. Konfigurace veřejného klíče se generuje bezpečně a zpřístupňuje se prostřednictvím API. Podrobnosti najdete v README ↗ kde najdete podrobnosti o konfiguraci.

Aplikace mohou tuto funkci implementovat i samy. Podrobnosti o konfigurace veřejného klíče ↗, zpráva HTTP šifrování a dešifrování ↗, a podrobnosti specifické pro server ↗ najdete ve specifikaci OHTTP.

Při konfiguraci serveru vám pomohou tyto zdroje:

• Go:
  • Ukázkový server brány ↗
  • Knihovna brány ↗
• Rust: Knihovna brány ↗
• JavaScript / TypeScript: Knihovna brány ↗

Jako zákazník Privacy Gateway musíte nastavit podporu brány na straně klienta. Klienti zajišťují šifrování požadavků, jejich odesílání do Cloudflare Privacy Gateway a následné dešifrování odpovídajících odpovědí.

Vývojáři aplikací navíc musí konfigurace klienta k načtení nebo jinému zjištění konfigurace veřejného klíče brány. Způsob provedení závisí na tom, jak brána svou konfiguraci veřejného klíče zpřístupňuje. Pokud s touto konfigurací potřebujete pomoci, kontaktujte nás ↗.

Při konfiguraci klienta vám pomohou tyto zdroje:

• Objective C: Ukázková aplikace ↗
• Rust: Klientská knihovna ↗
• JavaScript / TypeScript: Klientská knihovna ↗

Po nakonfigurování klienta a serveru zkontrolujte svou aplikaci a ujistěte se, že Cloudflare a backendu aplikace odesíláte jen zamýšlená data. Data aplikace by zejména neměla obsahovat nic, co je jedinečné pro konkrétního koncového uživatele, protože by to popřelo výhody, které OHTTP přináší.

• Aplikace by měly z požadavků přeposílaných přes Privacy Gateway odstraňovat identifikační údaje uživatelů, například jména, e-mailové adresy, telefonní čísla a podobně.
• Aplikace by měly uživatele vybízet, aby při používání Privacy Gateway vypnuli hlášení pádů. Hlášení pádů mohou obsahovat citlivé informace a data o uživateli, včetně e-mailových adres.
• Data aplikace by měla být pokud možno šifrována na klientském zařízení klíčem, který zná pouze klient. Systém iOS například obvykle dobře podporuje šifrování na straně klienta (a synchronizace klíčů přes KeyChain) ↗. Android má pravděpodobně k dispozici podobné funkce.

Než začnete odesílat požadavky, musíte nejprve nastavit svůj účet Cloudflare. To vyžaduje kontaktování nás ↗ a poskytnutím URL adresy serveru brány vaší aplikace.

Dále se ujistěte, že požadavky přeposíláte na vzájemně dohodnutou adresu URL podle následujících konvencí.

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