Verifica app OAuth

Prima di lanciare un'applicazione che richiede le credenziali utente per l'API Data Manager a utenti esterni, il tuo progetto cloud Google deve essere sottoposto alla verifica dell'app Google OAuth.

Questa guida illustra le transizioni di configurazione del pubblico consigliate durante lo sviluppo e i passaggi per completare la verifica dell'app Google OAuth.

Fasi del pubblico dell'app

A seconda della fase di sviluppo, configura la pagina Pubblico nella console Google Cloud con impostazioni diverse per Tipo di utente e Stato di pubblicazione. Segui queste fasi per una transizione senza problemi dai test iniziali al lancio in produzione.

Fase 1: sviluppo iniziale (test)

Quando inizi lo sviluppo e il test delle richieste API di base:

  • Stato di pubblicazione: impostato su In fase di test.
  • Tipo di utente:

    Se il tuo progetto Google Cloud appartiene a un'organizzazione Google Workspace e solo gli utenti della tua organizzazione utilizzano l'app, seleziona Interno.

    In caso contrario, seleziona Esterno.

  • Utenti di test: se imposti Tipo di utente su Esterno, fai clic su Aggiungi utenti per aggiungere manualmente gli Account Google che utilizzi per generare le credenziali. Solo gli Account Google elencati possono autorizzare l'app e si applicano i limiti di test e le regole di scadenza dei token.

  • Verifica: non è richiesta durante i test. Se utilizzi Esterno, gli utenti di test visualizzano una schermata di avviso che conferma che hanno accesso di test a un'app non verificata prima di procedere alla schermata per il consenso.

Fase 2: lancio imminente (invio della verifica)

Quando l'integrazione è completa, l'interfaccia utente è stata creata e prevedi di lanciare il servizio entro il mese successivo:

  • Stato di pubblicazione: passa a In produzione.
  • Tipo di utente: imposta su Esterno se la tua app è destinata a clienti esterni alla tua organizzazione, ad esempio clienti inserzionisti.
  • Azione: invia l'app per la verifica. La procedura di verifica dell'app OAuth di Google può richiedere diverse settimane, quindi invia la richiesta il prima possibile una volta che la UI è pronta.
  • Gestione degli early tester: durante la revisione della verifica, la tua app rimane non verificata per gli utenti esterni. Se devi eseguire l'onboarding dei beta tester iniziali:
    • Informa l'utente che visualizzerà la schermata dell'app non verificata.
    • Chiedi loro di procedere facendo clic su Avanzate e poi su Vai a APP_NAME (non sicuro).

Requisiti per la verifica delle app

Per inviare la tua app per la verifica nel Centro di verifica, configura le impostazioni della piattaforma di autenticazione di Google e prepara i materiali di verifica richiesti.

Ambiti di verifica

Nella pagina Accesso ai dati, richiedi solo gli ambiti necessari per la tua applicazione. L'API Data Manager utilizza ambiti sensibili:

  • https://www.googleapis.com/auth/datamanager (ambito principale)
  • https://www.googleapis.com/auth/datamanager.partnerlink (per i link dei partner)
Dati di contatto

Il team di verifica di Google OAuth invia tutte le comunicazioni ai proprietari del progetto e agli editor del progetto configurati nel tuo progetto Google Cloud. Mantieni aggiornati questi dati di contatto nella console Google Cloud per non perdere le richieste di informazioni.

Dimostrazione video

Fornisci un link a un video dimostrativo accessibile pubblicamente (ad esempio un video di YouTube non in elenco o un link pubblico di Google Drive) che mostri in che modo la tua applicazione utilizza gli ambiti richiesti.

Assicurati che il video soddisfi i requisiti dei video dimostrativi delle funzionalità dell'app.

Fase 3: Pronto per il lancio (Verificato)

Una volta che il team di verifica di Google OAuth ti comunica di aver approvato la tua richiesta di verifica dell'app, non è necessaria alcuna azione. La tua app è ora verificata e gli utenti esterni possono autorizzarla senza visualizzare la schermata di avviso relativa alle app non verificate.