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.

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.
  • Denetleme günlüğü: Web kancası yürütme istekleri ve HTTP yanıt durum kodları, yönetici denetleme günlüklerine kaydedilir.

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

  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.

Denetleme günlüklerinde webhook etkinliğini izleme

Yönetici Konsolu'ndaki Workspace Studio günlük etkinliklerini kullanarak webhook kullanımını inceleyebilir ve akış hatalarını giderebilirsiniz.

  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. Etkinlik adına göre filtrele:

    • workflow_execution_success
    • workflow_execution_failure

  3. Etkinlik parametrelerini inceleyin:

    • Webhook isteği URL'si: Webhook adımı tarafından çağrılan hedef URL.
    • Webhook yanıt kodu: Hedef uç nokta tarafından döndürülen HTTP durum kodu. Örneğin, 200, 404, 500.