Backup su Google Drive
Passo dopo passo: crea un progetto Google Cloud, abilita la Drive API, pubblica la schermata di consenso OAuth e ottieni il Client ID, il Client Secret e il Refresh Token da incollare nei Backup di CreateYourVPN.
Per eseguire il backup sul tuo Google Drive, CreateYourVPN ha bisogno di tre valori da Google: un Client ID, un Client Secret e un Refresh Token. Li ottieni una volta sola, li incolli nelle impostazioni dei Backup e non dovrai più toccare Google.
La formulazione esatta nella Google Cloud Console cambia di tanto in tanto, quindi considera i percorsi di clic qui sotto come una mappa, non come istruzioni al pixel: i nomi delle sezioni restano comunque vicini a questi.
Il passaggio più importante in assoluto è pubblicare la schermata di consenso "In produzione" (Passo 3). Se la lasci in modalità Testing, Google fa scadere il tuo refresh token dopo 7 giorni e i backup si interrompono silenziosamente senza alcun errore evidente. Non saltarlo.
Passo 1. Crea un progetto
Apri la Google Cloud Console e accedi con l'account Google il cui Drive vuoi usare per archiviare i backup.
Nella barra in alto, apri il selettore di progetti e clicca su "New Project". Assegnagli un nome qualsiasi (es. CYV Backups) e crealo. Assicurati che questo nuovo progetto sia selezionato prima di proseguire.
Passo 2. Abilita la Google Drive API
Vai su APIs & Services → Library.
Cerca "Google Drive API", aprila e clicca su "Enable".
Passo 3. Configura e pubblica la schermata di consenso
Vai su APIs & Services → OAuth consent screen.
Scegli il tipo di utente "External" e compila i dati essenziali richiesti: un nome dell'app (es. CYV Backups), la tua email di supporto e un'email di contatto per gli sviluppatori. Puoi lasciare vuoti i campi facoltativi.
Prosegui salvando lungo tutta la procedura guidata. Quando torni alla panoramica della schermata di consenso OAuth, individua "Publishing status" e clicca su "Publish app" affinché lo stato diventi "In production".
Lo stato di pubblicazione deve indicare "In production", non "Testing". In modalità Testing Google considera il refresh token di breve durata e lo revoca dopo 7 giorni: i tuoi backup funzionerebbero perfettamente per una settimana per poi fallire in silenzio. È la pubblicazione in produzione a rendere il token duraturo. Google potrebbe mostrare un'inquietante nota "unverified app"; qui va benissimo — questa app viene usata solo da te, per il tuo Drive, e richiede unicamente lo scope ristretto indicato più avanti.
Passo 4. Crea un OAuth Client ID (Desktop app)
Vai su APIs & Services → Credentials → Create credentials → OAuth client ID.
Come Application type, scegli "Desktop app", assegnagli un nome e crealo.
Google ti mostra un Client ID e un Client Secret. Copia entrambi: sono due dei tre valori che incollerai in CreateYourVPN.
Passo 5. Ottieni un Refresh Token
Il refresh token è ciò che permette a CreateYourVPN di scrivere su Drive in modo pianificato senza che tu debba accedere ogni volta. Il modo più rapido per ottenerne uno è il Google OAuth Playground.
Apri l'OAuth 2.0 Playground.
Clicca sull'icona a forma di ingranaggio (impostazioni, in alto a destra), spunta "Use your own OAuth credentials" e incolla il Client ID e il Client Secret del Passo 4.
Nel pannello "Step 1" a sinistra, non scegliere dall'elenco: scorri fino al riquadro input your own scopes e inserisci esattamente:
https://www.googleapis.com/auth/drive.filePoi clicca su "Authorize APIs" e accedi con lo stesso account Google. Approva l'accesso.
In "Step 2", clicca su "Exchange authorization code for tokens". La risposta include un refresh_token: copiane il valore.
Lo scope drive.file è volutamente ristretto: consente all'app di vedere e gestire solo i file che crea essa stessa, mai il resto del tuo Drive. È tutto ciò che serve a un backup. Se preferisci gestire un tuo flusso di consenso invece del Playground, va bene lo stesso — basta richiedere lo stesso scope drive.file con access_type=offline così che Google restituisca un refresh token.
Passo 6. Incollalo in CreateYourVPN
Nella dashboard, apri Menu account → Backup, scegli Google Drive come destinazione e incolla:
- Client ID (Passo 4)
- Client Secret (Passo 4)
- Refresh Token (Passo 5)
Poi scegli la tua passphrase, la frequenza e la conservazione, e salva.
Non è necessario inserire l'ID di una cartella. Alla prima esecuzione l'app crea da sola la cartella "CYV Backups" nel tuo Drive e vi conserva ogni backup — nient'altro nel tuo Drive viene toccato.
Cosa fare dopo
Backup
Esegui il backup dell'elenco degli utenti di ogni cluster — i loro account, i limiti di traffico, la scadenza e gli UUID dei proxy — su uno spazio di archiviazione tuo (Google Drive o S3), sempre crittografato a riposo.
Backup su archiviazione compatibile con S3
Come ottenere access key, secret key, bucket, endpoint e region per un'archiviazione compatibile con S3 — AWS S3, Cloudflare R2, Backblaze B2 o Wasabi — e incollarli nei Backup di CreateYourVPN.