Você usa listas de permissões para designar URLs específicos que são pré-aprovados para acesso pelo seu script ou complemento. As listas de permissões ajudam a proteger os dados do usuário. Quando você define uma lista de permissões, os projetos de script não podem acessar URLs que não foram adicionados a ela.
Esse campo é opcional quando você instala uma implantação de teste, mas é obrigatório quando você cria uma implantação com controle de versão.
Use as listas de permissões quando o script ou complemento realizar as seguintes ações:
- Recupera informações de um local externo (como endpoints
HTTPS) usando o serviço
UrlFetch
do Apps Script. Para permitir URLs para busca, inclua o campourlFetchWhitelist
no arquivo de manifesto. - Abre ou exibe um URL em resposta a uma ação do usuário (obrigatório para
complementos do Google Workspace que abrem ou exibem URLs externos ao
Google). Para permitir a abertura de URLs, inclua o campo
addOns.common.openLinkUrlPrefixes
no arquivo de manifesto.
Adicionar prefixos à lista de permissões
Ao especificar listas de permissões no seu arquivo de manifesto (incluindo os campos
addOns.common.openLinkUrlPrefixes
ou urlFetchWhitelist
), é necessário
incluir uma lista de prefixos de URL. Os prefixos adicionados ao manifesto precisam
atender aos seguintes requisitos:
- Cada prefixo precisa ser um URL válido.
- Cada prefixo precisa usar
https://
, e nãohttp://
. - Cada prefixo precisa ter um domínio completo.
- Cada prefixo precisa ter um caminho não vazio. Por exemplo,
https://www.google.com/
é válido, mashttps://www.google.com
não é. - Você pode usar caracteres curinga para corresponder a prefixos de subdomínio do URL.
- Um único caractere curinga
*
pode ser usado no campoaddOns.common.openLinkUrlPrefixes
para corresponder a todos os links, mas isso não é recomendado, porque pode expor os dados de um usuário e prolongar o processo de análise do complemento. Use um curinga apenas se a funcionalidade do complemento exigir.
Para determinar se um URL corresponde a um prefixo na lista de permissões, as regras a seguir são aplicadas:
- A correspondência de caminho diferencia maiúsculas de minúsculas.
- Se o prefixo for idêntico ao URL, haverá uma correspondência.
- Se o URL for o mesmo ou uma versão secundária do prefixo, ele será correspondente.
Por exemplo, o prefixo https://example.com/foo
corresponde aos seguintes URLs:
https://example.com/foo
https://example.com/foo/
https://example.com/foo/bar
https://example.com/foo?bar
https://example.com/foo#bar
Como usar caracteres curinga
Você pode usar um único caractere curinga (*
) para corresponder a um subdomínio nos campos
urlFetchWhitelist
e addOns.common.openLinkUrlPrefixes
. Não é possível usar mais de um caractere curinga para corresponder a vários subdomínios, e
ele precisa representar o prefixo principal do URL.
Por exemplo, o prefixo https://*.example.com/foo
corresponde aos seguintes URLs:
https://subdomain.example.com/foo
https://any.number.of.subdomains.example.com/foo
O prefixo https://*.example.com/foo
não corresponde aos seguintes
URLs:
https://subdomain.example.com/bar
(desconformidade do sufixo)https://example.com/foo
(pelo menos um subdomínio precisa estar presente)
Algumas das regras de prefixo são aplicadas quando você tenta salvar o manifesto. Por exemplo, os seguintes prefixos causam um erro se estiverem presentes no manifesto quando você tentar salvar:
https://*.*.example.com/foo
(vários caracteres curinga são proibidos)https://subdomain.*.example.com/foo
(caracteres curinga precisam ser usados como prefixo inicial)