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 aşamasındadır.

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. Şifrelenmemiş HTTP (http://) üzerinden veri göndermek güvenli değildir. HTTPS (https://) kullanın.

Workspace Studio, kuruluşunuzun verilerini korumak için birden fazla güvenlik önlemi içerir:

  • Varsayılan olarak devre dışıdır: Webhook'lar, bir yönetici tarafından bir kuruluş birimi için açıkça etkinleştirilene kadar devre dışıdı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ının çalıştırılmadan önce bir kişi tarafından incelenmesi ve onaylanması gerekir.
  • Günlük etkinliği verileri: Webhook yürütme istekleri, Workspace Studio günlüğü etkinlikleri olarak kaydedilir.

1. adım: Webhook'ları 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ı) Webhook'ları bir URL 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 belirli izin verilenler listesindeki 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 alan adlarını 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 değerlendirilir. Bir akışta webhook adımı kullanıldığında Workspace Studio, akışı çalıştıran veya başlatan kullanıcının işlem ç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ın dahil olduğu 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üğü etkinliklerini kullanarak webhook kullanımını inceleyebilirsiniz.

Başlamadan önce: Webhook günlük etkinlik verileri, URL'ler gibi hassas içerikler barındırır. Bu içeriği 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. Filtrele ardından Filtre ekle ardından Adım adı'nı tıklayın.
  3. Aşağıdaki değerlerden birini kullanarak filtre ekleyin:
    • Şunu içerir'i seçin ve webhook yazın.
    • Şu değere eşit:'i seçin ve Webhook gönder'i girin.
  4. Etkinlik parametrelerini inceleyin:
    • Webhook isteği URL'si: Webhook adımı tarafından çağrılan hedef URL. URL, hassas veri olarak değerlendirilir.