Manuale · GPF Dashboard

Introduzione

GPF Dashboard è una dashboard iOS indipendente per consultare e gestire servizi Cloudflare tramite API ufficiali documentate da Cloudflare.

Nota importante: l'app non è ancora pubblicata. Al momento non è disponibile una data prevista per la pubblicazione.

L'app non è affiliata, sponsorizzata o approvata da Cloudflare, Inc. Cloudflare è un marchio registrato di Cloudflare, Inc.

Requisiti

iPhone con iOS 18.6 o successivo.
Account Cloudflare.
API Token Cloudflare con i permessi necessari ai moduli usati.
Connessione internet attiva.

Sicurezza delle credenziali

L'app usa esclusivamente API Token Cloudflare con autenticazione Bearer. Il token viene salvato nel Keychain iOS e non viene scritto in repository, file di configurazione, UserDefaults o log.

Authorization: Bearer <API_TOKEN>

Primo accesso

Creare un API Token da Cloudflare.
Aprire GPF Dashboard.
Inserire il token nella schermata di autenticazione.
Confermare.
L'app verifica il token con l'endpoint ufficiale Cloudflare.

GET /client/v4/user/tokens/verify

Dashboard

La dashboard mostra stato del token, numero di account, numero di zone, riepilogo stati e accessi rapidi ai moduli principali.

Account

Il modulo Account mostra gli account Cloudflare accessibili dal token, il dettaglio account, l'identificativo e le informazioni di base restituite dalle API.

GET /client/v4/accounts

Zone

Il modulo Zone permette di cercare e consultare zone, stato, nameserver, piano e dettagli principali. Da una zona si accede a DNS, Cache, Impostazioni zona e Analytics.

GET /client/v4/zones
GET /client/v4/zones/{zone_id}

DNS

Il modulo DNS permette selezione zona, elenco record, ricerca, filtro per tipo, dettaglio, creazione, modifica, duplicazione ed eliminazione con conferma esplicita.

Tipi record attualmente editabili:

A
AAAA
CNAME
TXT
MX
NS
PTR

Sono gestiti nome, contenuto, TTL, proxy Cloudflare per A/AAAA/CNAME, priorità MX, commenti e tag.

GET /client/v4/zones/{zone_id}/dns_records
POST /client/v4/zones/{zone_id}/dns_records
PUT /client/v4/zones/{zone_id}/dns_records/{dns_record_id}
DELETE /client/v4/zones/{zone_id}/dns_records/{dns_record_id}

Cache

Il modulo Cache supporta purge per URL, hostname, prefisso, cache tag e purge totale. Il purge totale richiede una conferma dedicata.

POST /client/v4/zones/{zone_id}/purge_cache

Impostazioni zona

Il modulo legge e modifica impostazioni zona solo quando Cloudflare restituisce editable: true.

Impostazioni attualmente supportate:

ssl
always_use_https
brotli
cache_level
security_level
development_mode

GET /client/v4/zones/{zone_id}/settings/{setting_id}
PATCH /client/v4/zones/{zone_id}/settings/{setting_id}

Analytics

Il modulo Analytics usa GraphQL ufficiale Cloudflare per mostrare traffico degli ultimi 7 giorni, visite, dati trasferiti, punti orari e visite per ora.

POST /client/v4/graphql

Zero Trust

Il modulo Zero Trust è attualmente read-only e mostra Access Applications per account selezionato: nome, tipo, dominio, AUD, ID, durata sessione, App Launcher, redirect IdP e date principali.

GET /client/v4/accounts/{account_id}/access/apps

Impostazioni app

La sezione Impostazioni mostra nome app, versione, build, disclaimer, logout e rimozione token dal Keychain.

Permessi API Token consigliati

Per sola consultazione: Zone Read, DNS Read, Zone Settings Read, permessi Analytics e Zero Trust read dove necessari.

Per modifiche: DNS Write, Cache Purge e Zone Settings Write.

Limiti attuali

L'app non gestisce Global API Key.
Alcuni tipi DNS strutturati sono read-only.
Zero Trust è attualmente in sola lettura.
Workers, Pages, R2, D1, KV, Queues, WAF, Rulesets, SSL/TLS avanzato, audit log e notifiche sono pianificati.

Manutenzione del manuale

Ogni nuova funzionalità deve aggiornare il registro API, il piano moduli e questo manuale con istruzioni utente, limiti e permessi necessari.

Tutto ciò che offre l'app.