Webhook gönderme işlemine izin verme veya işlemi engelleme

Bu özelliğin desteklendiği sürümler: Business Starter, Business Standard ve Business Plus; Enterprise Standard ve Enterprise Plus; Education Fundamentals, Education Standard, Teaching and Learning eklentisi ve Education Plus. Bu özelliğin desteklendiği eklentiler: Google AI Pro for Education.

Bu özellik sınırlı önizleme sürümündedir.

Webhook'lar, akışların harici bir bağlantı veya API ile veri göndermesine ya da almasına olanak tanır. Webhook adımı, kullanıcıların Google Workspace Studio tarafından doğrudan desteklenmeyen dahili ve harici kaynaklara bağlanmasına olanak tanır. Ancak kullanıcılar, kuruluşunuzun verilerini harici olarak paylaşırken dikkatli olmalıdır. Verilerin şifrelenmemiş HTTP (http://) üzerinden gönderilmesi güvenli değildir. HTTPS (https://) kullanın.

Workspace Studio, kuruluşunuzun verilerini korumak için çeşitli güvenlik önlemleri içerir:

  • Varsayılan olarak devre dışı: Web kancaları, bir yönetici tarafından kuruluş birimi için açıkça etkinleştirilene kadar devre dışı kalır.
  • URL izin verilenler listesi: Desteklenen sürümlerde webhook'lar yalnızca kuruluşunuzun URL izin verilenler listesinde belirtilen alanlara ve uç noktalara veri gönderir.
  • Kullanıcı onayı: Varsayılan olarak, her webhook adımı çalıştırılmadan önce bir kişi tarafından incelenip onaylanmalıdır.
  • Günlük etkinlik verileri: Web kancası yürütme istekleri, Workspace Studio günlüğü etkinlikleri olarak kaydedilir.

1. adım: Web kancalarını etkinleştirin veya devre dışı bırakın

Başlamadan önce: Bu ayar için bir bölüm veya ekip oluşturmanız gerekiyorsa Kuruluş birimi ekleme başlıklı makaleyi inceleyin.

  1. Google Yönetici Konsolu'nda Menü ardından Uygulamalar ardından Google Workspace ardından Workspace Studio'ya gidin.

    Hizmet Ayarları yönetici ayrıcalığına sahip olmayı gerektirir.

  2. Webhook ayarları'nı tıklayın.
  3. (İsteğe bağlı) Ayarı bir bölüme veya ekibe uygulamak için yan tarafta bir kuruluş birimi seçin.
  4. Seçili kuruluş birimindeki kullanıcıların akışlarda webhook adımlarını kullanmasına izin vermek için AÇIK'ı, webhook adımlarını engellemek için KAPALI'yı seçin.
  5. Kaydet'i tıklayın. Alternatif olarak, istediğiniz kuruluş birimi için Geçersiz kıl'ı tıklayabilirsiniz.

    Devralınan değeri daha sonra geri yüklemek için Devral'ı tıklayın.

2. adım: (İsteğe bağlı) Web kancalarını URL'lerin izin verilenler listesiyle kısıtlayın

Bu özelliğin desteklendiği sürümler: Business Plus; Enterprise Standard ve Enterprise Plus; Education Standard ve Education Plus. Sürümünüzü karşılaştırın.

Webhook adımlarını yalnızca izin verilenler listesindeki belirli alan adlarından ve URL'lerden veri gönderecek veya alacak şekilde kısıtlayabilirsiniz. Bu işlem için Google Drive, Dokümanlar, E-Tablolar ve Apps Komut Dosyası'nın paylaşılan URL izin verilenler listesi kullanılır.

Not: URL izin verilenler listelerini desteklemeyen sürümlerde, özellik etkinleştirildiğinde webhook'lar tüm geçerli URL'lere bağlanabilir.

URL izin verilenler listesini yönetme

  1. Google Yönetici Konsolu'nda Menü ardından Uygulamalar ardından Google Workspace ardından Drive ve Dokümanlar ardından Özellikler ve Uygulamalar'a gidin.

    Hizmet Ayarları yönetici ayrıcalığına sahip olmayı gerektirir.

  2. URL'lerden içe aktarma ve getirme'yi tıklayın.
  3. Yalnızca aşağıdaki URL'lerden içe aktarma ve getirmeye izin ver'i seçin.
  4. Yetkili URL'leri veya alanları girin (örneğin, https://api.example.com).
  5. Kaydet'i tıklayın.

Webhook adımları için kullanıcı onayı

Webhook adımları harici uç noktalarla iletişim kurduğundan hassas işlemler olarak kabul edilir. Bir akışta webhook adımı kullanıldığında Workspace Studio, akışı çalıştıran veya başlatan kullanıcının akış çalıştırılmadan önce işlemi inceleyip onaylamasını zorunlu kılar.

Kullanıcı onayı ayarlarını Yönetici Konsolu'nda yönetebilirsiniz. Ayrıntılar için Kuruluş dışı kullanıcıları içeren akışlar için onay zorunlu kılma başlıklı makaleyi inceleyin.

Günlük etkinlikleriyle webhook etkinliğini izleme

Yönetici Konsolu'ndaki Workspace Studio günlük etkinliklerini kullanarak webhook kullanımını inceleyebilirsiniz.

Başlamadan önce: Webhook günlüğü etkinlik verileri, URL'ler gibi hassas içerikler barındırır. Bu verileri görüntülemek için süper yönetici olmanız veya yöneticinizin Hassas içerikleri göster ayarını etkinleştirmesi gerekir.

  1. Google Yönetici Konsolu'nda Menü ardından Raporlama ardından Denetim ve inceleme ardından Workspace Studio günlüğü etkinlikleri'ne gidin.

    Denetim ve inceleme aracı yönetici ayrıcalığına sahip olmayı gerektirir.

  2. Adım adına göre filtreleme:

    • contains webhook
    • is "Send a webhook"

  3. Etkinlik parametrelerini inceleyin:

    • Webhook isteği URL'si: Webhook adımı tarafından çağrılan hedef URL. URL, hassas veri olarak değerlendirilir.