Questa guida mostra come assicurarti che le credenziali dell'applicazione e dell'utente siano sicure.
Completa la verifica dell'app OAuth
L'ambito OAuth 2.0 per l'API Google Ads è classificato come ambito con limitazioni, il che significa che devi completare la procedura di verifica dell'app OAuth prima di mettere in produzione l'applicazione. Per saperne di più, consulta la documentazione di Google Identity, l'articolo del Centro assistenza sulle app non verificate e la documentazione sulla configurazione della schermata per il consenso OAuth.
Proteggi le credenziali dell'applicazione
Devi proteggere l'ID client OAuth 2.0 e il client secret della tua applicazione. Queste credenziali aiutano gli utenti e Google a identificare la tua applicazione, pertanto devono essere gestite con attenzione. Devi trattare queste credenziali dell'applicazione come password. Non condividerle utilizzando meccanismi non sicuri, ad esempio pubblicandole su forum pubblici, inviando file di configurazione contenenti queste credenziali negli allegati email, codificando le credenziali o eseguendo il commit in un repository di codice. Ti consigliamo di utilizzare un gestore di secret come Google Cloud Secret Manager o AWS Secret Manager, quando possibile.
Se i secret client OAuth 2.0 sono compromessi, puoi reimpostarli.
Proteggi gli account di servizio
Se utilizzi account di servizio, proteggili nel seguente modo:
Tratta la chiave dell'account di servizio e il file JSON come password. Proteggili utilizzando un gestore di secret come Google Cloud Secret Manager o AWS Secret Manager, se possibile.
Segui le best practice aggiuntive da Google Cloud per proteggere e gestire i tuoi account di servizio.
Proteggi i token utente
Se la tua app autorizza più utenti, devi adottare ulteriori misure per proteggere i token di accesso e di aggiornamento degli utenti. Archivia i token in modo sicuro a riposo e non trasmetterli mai in testo normale. Utilizza un sistema di archiviazione sicuro appropriato per la tua piattaforma.
Gestisci la revoca e la scadenza dei token di aggiornamento
Se la tua app richiede il token di aggiornamento OAuth 2.0 come parte dell'autorizzazione, devi anche gestirne l'invalidazione o la scadenza. I token di aggiornamento potrebbero essere invalidati per vari motivi e la tua applicazione dovrebbe rispondere in modo appropriato riautorizzando l'utente durante la sessione di accesso successiva o ripulendo i suoi dati, a seconda dei casi. I job offline, come i job cron, devono rilevare e registrare gli account i cui token di aggiornamento sono scaduti, anziché continuare a effettuare richieste non riuscite. Google potrebbe limitare le applicazioni che generano un numero elevato di errori per un periodo di tempo prolungato per mantenere la stabilità dei server API.
Gestisci il consenso per più ambiti
Se la tua app richiede l'autorizzazione per più ambiti OAuth 2.0, l'utente potrebbe non concedere tutti gli ambiti OAuth che hai richiesto. La tua app deve gestire il rifiuto degli ambiti disattivando le funzionalità pertinenti. Puoi richiedere nuovamente all'utente solo dopo che ha indicato chiaramente l'intenzione di utilizzare la funzionalità specifica che richiede l'ambito. In questi casi, utilizza l'autorizzazione incrementale per richiedere gli ambiti OAuth appropriati.
Se le funzionalità di base della tua app richiedono più ambiti, spiega questo requisito all'utente prima di richiedere il consenso.