Utilizzi le liste consentite per designare URL specifici che sono pre-approvati per l'accesso dal tuo script o componente aggiuntivo. Le liste consentite contribuiscono a proteggere i dati degli utenti. Quando definisci una lista consentita, i progetti di script non possono accedere agli URL che non sono stati aggiunti alla lista consentita.
Questo campo è facoltativo quando installi un deployment di test, ma è obbligatorio quando crei un deployment con controllo delle versioni.
Utilizzi le liste consentite quando lo script o il componente aggiuntivo esegue le seguenti azioni:
- Recupera o estrae informazioni da una posizione esterna (ad esempio endpoint HTTPS) utilizzando il servizio
UrlFetch
di Apps Script. Per inserire gli URL nella lista consentita per il recupero, includi il campourlFetchWhitelist
nel file manifest. - Apre o visualizza un URL in risposta a un'azione dell'utente (obbligatorio per
i componenti aggiuntivi di Google Workspace che aprono o visualizzano URL esterni a
Google). Per inserire gli URL nella lista consentita per l'apertura, includi il campo
addOns.common.openLinkUrlPrefixes
nel file manifest.
Aggiungere prefissi alla lista consentita
Quando specifichi le liste consentite nel file manifest (includendo il campo
addOns.common.openLinkUrlPrefixes
o urlFetchWhitelist
), devi
includere un elenco di prefissi URL. I prefissi che aggiungi al manifest devono
soddisfare i seguenti requisiti:
- Ogni prefisso deve essere un URL valido.
- Ogni prefisso deve utilizzare
https://
, nonhttp://
. - Ogni prefisso deve avere un dominio completo.
- Ogni prefisso deve avere un percorso non vuoto. Ad esempio,
https://www.google.com/
è valido, mahttps://www.google.com
no. - Puoi utilizzare i caratteri jolly per trovare una corrispondenza con i prefissi dei sottodomini degli URL.
- È possibile utilizzare un singolo carattere jolly
*
nel campoaddOns.common.openLinkUrlPrefixes
per trovare tutti i link, ma questa operazione non è consigliata in quanto può esporre i dati di un utente a rischi e può prolungare la procedura di revisione dei componenti aggiuntivi. Utilizza un carattere jolly solo se la funzionalità del componente aggiuntivo lo richiede.
Quando viene determinato se un URL corrisponde a un prefisso nella lista consentita, si applicano le seguenti regole:
- La corrispondenza del percorso è sensibile alle maiuscole.
- Se il prefisso è identico all'URL, si tratta di una corrispondenza.
- Se l'URL è uguale o un elemento secondario del prefisso, si verifica una corrispondenza.
Ad esempio, il prefisso https://example.com/foo
corrisponde ai seguenti URL:
https://example.com/foo
https://example.com/foo/
https://example.com/foo/bar
https://example.com/foo?bar
https://example.com/foo#bar
Utilizzo dei caratteri jolly
Puoi utilizzare un singolo carattere jolly (*
) per trovare una corrispondenza con un sottodominio per i campi
urlFetchWhitelist
e addOns.common.openLinkUrlPrefixes
. Non puoi utilizzare più di un carattere jolly per trovare la corrispondenza con più sottodomini e
il carattere jolly deve rappresentare il prefisso iniziale dell'URL.
Ad esempio, il prefisso https://*.example.com/foo
corrisponde ai seguenti
URL:
https://subdomain.example.com/foo
https://any.number.of.subdomains.example.com/foo
Il prefisso https://*.example.com/foo
non corrisponde ai seguenti
URL:
https://subdomain.example.com/bar
(suffisso non corrispondente)https://example.com/foo
(deve essere presente almeno un sottodominio)
Alcune regole relative ai prefissi vengono applicate quando tenti di salvare il manifest. Ad esempio, i seguenti prefissi causano un errore se sono presenti nel manifest quando tenti di salvare:
https://*.*.example.com/foo
(sono vietati più caratteri jolly)https://subdomain.*.example.com/foo
(i caratteri jolly devono essere utilizzati come prefisso iniziale)