Lista dozwolonych adresów URL

Za pomocą list dozwolonych możesz wyznaczać określone adresy URL, które są wstępnie zatwierdzone do dostępu za pomocą skryptu lub dodatku. Listy dozwolonych pomagają chronić użytkowników dane; jeśli zdefiniujesz listę dozwolonych, projekty skryptów nie będą miały dostępu do adresów URL zawierających nie znajduje się na liście dozwolonych.

To pole jest opcjonalne podczas instalowania wdrożenia testowego, ale jest wymagane, gdy utworzysz wdrożenie z wersją.

Gdy skrypt lub dodatek działa prawidłowo, używasz list dozwolonych następujące działania:

  • Pobiera informacje z lokalizacji zewnętrznej (np. HTTPS) punktów końcowych) za pomocą Apps Script UrlFetch. posprzedażna. Aby dodać adresy URL do listy dozwolonych pobierania, umieść w pliku manifestu pole urlFetchWhitelist.
  • Otwiera lub wyświetla adres URL w odpowiedzi na działanie użytkownika (wymagane w przypadku Dodatki do Google Workspace, które otwierają lub wyświetlają adresy URL spoza domeny Google). Aby dodać adresy URL do listy dozwolonych, które można otwierać, umieść pole addOns.common.openLinkUrlPrefixes w manifestu.

Dodawanie prefiksów do listy dozwolonych

Jeśli w pliku manifestu określisz listy dozwolonych (przez dodanie elementu addOns.common.openLinkUrlPrefixes lub urlFetchWhitelist), musisz dołączyć listę prefiksów adresów URL. Prefiksy dodane do pliku manifestu muszą spełniać te wymagania:

  • Każdy prefiks musi być prawidłowym adresem URL.
  • W każdym prefiksie musi znajdować się https://, a nie http://.
  • Każdy prefiks musi zawierać pełną domenę.
  • Każdy prefiks nie może mieć pustej ścieżki. Na przykład: https://www.google.com/ jest prawidłowe, ale https://www.google.com już nie.
  • Do prefiksów subdomen adresu URL możesz używać symboli wieloznacznych.
  • W* addOns.common.openLinkUrlPrefixes do wszystkich linków. Nie jest to jednak zalecane, ponieważ może narazić danych użytkownika na ryzyko i może wydłużyć sprawdzania dodatków. Tylko użyj symbolu wieloznacznego, jeśli jest to wymagane przez Twój dodatek.

Podczas określania, czy adres URL pasuje do prefiksu na liście dozwolonych, obowiązują te reguły zastosuj:

  • W dopasowywaniu ścieżki wielkość liter ma znaczenie.
  • Jeśli prefiks jest identyczny z adresem URL, zostaje dopasowany.
  • Jeśli URL jest taki sam lub podrzędny względem prefiksu, zostaje dopasowany.

Na przykład prefiks https://example.com/foo pasuje do tych adresów URL:

  • https://example.com/foo
  • https://example.com/foo/
  • https://example.com/foo/bar
  • https://example.com/foo?bar
  • https://example.com/foo#bar

Korzystanie z symboli wieloznacznych

Za pomocą jednego symbolu wieloznacznego (*) możesz dopasować subdomenę w przypadku urlFetchWhitelist i addOns.common.openLinkUrlPrefixes . Nie możesz użyć więcej niż jednego symbolu wieloznacznego, aby dopasować wiele subdomen. symbol wieloznaczny musi reprezentować początkowy prefiks adresu URL.

Na przykład prefiks https://*.example.com/foo pasuje do następującego Adresy URL:

  • https://subdomain.example.com/foo
  • https://any.number.of.subdomains.example.com/foo

Prefiks https://*.example.com/foo nie pasuje do tych adresów Adresy URL:

  • https://subdomain.example.com/bar (niezgodność sufiksu)
  • https://example.com/foo (musi istnieć co najmniej jedna subdomena)

Niektóre reguły prefiksu są wymuszane podczas zapisywania pliku manifestu. Dla: następujące prefiksy powodują błąd, jeśli występują w pliku manifestu przy próbie zapisania pliku:

  • https://*.*.example.com/foo (nie można używać wielu symboli wieloznacznych)
  • https://subdomain.*.example.com/foo (symbol wieloznaczny musi być na początku prefiksu)