Questa guida mostra come assicurarti che l'applicazione e le credenziali 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 i documenti sulla configurazione della schermata per il consenso OAuth.
Proteggi le credenziali dell'applicazione
Devi proteggere l'ID client e il client secret OAuth 2.0 della tua applicazione. Queste credenziali aiutano i tuoi utenti e Google a identificare la tua applicazione, pertanto devono essere gestite con attenzione. Queste credenziali dell'applicazione devono essere trattate come password. Non condividerle utilizzando meccanismi non sicuri, come la pubblicazione su forum pubblici, l'invio di file di configurazione contenenti queste credenziali in allegati email, l'hardcoding delle credenziali o il commit in un repository di codice. Se possibile, ti consigliamo di utilizzare un gestore di secret come Google Cloud Secret Manager o AWS Secrets Manager.
Se i client secret OAuth 2.0 sono compromessi, puoi reimpostarli.
Proteggi i service account
Se utilizzi i service account, proteggili nel seguente modo:
Tratta la chiave dell'account di servizio e il file JSON come password. Proteggile utilizzando un gestore di secret come Google Cloud Secret Manager o AWS Secrets Manager, se possibile.
Segui le best practice aggiuntive di Google Cloud per proteggere e gestire i tuoi service account.
Proteggi i token utente
Se la tua app autorizza più utenti, devi adottare ulteriori misure per proteggere i token di aggiornamento e di accesso degli utenti. Archivia i token in modo sicuro at rest e non trasmetterli mai in testo normale. Utilizza un sistema di archiviazione sicuro appropriato per la tua piattaforma.
Gestisci la revoca e la scadenza del token di aggiornamento
Se la tua app richiede un token di aggiornamento OAuth 2.0 nell'ambito dell'autorizzazione, devi anche gestire l'annullamento della convalida o la scadenza. I token di aggiornamento potrebbero essere annullati per vari motivi e la tua applicazione dovrebbe rispondere correttamente autorizzando nuovamente l'utente durante la sessione di accesso successiva o pulendo i suoi dati, a seconda dei casi. I job offline, come i cron job, 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 livelli elevati 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 richiesti. La tua app deve gestire il rifiuto degli ambiti disattivando le funzionalità pertinenti. Puoi chiedere di nuovo 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.