İzin Verilenler Listesi URL'leri

Erişim için önceden onaylanmış belirli URL'leri belirtmek üzere izin verilenler listeleri kullanırsınız komut dosyanız veya eklentiniz tarafından belirlenir. İzin verilenler listeleri kullanıcının korunmasına yardımcı olur veriler; Bir izin verilenler listesi tanımladığınızda, komut dosyası projeleri izin verilenler listesine eklenmemiş.

Bu alan, bir test dağıtımı yüklediğinizde isteğe bağlıdır ancak şu durumlarda zorunludur: sürümlü bir dağıtım oluşturmanız gerekir.

Komut dosyanız veya eklentiniz performans gösterdiğinde izin verilenler listelerini kullanırsınız şu işlemleri yapabilirsiniz:

  • Harici bir konumdan (HTTPS gibi) bilgi getirir veya getirir uç noktaları) Apps Komut Dosyası'nı UrlFetch kullanarak geliştirmenizi sağlar. Getirmek üzere URL'leri izin verilenler listesine eklemek için manifest dosyanıza urlFetchWhitelist alanını ekleyin.
  • Kullanıcı işlemine yanıt olarak bir URL açar veya görüntüler ( Kuruluş dışı olan ve görünen URL'leri açan veya görünen Google Workspace Eklentileri Google). URL'leri açmak üzere izin verilenler listesine eklemek içinaddOns.common.openLinkUrlPrefixes manifest dosyası olarak kaydedin.

İzin verilenler listenize ön ek ekleme

Manifest dosyanızda izin verilenler listeleri belirttiğinizde ( addOns.common.openLinkUrlPrefixes veya urlFetchWhitelist alanı) URL öneklerinin bir listesini içerir. Manifest'e eklediğiniz ön ekler aşağıdaki şartları karşılamanız gerekir:

  • Her önek geçerli bir URL olmalıdır.
  • Her ön ek için http:// değil, https:// kullanılmalıdır.
  • Her önek, tam alan adına sahip olmalıdır.
  • Her ön ekin boş olmayan bir yolu olmalıdır. Örneğin, https://www.google.com/ geçerlidir, ancak https://www.google.com geçerli değil.
  • URL alt alan adı öneklerini eşleştirmek için joker karakterler kullanabilirsiniz.
  • * addOns.common.openLinkUrlPrefixes alanını tüm bağlantıları eşleştirmek için kullanabilirsiniz, ancak kullanıcı verilerini riske atabilir ve eklenti incelemesi süreci. Yalnızca Eklenti işlevselliğiniz gerektiriyorsa joker karakter kullanın.

Bir URL'nin izin verilenler listesindeki bir önekle eşleşip eşleşmediğini belirlerken aşağıdaki kurallar uygulayın:

  • Yol eşleştirme büyük/küçük harfe duyarlıdır.
  • Önek, URL ile aynıysa eşleşmedir.
  • URL, ön ekin aynı veya bir alt öğesiyse eşleşmedir.

Örneğin, https://example.com/foo öneki aşağıdaki URL'lerle eşleşir:

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

Joker karakter kullanma

Hem* urlFetchWhitelist ve addOns.common.openLinkUrlPrefixes alanları. Birden çok alt alan adını eşleştirmek için birden fazla joker karakter kullanamazsınız ve joker karakter, URL'nin ön ekini temsil etmelidir.

Örneğin, https://*.example.com/foo öneki şuyla eşleşir: URL'ler:

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

https://*.example.com/foo öneki aşağıdakiyle eşleşmez URL'ler:

  • https://subdomain.example.com/bar (sonek uyuşmazlığı)
  • https://example.com/foo (en az bir alt alan adı olmalıdır)

Manifest dosyanızı kaydetmeye çalışırken önek kurallarından bazıları zorunlu kılınır. Örneğin, aşağıdaki ön eklerle başlayan önekler, manifest'ini kullanabilirsiniz:

  • https://*.*.example.com/foo (birden fazla joker karakter kullanılamaz)
  • https://subdomain.*.example.com/foo. (baştaki önek olarak joker karakterler kullanılmalıdır)