Alcune API di Google (quelle che accettano ambiti sensibili o con restrizioni ) prevedono requisiti per le app che richiedono l'autorizzazione ad accedere ai dati dei consumatori. Questi requisiti aggiuntivi per gli ambiti con restrizioni richiedono che un'app dimostri di essere un tipo di applicazione consentito e venga inviata a ulteriori revisioni, che includono una possibile valutazione della sicurezza.
L'applicabilità degli ambiti con restrizioni all'interno di un'API dipende principalmente dal grado di accesso necessario per fornire una funzionalità pertinente nella tua app: di sola lettura, sola scrittura, lettura e scrittura e così via.
Quando utilizzi OAuth 2.0 per ottenere l'autorizzazione da un Account Google ad accedere a questi dati, utilizzi stringhe chiamate ambiti per specificare il tipo di dati a cui vuoi accedere e il livello di accesso di cui hai bisogno. Se la tua app richiede ambiti sensibili o con restrizioni, devi completare la procedura di verifica, a meno che l'utilizzo dell'app non sia idoneo per un' eccezione.
Gli ambiti con restrizioni sono meno numerosi rispetto agli ambiti sensibili. Le Domande frequenti sulla verifica dell'API OAuth di Verification contengono l'elenco attuale degli ambiti sensibili e con restrizioni. Questi ambiti forniscono accesso completo ai dati utente di Google e richiedono di essere sottoposti a una procedura di verifica dell'ambito prima di richiedere gli ambiti a un qualsiasi Account Google. Per informazioni su questo requisito, consulta le Norme relative ai dati utente dei servizi API di Google e Requisiti aggiuntivi per ambiti API specifici o la pagina Google Developers specifica per il prodotto. Se archivi o trasmetti dati con ambito con restrizioni sui server, devi completare una valutazione della sicurezza.
Informazioni sugli ambiti con restrizioni
Se la tua app richiede ambiti con restrizioni e non è idonea per un'eccezione, devi soddisfare i Requisiti aggiuntivi per ambiti API specifici delle Norme sui dati utente dei servizi API di Google oppure requisiti specifici dei prodotti nella pagina Google Developers del prodotto, che richiedono una procedura di revisione più approfondita.
Informazioni sull'utilizzo dell'ambito
- Esamina gli ambiti che l'app utilizza o che vuoi utilizzare. Per trovare l'utilizzo esistente degli ambiti, esamina il codice sorgente dell'app per individuare eventuali ambiti inviati con richieste di autorizzazione.
- Stabilisci che ogni ambito richiesto è necessario per le azioni previste della funzionalità dell'app e utilizza il privilegio minimo necessario per fornire la funzionalità. In genere, un'API di Google dispone di documentazione di riferimento sulla pagina Google Developers del prodotto per i suoi endpoint, che include l'ambito necessario per chiamare l'endpoint o le proprietà specifiche al suo interno. Per saperne di più sugli ambiti di accesso necessari per gli endpoint API chiamati dalla tua app, leggi la documentazione di riferimento di questi endpoint. For example, for an app that only uses Gmail APIs to occasionally send emails on a user's behalf, don't request the scope that provides full access to the user's email data.
- I dati che ricevi da un'API di Google devono essere utilizzati solo in conformità con le norme dell'API e nel modo in cui rappresenti agli utenti nelle azioni dell'app e nelle norme sulla privacy.
- Fai riferimento alla documentazione dell'API per saperne di più su ogni ambito, incluso il suo potenziale sensitive or restricted stato.
- Dichiara tutti gli ambiti utilizzati dalla tua app nella pagina degli ambiti di configurazione della schermata di consenso OAuth di API Console. Gli ambiti specificati sono raggruppati in categorie sensibili o limitate per evidenziare eventuali verifiche aggiuntive richieste.
- Trova l'ambito migliore che corrisponda ai dati utilizzati dall'integrazione, comprendi l'utilizzo, riconferma che tutto funziona ancora in un ambiente di test, quindi preparati per l'invio per la verifica.
Assicurati di tenere conto del tempo necessario per completare la verifica nel piano di lancio della tua app o di eventuali nuove funzionalità che richiedono un nuovo ambito. Uno di questi requisiti aggiuntivi si verifica se l'app accede ai dati utente di Google da o tramite un server o è in grado di accedervi. In questi casi, il sistema deve essere sottoposto a una valutazione della sicurezza annuale da parte di un valutatore indipendente di terze parti, approvato da Google. Per questo motivo, il processo di verifica degli ambiti con restrizioni può richiedere diverse settimane. Tieni presente che per tutte le app è necessario completare prima il passaggio di verifica del brand, che in genere richiede 2-3 giorni lavorativi se le informazioni di branding sono cambiate dall'ultima verifica della schermata per il consenso OAuth approvata.
Tipi di applicazione consentiti
Determinati tipi di applicazioni possono accedere ad ambiti con restrizioni per ciascun prodotto. Puoi trovare i tipi di applicazione nella pagina sviluppatore Google specifica del prodotto (ad esempio le norme relative all'API Gmail).
È tua responsabilità comprendere e determinare il tipo di app. Tuttavia, se hai dubbi sul tipo di applicazione della tua app, non puoi selezionare alcuna opzione per la domanda Quali funzionalità utilizzerai? quando invii l'app per la verifica. Il tipo di applicazione verrà determinato dal team di verifica dell'API di Google.
Valutazione della sicurezza
Ogni app che richiede l'accesso ai dati riservati degli utenti Google e può accedere ai dati da o tramite un server di terze parti deve essere sottoposta a una valutazione di sicurezza da parte di valutatori della sicurezza incaricati da Google. Questa valutazione contribuisce a proteggere i dati degli utenti Google verificando che tutte le app che accedono ai dati utente di Google dimostrano la capacità di gestire i dati in modo sicuro e di eliminarli su richiesta dell'utente.
Per standardizzare la nostra valutazione della sicurezza, utilizziamo App Defense Alliance e il framework di valutazione della sicurezza delle applicazioni cloud (CASA).
Come accennato in precedenza, per mantenere l'accesso a tutti gli ambiti con restrizioni verificati, le app devono essere verificate di nuovo per verificarne la conformità e completare una valutazione di sicurezza almeno ogni 12 mesi dopo la data di approvazione della lettera di valutazione (LDA). Se la tua app aggiunge un nuovo ambito con restrizioni, potrebbe essere necessario rivalutare l'app per coprire l'ambito aggiuntivo se non è stata inclusa in una valutazione della sicurezza precedente.
Il team di revisione di Google ti invia un'email quando è il momento di ricertificare la tua app. Per assicurarti che i membri corretti del tuo team vengano informati di questa applicazione annuale, associa Account Google aggiuntivi al tuo progetto API Console come proprietario o editor. Inoltre, consente di tenere aggiornate le email di contatto dell'assistenza utente e degli sviluppatori specificate nel protocollo API Console OAuth di Consent Screen pagedi Google.
Passaggi per prepararsi alla verifica
Tutte le app che utilizzano le API di Google per richiedere l'accesso ai dati devono eseguire i seguenti passaggi per completare la verifica del brand:
- Verifica che la tua app non rientri in nessuno dei casi d'uso nella sezione Eccezioni ai requisiti di verifica.
- Assicurati che la tua app rispetti i requisiti di branding delle API o dei prodotti associati. Ad esempio, consulta le linee guida per il branding per gli ambiti Accedi con Google.
- Verifica la proprietà dei domini autorizzati del tuo progetto in Google Search Console. Utilizza un Account Google associato al tuo API Console progetto come proprietario o editor.
- Assicurati che tutte le informazioni di branding nella schermata per il consenso OAuth, ad esempio nome dell'app, email di assistenza, URI della home page, URI delle norme sulla privacy e così via, rispecchino accuratamente l'identità dell'app.
Requisiti della home page dell'applicazione
Assicurati che la tua home page soddisfi i seguenti requisiti:
- La tua home page deve essere pubblicamente accessibile e non solo accessibile agli utenti che hanno eseguito l'accesso al tuo sito.
- La pertinenza della tua home page rispetto all'app in corso di revisione deve essere chiara.
- I link alla scheda dell'app sul Google Play Store o sulla relativa pagina Facebook non sono considerati pagine home dell'app valide.
Requisiti per i link alle norme sulla privacy dell'applicazione
Assicurati che le norme sulla privacy della tua app soddisfino i seguenti requisiti:
- Le norme sulla privacy devono essere visibili agli utenti, ospitate nello stesso dominio della home page dell'applicazione e accessibili tramite link nella schermata per il consenso OAuth di Google API Console. Tieni presente che la home page deve includere una descrizione della funzionalità dell'app, nonché link alle norme sulla privacy e ai termini di servizio facoltativi.
- Le norme sulla privacy devono indicare il modo in cui l'applicazione accede, utilizza, archivia o condivide i dati utente di Google. The privacy policy must comply with the Google API Services User Data Policy and the Limited Use requirements for restricted scopes. Devi limitare l'utilizzo dei dati utente di Google alle prassi indicate nelle norme sulla privacy pubblicate.
- Review example cases of privacy policies that don't meet the Limited Use requirements.
Come inviare la tua app per la verifica
Un Google API Console progetto organizza tutte le API Console risorse. Un progetto è costituito da un insieme di Account Google associati con l'autorizzazione per eseguire le operazioni del progetto, un insieme di API abilitate e le impostazioni di fatturazione, autenticazione e monitoraggio per queste API. Ad esempio, un progetto può contenere uno o più client OAuth, configurare le API per l'utilizzo da parte di questi client e configurare una schermata di consenso OAuth da mostrare agli utenti prima che autorizzino l'accesso alla tua app.
Se alcuni dei tuoi client OAuth non sono pronti per la produzione, ti suggeriamo di eliminarli dal progetto che richiede la verifica. Puoi farlo nell' Google API Console.
Per richiedere la verifica, segui questi passaggi:
- Assicurati che la tua app sia conforme ai Termini di servizio delle API di Google e alle Norme relative ai dati utente dei servizi API di Google.
- Mantieni aggiornati i ruoli di proprietario ed editor degli account associati al progetto, nonché l'email dell'assistenza utenti e le informazioni di contatto dello sviluppatore nella schermata per il consenso OAuth in API Console. Ciò garantisce che i membri corretti del tuo team vengano informati di eventuali nuovi requisiti.
- Vai a API Console OAuth Consent Screen page.
- Fai clic sul pulsante Selettore progetti.
-
Nella finestra di dialogo Seleziona da visualizzata, seleziona il tuo progetto. Se non riesci a trovare il progetto ma conosci l'ID progetto, puoi creare un URL nel browser nel seguente formato:
https://console.developers.google.com/apis/credentials/consent?project=[PROJECT_ID]
Sostituisci [PROJECT_ID] con l'ID progetto che vuoi utilizzare.
- Seleziona il pulsante Modifica app.
- Inserisci le informazioni necessarie nella pagina della schermata per il consenso OAuth, quindi seleziona il pulsante Salva e continua.
- Utilizza il pulsante Aggiungi o rimuovi ambiti per dichiarare tutti gli ambiti richiesti dalla tua app. Un set iniziale di ambiti necessari per Accedi con Google è precompilato nella sezione Ambiti non sensibili. Gli ambiti aggiunti sono classificati come non sensibili ( sensitive, or restricted).
- Fornisci fino a tre link a qualsiasi documentazione pertinente per le funzionalità correlate nella tua app.
-
Fornisci eventuali informazioni aggiuntive richieste relative alla tua app nei passaggi successivi.
- Ensure your app complies with the Additional requirements for specific API scopes, which includes undergoing an annual security assessment if your app accesses restricted scope Google users' data from or through a third-party server.
- Ensure your app is one of the allowed types specified in the Limited Use section of the Additional requirements for specific API scopes page.
- If your app is a task automation platform, your demonstration video must showcase how multiple API workflows are created and automated, and in which directions user data flows.
-
Prepare a video that fully demonstrates how a user initiates and grants access to the requested scopes and shows, in detail, the usage of the granted sensitive and restricted scopes in the app. Upload the video to YouTube Studio and set Visibility as Unlisted. You need to provide a link to the demonstration video in the YouTube link field.
- Show the OAuth grant process that users will experience, in English. This includes the consent flow and, if you use Google Sign-In, the sign-in flow.
- Show that the OAuth consent screen correctly displays the App Name.
- Show that the browser address bar of the OAuth consent screen correctly includes your app's OAuth client ID.
- To show how the data will be used, demonstrate the functionality that's enabled by each sensitive and restricted scope that you request.
- If you use multiple clients, and therefore have multiple OAuth client IDs, show how the data is accessed on each OAuth client.
- Select your permitted application type from the "What features will you use?" list.
- Describe how you will use the restricted scopes in your app and why more limited scopes aren't sufficient.
- Se la configurazione dell'app fornita richiede la verifica, hai la possibilità di inviare l'app per la verifica. Compila i campi obbligatori, quindi fai clic su Invia per avviare la procedura di verifica.
Dopo aver inviato l'app, il team Trust & Safety di Google ti contatterà via email per fornire eventuali informazioni aggiuntive di cui necessita o i passaggi da completare. Controlla gli indirizzi email nella sezione Dati di contatto dello sviluppatore e l'email di assistenza della schermata per il consenso OAuth per verificare se sono presenti richieste di informazioni aggiuntive. Puoi anche visualizzare la pagina della schermata per il consenso OAuth del tuo progetto per confermare lo stato di revisione attuale del progetto, ad esempio se il processo di revisione è in pausa mentre attendiamo la tua risposta.
Eccezioni ai requisiti di verifica
Se la tua app verrà utilizzata in uno degli scenari descritti nelle sezioni seguenti, non è necessario inviarla per la revisione.
Utilizzo personale
Un caso d'uso è se sei l'unico utente della tua app o se l'app viene utilizzata solo da pochi utenti, tutti noti personalmente. Tu e il tuo numero limitato di utenti potreste voler andare avanti nella schermata dell'app non verificata e concedere ai tuoi account personali l'accesso alla tua app.
Progetti utilizzati nei livelli di sviluppo, test o gestione temporanea
Per garantire la conformità ai criteri Google OAuth 2.0, ti consigliamo di creare progetti diversi per gli ambienti di test e di produzione. Ti consigliamo di inviare la tua app per la verifica solo se vuoi renderla disponibile a qualsiasi utente con un Account Google. Pertanto, se l'app è in fase di sviluppo, test o gestione temporanea, la verifica non è obbligatoria.
Se la tua app è in fase di sviluppo o test, puoi lasciare lo Stato di pubblicazione sull'impostazione predefinita di Test. Questa impostazione indica che l'app è ancora in fase di sviluppo ed è disponibile solo per gli utenti che aggiungi all'elenco di utenti di test. Devi gestire l'elenco di Account Google coinvolti nello sviluppo o nel test della tua app.
Solo dati di proprietà del servizio
Se la tua app utilizza un account di servizio per accedere solo ai suoi dati e non accede a nessun dato utente (collegato a un Account Google), non è necessario inviare la richiesta per la verifica.
Per capire cosa sono gli account di servizio, consulta Account di servizio nella documentazione di Google Cloud. Per istruzioni su come utilizzare un account di servizio, consulta l'articolo sull'utilizzo di OAuth 2.0 per applicazioni server-server.
Solo per uso interno
Ciò significa che l'app è utilizzata solo dagli utenti della tua organizzazione Google Workspace o Cloud Identity. Il progetto deve essere di proprietà dell'organizzazione e la relativa schermata per il consenso OAuth deve essere configurata per un tipo di utente interno. In questo caso, l'app potrebbe richiedere l'approvazione di un amministratore dell'organizzazione. Per maggiori informazioni, consulta Considerazioni aggiuntive per Google Workspace.
- Scopri di più sulle applicazioni pubbliche e interne.
- Scopri come contrassegnare la tua app come interna nelle domande frequenti. Come faccio a contrassegnare la mia app come solo per uso interno?
Installazione a livello di dominio
Se prevedi che la tua app abbia come target solo gli utenti di un'organizzazione Google Workspace o Cloud Identity e utilizzi sempre l'installazione a livello di dominio, la tua app non richiederà la verifica dell'app. Questo perché un'installazione a livello di dominio consente a un amministratore di dominio di concedere alle applicazioni interne e di terze parti l'accesso ai dati degli utenti. Gli amministratori dell'organizzazione sono gli unici account che possono aggiungere l'app a una lista consentita per utilizzarla all'interno dei propri domini.
Scopri come rendere la tua app un'installazione a livello di dominio nella domanda frequente La mia applicazione ha utenti con account aziendali di un altro dominio Google Workspace.