İstemci kimliğini almak, doğrulamak ve ardından yanıt üstbilgisinde geri döndürmek için örnek Javascript kodu
- Paketi Yükleme
- Paketi Yapılandırma
- Kullanıcı Kılavuzu
- Dijital Kimlik Doğrulamayı Etkinleştirme
- Geliştirici Kılavuzu
- Gelişmiş Özelleştirme Kılavuzu
- Alan Eşleştirme ve Şablon Kılavuzu
- Mobil Uygulama Kullanıcı Kılavuzu
- Akış Otomasyonu Kılavuzu
- Document Builder Kılavuzu
- Büyük Belgeleri Yapılandırma
- Yükseltme Kılavuzu
- Sürüm Notları
- SSS
- Sorun Giderme Kılavuzu
- Ek Makaleler
- Microsoft 365 için Acrobat Sign
- Outlook için Acrobat Sign
- Word/PowerPoint için Acrobat Sign
- Teams için Acrobat Sign
- Microsoft PowerApps ve Power Automate için Acrobat Sign
- Microsoft Arama İşlevi için Acrobat Sign Bağlayıcı
- Microsoft Dynamics için Acrobat Sign
-
Microsoft SharePoint için Acrobat Sign
- Genel Bakış
- SharePoint On-Prem: Kurulum Kılavuzu
- SharePoint On-Prem: Şablon Eşleştirme Kılavuzu
- SharePoint On-Prem: Kullanıcı Kılavuzu
- SharePoint On-Prem: Sürüm Notları
- SharePoint Online: Kurulum Kılavuzu
- SharePoint Online: Şablon Eşleştirme Kılavuzu
- SharePoint Online: Kullanıcı Kılavuzu
- SharePoint Online: Web Formu Eşleştirme Kılavuzu
- SharePoint Online: Sürüm Notları
- Adobe Acrobat Sign Entegrasyonları
- Ürün Sürümler ve Yaşam Döngüsü
-
Salesforce için Acrobat Sign
- Paketi Yükleme
- Paketi Yapılandırma
- Kullanıcı Kılavuzu
- Dijital Kimlik Doğrulamayı Etkinleştirme
- Geliştirici Kılavuzu
- Gelişmiş Özelleştirme Kılavuzu
- Alan Eşleştirme ve Şablon Kılavuzu
- Mobil Uygulama Kullanıcı Kılavuzu
- Akış Otomasyonu Kılavuzu
- Document Builder Kılavuzu
- Büyük Belgeleri Yapılandırma
- Yükseltme Kılavuzu
- Sürüm Notları
- SSS
- Sorun Giderme Kılavuzu
- Ek Makaleler
-
Microsoft için Acrobat Sign
- Microsoft 365 için Acrobat Sign
- Outlook için Acrobat Sign
- Word/PowerPoint için Acrobat Sign
- Teams için Acrobat Sign
- Microsoft PowerApps ve Power Automate için Acrobat Sign
- Microsoft Arama İşlevi için Acrobat Sign Bağlayıcı
- Microsoft Dynamics için Acrobat Sign
-
Microsoft SharePoint için Acrobat Sign
- Genel Bakış
- SharePoint On-Prem: Kurulum Kılavuzu
- SharePoint On-Prem: Şablon Eşleştirme Kılavuzu
- SharePoint On-Prem: Kullanıcı Kılavuzu
- SharePoint On-Prem: Sürüm Notları
- SharePoint Online: Kurulum Kılavuzu
- SharePoint Online: Şablon Eşleştirme Kılavuzu
- SharePoint Online: Kullanıcı Kılavuzu
- SharePoint Online: Web Formu Eşleştirme Kılavuzu
- SharePoint Online: Sürüm Notları
- ServiceNow için Acrobat Sign
- HR ServiceNow için Acrobat Sign
- SAP SuccessFactors için Acrobat Sign
- Workday için Acrobat Sign
- NetSuite için Acrobat Sign
- SugarCRM için Acrobat Sign
- VeevaVault için Acrobat Sign
- Coupa BSM Suite için Acrobat Sign
- Zapier için Acrobat Sign
Genel Bakış
Web kancası, kaynak sitede (bu durumda Adobe Acrobat Sign) belirli bir olay meydana geldiğinde tetiklenen kullanıcı tanımlı bir HTTPS isteğidir.
Web kancası, veri veya veri akışını kabul eden bir REST hizmetidir.
Web kancaları, bir PUSH modelinde hizmetten hizmete iletişime yöneliktir.
Acrobat Sign, abone olunan olay tetiklendiğinde JSON gövdesine sahip bir HTTPS POST oluşturur ve bunu belirtilen URL'ye gönderir.
13.3 Genel
Web kancaları, önceki geri çağırma yöntemine kıyasla pek çok avantaj sunar. Bunlardan bazıları şunlardır:
- Yöneticiler, geri çağırma URL'sini listelemek için Acrobat Sign desteğini dahil etmek zorunda kalmadan kendi web kancalarını etkinleştirebilir
- Web kancaları veri "tazeliği, iletişim verimliliği ve güvenlik açısından daha iyidir. Sorgulama gerekmez
- Web kancaları, farklı kapsam düzeylerine (Hesap/Grup/Kullanıcı/Kaynak) kolayca izin verir. 13.3 Genel
- Web kancaları, modern uygulamalara daha kolay yapılandırma sağlayan daha anlaşılır bir API çözümüdür
- Geri Çağırmaların benzersiz olması gereken kapsam (Hesap/Grup/Kullanıcı/Kaynak) başına birden fazla web kancası yapılandırılabilir
- Geri çağırmaların "ya hep ya hiç" çözümü olduğu yerde web kancaları, döndürülecek verilerin seçimine izin verir
- Web kancası ile taşınan meta veriler yapılandırılabilir (Temel veya Ayrıntılı)
- Kullanıcı arabirimi tamamen yöneticinin kontrolünde olduğundan web kancalarını oluşturmak, düzenlemek veya devre dışı bırakmak çok daha kolaydır.
Bu belge, özellikle Acrobat Sign web uygulamasındaki (önceki adıyla Adobe Sign) Web Kancalarının kullanıcı arabirimine odaklanır.
API ayrıntılarını öğrenmek isteyen geliştiriciler daha fazla bilgiyi burada bulabilir:
Nasıl kullanılır?
Yöneticiler öncelikle Acrobat Sign'dan gelen push'u kabul etmeye hazır bir web kancası hizmetine sahip olmalıdır. Bu konuda pek çok seçenek vardır. İlgili hizmet POST ve GET isteklerini kabul edebildiği sürece web kancası başarılı olur.
Acrobat Sign yöneticisi, hizmet başlatıldıktan sonra Acrobat Sign sitesinin Hesap menüsündeki Web Kancası arabiriminden yeni bir web kancası oluşturabilir.
Yöneticiler, web kancasını Sözleşme, Web formu (Widget) veya Toplu Halde Gönderme (MegaSign) olaylarını tetikleyecek şekilde yapılandırabilir. Kitaplık Şablonu (Kitaplık Belgesi) kaynağı API aracılığıyla da yapılandırılabilir.
Web kancasının kapsamı, yönetici arabirimi aracılığıyla tüm hesabı veya bireysel grupları içerebilir. API, KULLANICI veya KAYNAK kapsamları tercihleri sayesinde daha fazla ayrıntılı seçim olanağı sağlar.
URL'ye gönderilen veri türü yapılandırılabilir ve Sözleşme Bilgileri, Katılımcı Bilgileri, Belge Bilgileri vb. öğeleri içerebilir.
Web kancası yapılandırılıp kaydedildikten sonra Acrobat Sign, abone olunan olayı her tetiklendiğinde tanımlanan URL'ye yeni bir JSON nesnesi gönderir. Olay tetikleme kriterlerini veya JSON yükünü değiştirmek istemediğiniz sürece web kancasının sürekli olarak değiştirilmesi gerekmez.
Web kancası URL'sinin amacını doğrulama
Acrobat Sign, bir web kancasını başarıyla kaydetmeden önce kayıt isteğinde sağlanan web kancası URL'sinin bildirim almayı isteyip istemediğini doğrular. Bu amaçla, Acrobat Sign yeni bir web kancası kayıt isteği aldığında, ilk olarak web kancası URL'sine bir doğrulama isteği gönderir. Bu doğrulama isteği, web kancası URL'sine gönderilen bir HTTPS GET isteğidir. Bu istekte özel bir HTTP üstbilgisi olan X-AdobeSign-ClientId vardır. Bu üstbilgideki değer, web kancasını oluşturmak/kaydetmek isteyen API uygulamasının istemci kimliği (Uygulama Kimliği) olarak ayarlanır. Web kancasını başarıyla kaydetmek için web kancası URL'sinin bu doğrulama isteğine 2XX yanıt koduyla karşılık vermesi VE ayrıca, aynı istemci kimliği değerini aşağıdaki iki yoldan biriyle geri göndermesi:
- Yanıt üstbilgisinde X-AdobeSign-ClientId. Bu, istekte iletilen ve yanıt olarak tekrar yansıtılan üstbilgiyle aynıdır.
- Alternatif olarak, xAdobeSignClientId anahtarına ve istekte gönderilen istemci kimliğiyle aynı değere sahip olacak şekilde JSON yanıt gövdesinde iletilir.
Web kancası, yalnızca başarılı bir yanıtta (2XX yanıt kodu) ve üstbilgide ya da yanıt gövdesinde müşteri kimliğinin doğrulanmasında başarıyla kaydedilecektir. Bu doğrulama isteğinin amacı, web kancası URL'nizin o URL'de bildirim almak istediğini göstermektir. Yanlış URL girdiğinizde URL, amaç isteğinin doğrulanmasına doğru şekilde yanıt veremez ve Acrobat Sign bu URL'ye hiçbir bildirim göndermez. Ayrıca web kancası URL'si, yalnızca belirli bir uygulamanın kaydettiği web kancaları aracılığıyla bildirim alacağını da doğrulayabilir. Bu işlem, X-AdobeSign-ClientId üstbilgisinde iletilen uygulamanın istemci kimliğini doğrulayarak yapılabilir. Web kancası URL'si bu istemci kimliğini tanımazsa başarılı yanıt koduyla yanıt vermemesi GEREKİR ve Acrobat Sign, URL'nin bir web kancası olarak kaydedilmemesine dikkat eder.
Web kancası URL çağrısının doğrulaması aşağıdaki senaryolarda gerçekleştirilir:
- Web Kancasını Kaydetme: Web kancası URL çağrısının bu doğrulaması başarısız olursa web kancası oluşturulmaz.
- Web Kancasını Güncelleme: ETKİN DEĞİL-ETKİN: Web kancası URL çağrısının bu doğrulaması başarısız olursa web kancası durumu ETKİN olarak değiştirilmez.
Web kancası bildirimine yanıt verme
Acrobat Sign, web kancası URL'sine gönderilen her web kancası bildirim isteğinde örtük bir amaç doğrulaması gerçekleştirir. Bu nedenle, her web kancası bildirimi HTTPS isteği, X-AdobeSign-ClientId adlı özel HTTP üstbilgisini de içerir. Bu üstbilginin değeri, web kancasını oluşturan uygulamanın istemci kimliğidir (Uygulama Kimliği). Web kancası bildiriminin başarılı bir şekilde teslim edildiğini ancak ve ancak, bir başarılı yanıt (2XX yanıt kodu) döndürülürse ve istemci kimliği, HTTP üstbilgisinde (X-AdobeSign-ClientId) veya JSON yanıt gövdesi aracılığıyla xAdobeSignClientId anahtarına ve müşteri kimliğiyle aynı değere sahip şekilde gönderilirse kabul ederiz. Aksi takdirde, yeniden denemeler bitene kadar bildirimi web kancası URL'sine göndermeyi yeniden deneriz.
Yapılandırma seçenekleri
Web kancasını yapılandırmak için beş öğenin tanımlanması gerekir:
- Ad: Diğer yöneticilerin kolayca anlayabileceği sezgisel bir ad önerilir.
- Kapsam: Web kancasının yakalayacağı ağ genişliği nedir? Hesap ve Grup, arabirimde mevcuttur.
- API; Hesap, Grup, Kullanıcı ve Kaynak kapsamlarını destekler.
- Her web kancası için yalnızca bir Kapsam tanımlanabilir.
- URL: Adobe Sign'ın JSON yükünü ilettiği hedef URL.
- Olaylar: Adobe Sign'ın JSON oluşturma ve URL'ye gönderme işlemini tetikleyen durumlar.
- Her olay, tetikleyici olayla ilgili farklı bir yük oluşturur.
- Tek bir web kancasına birden fazla Olay eklenebilir.
- Bildirim Parametreleri: Bildirim Parametreleri, Olay JSON yükünün bölümlerini tanımlar. Bu şekilde yalnızca bu web kancası için önemli olan Olay bölümlerini seçebilirsiniz (böylelikle URL'nize gönderilen gereksiz veriler azaltılır).
Web kancası tam olarak tanımlandıktan sonra Kaydet'i tıklatın; yeni web kancası tetiklenen olaylara anında yanıt vermeye başlayacaktır.
Lütfen web kancası URL'nizi, yukarıda açıklanan doğrulama protokolüne göre web kancası doğrulama ve web kancası bildirim isteklerine yanıt verecek şekilde yapılandırın. Acrobat Sign web uygulamasından oluşturulan web kancalarına gönderilecek istemci kimliği (Uygulama Kimliği) UB7E5BXCXY olacaktır.
Kapsamlar
- Hesap: Hesapta meydana gelen tüm abone olunan olaylar gönderme işlemini tetikler.
- Hesap yöneticileri, hesap için tanımlanan tüm web kancalarını ve bu hesap içerisindeki tüm grupları görme yetkisine sahiptir.
- Grup: Hesapta meydana gelen tüm abone olunan olaylar gönderme işlemini tetikler. NOT: Grup kapsamı bulunan web kancaları yalnızca o grup için mevcuttur.
- Grup yöneticileri yalnızca kendi gruplarına ayrılmış web kancalarını görür. Hesap düzeyinde web kancalarını veya diğer gruplara bağlı web kancalarını göremezler.
- Birden Fazla Gruptaki Kullanıcılar seçeneğinin etkin olduğu hesaplarda, kapsamın uygulanması gereken grubu belirleme seçeneği görünür.
- Kullanıcı Hesabı: Bir kullanıcı hesabı için abone olunan tüm olaylar gönderme işlemini tetikler. Kullanıcı düzeyinde web kancaları yalnızca API aracılığıyla oluşturulabilir.
- Kaynak düzeyinde web kancası: Belirli bir kaynak için oluşturulur. Bu kaynağa özel olaylar, web kancası URL'sine gönderilir. Kaynak düzeyinde web kancaları yalnızca API aracılığıyla oluşturulabilir.
URL
Web kancası URL'si, olaylar meydana geldiğinde tetiklenen, gelen HTTPS POST bildirim mesajlarını dinleyen bir sunucudur.
Olaylara yönelik web kancanıza abone olmak için bu URL'ye ihtiyacınız vardır.
- İstemcide, Acrobat Sign'ın GÖNDERİM yapabileceği bir HTTPS URL'si olmalıdır. Bu URL herkese açık internette bulunmalıdır.
- Örneğin, 127.0.0.1 olduğunda yerel ana makine URL'leri çalışmayacaktır.
- URL uç noktası 443 veya 8443 numaralı bağlantı noktasını dinliyor olmalıdır (geri çağırma URL'sini tanımlarken müşteri tarafından belirlenir).
- Web kancasının, gelen olay bildirimleri için POST isteklerini ve doğrulama isteği için GET isteklerini desteklediğinden emin olun.
- URL, güvenlik duvarı tarafından engellenmemelidir.
Aşağıda, nesneye göre gruplandırılmış ve kullanıcı arabirimindeki sıraya göre listelenmiş web kancası URL'sine push işlemini tetikleyebilecek olaylar yer almaktadır.
Soldaki değer Acrobat Sign kullanıcı arabiriminde göreceğiniz değerdir. Sağdaki değer API'deki web kancası adıdır.
Web kancaları ve yükleriyle ilgili tüm ayrıntılar için Acrobat Sign geliştirici kılavuzuna bakın.
Sözleşmeler:
Kullanıcı Arabirimi Öğesi | Web kancası adı |
Sözleşme tüm olaylar | AGREEMENT_ALL |
Sözleşme oluşturuldu | AGREEMENT_CREATED |
Sözleşme gönderildi | AGREEMENT_ACTION_REQUESTED |
Sözleşme katılımcısı tamamlandı | AGREEMENT_ACTION_COMPLETED |
Sözleşme iş akışı tamamlandı | AGREEMENT_WORKFLOW_COMPLETED |
Sözleşmenin süresi doldu | AGREEMENT_EXPIRED |
Sözleşme silindi | AGREEMENT_DOCUMENTS_DELETED |
Sözleşme iptal edildi | AGREEMENT_RECALLED |
Sözleşme reddedildi | AGREEMENT_REJECTED |
Sözleşme paylaşıldı | AGREEMENT_SHARED |
Sözleşme delege edildi | AGREEMENT_ACTION_DELEGATED |
Sözleşme katılımcısı değiştirildi | AGREEMENT_ACTION_REPLACED_SIGNER |
Sözleşme değiştirildi | AGREEMENT_MODIFIED |
Sözleşmenin değiştirilmesi teyit edildi | AGREEMENT_USER_ACK_AGREEMENT_MODIFIED |
Sözleşme e-postası görüntülendi | AGREEMENT_EMAIL_VIEWED |
Sözleşme e-postası geri döndü | AGREEMENT_EMAIL_BOUNCED |
Sözleşme oluşturulamadı | AGREEMENT_AUTO_CANCELLED_CONVERSION_PROBLEM |
Sözleşme çevrimdışı olay sonrasında senkronize edildi | AGREEMENT_OFFLINE_SYNC |
Sözleşme gönderen tarafından yüklendi | AGREEMENT_UPLOADED_BY_SENDER |
Sözleşme kasaya koyuldu | AGREEMENT_VAULTED |
Sözleşme katılımcısının sosyal kimliği doğrulandı | AGREEMENT_WEB_IDENTITY_AUTHENTICATED |
Sözleşme katılımcısının kimliği KBA yöntemiyle doğrulandı | AGREEMENT_KBA_AUTHENTICATED |
Sözleşme hatırlatıcı gönderildi | AGREEMENT_REMINDER_SENT |
İmzalayan, sözleşme imzalayan adını değiştirdi | AGREEMENT_SIGNER_NAME_CHANGED_BY_SIGNER |
Sözleşme Web kancaları yalnızca API üzerinden kullanılabilir | |
NA | AGREEMENT_EXPIRATION_UPDATED |
NA |
AGREEMENT_READY_TO_NOTARIZE |
NA |
AGREEMENT_READY_TO_VAULT |
Toplu Halde Gönder:
Kullanıcı Arabirimi Öğesi | Web kancası adı |
Toplu Hâlde Gönder tüm olaylar | MEGASIGN_ALL |
Toplu Halde Gönder ile oluşturulanlar |
MEGASIGN_CREATED |
Toplu Halde Gönder ile paylaşılanlar |
MEGASIGN_SHARED |
Toplu Halde Gönder ile geri çağırılanlar |
MEGASIGN_RECALLED |
Web Formları:
Kullanıcı Arabirimi Öğesi | Web kancası adı |
Web Formuyla ilgili tüm olaylar | WIDGET_ALL |
Web Formu oluşturuldu |
WIDGET_CREATED |
Web Formu etkinleştirildi |
WIDGET_ENABLED |
Web Formu devre dışı bırakıldı |
WIDGET_DISABLED |
Web Formu değiştirildi |
WIDGET_MODIFIED |
Web Formu paylaşıldı |
WIDGET_SHARED |
Web Formu oluşturulamadı |
WIDGET_AUTO_CANCELLED_CONVERSION_PROBLEM |
Kitaplık şablonları (Yalnızca API):
Kullanıcı Arabirimi Öğesi | Web kancası adı |
NA | LIBRARY_DOCUMENT_ALL |
NA | LIBRARY_DOCUMENT_CREATED |
NA | LIBRARY_DOCUMENT_AUTO_CANCELLED_CONVERSION_PROBLEM |
NA | LIBRARY_DOCUMENT_MODIFIED |
Bildirim Parametreleri
Bildirim Parametreleri, JSON yükünü yalnızca olayın belirli öğelerine göre özelleştirmenizi sağlar.
Örneğin Sözleşme katılımcısı değiştirildi olayında, Belge Bilgilerini dışarıda bırakarak ve web kancası URL'nize gönderilen toplam JSON boyutunu azaltarak yalnızca Sözleşme Bilgilerini ve Katılımcı Bilgilerini isteyebilirsiniz.
- Sözleşme
- Sözleşme Bilgileri: Tetikleyici olay sırasında sözleşmenin durumuna göre ayrıntılı sözleşme bilgileri.
- Sözleşme Belgesi Bilgileri: Olay sonucunda oluşturulan tüm belge bilgilerini içerir.
- Sözleşme Katılımcısı Bilgileri: Olayın bir sonucu olarak tüm katılımcı bilgilerini içerir.
- Sözleşme İmzalı Belge: İmzalanan PDF'yi sağlar.
- Sözleşme İş Akışı Tamamlandı ve Sözleşme Tüm Olaylar için geçerlidir.
- Toplu Halde Gönder
- Toplu Halde Gönder Bilgileri: Olayı tetikleyen Toplu Halde Gönder nesnesi hakkında ayrıntılı bilgiler.
- Web Formu
- Widget Bilgileri: Olayı tetikleyen web formu hakkında ayrıntılı bilgiler.
- Widget Belge Bilgileri: Web formuyla ilişkili belge bilgileri.
- Widget Katılımcı Bilgileri: Web formunda tanımlanan katılımcılar hakkında bilgiler.
İki yönlü SSL kimlik doğrulaması
Genellikle İstemci Tarafı SSL veya karşılıklı TLS olarak adlandırılan iki yönlü SSL, hem sunucunun hem de istemcinin (web tarayıcısı) kendilerini tanımlamak için sertifika sağladığı bir SSL modudur.
Hesap yöneticileri, Güvenlik Ayarları sayfasında istemci tarafı sertifikasını yapılandırabilir.
Acrobat Sign, web kancası URL'sine yük teslim ederken SSL sertifikalarını doğrular. SSL sertifika doğrulamasında başarısız olan web kancaları, JSON yükünü başarılı bir şekilde gönderemez.
İstemcinin (Acrobat Sign) ve dinleme hizmetinin kimliğini doğrulamak için İki yönlü SSL kullanarak web kancası URL'nize yalnızca Acrobat Sign'ın erişebildiğinden emin olun.
Web kancası, İş Ortağı Uygulaması tarafından oluşturulmuşsa web kancası bildirimlerini gönderirken kendisini tanımlamak için İş Ortağı Uygulamasının Hesabından (varsa) bir istemci sertifikası kullanır.
Aşağıda hem web sunucusu doğrulama işlemi hem de istemci sertifikasyon doğrulaması için en yaygın sorular vardır.
Web sunucusu doğrulaması
Bir web kancasının kaydı sırasında, Acrobat Sign web kancası sunucu URL'sini doğrular.
Müşteriler, Acrobat Sign'dan web kancası geri çağırma URL'sine bağlantı tamamlanamazsa web kancasına kaydolamaz.
İstemci sertifikası doğrulaması
Etkinleştirme veya devre dışı bırakma
Web kancaları özelliğine erişim, kurumsal plan hesapları için varsayılan olarak etkindir.
Grup düzeyindeki yöneticiler yalnızca kendi gruplarında çalışan Web Kancalarını oluşturabilir/kontrol edebilir.
Web Kancaları sayfasına erişim, Yönetici menüsünün sol tarafında bulunabilir: Hesap > Web Kancaları
Web kancasını etkinleştirme
Bir web kancası ilk olarak Etkin durumunda oluşturulur.
Acrobat Sign'ın Web Kancaları sayfasında varsayılan olarak Etkin web kancalarını görürsünüz.
Etkin olmayan bir web kancasını etkinleştirmek için:
- Web kancaları üstbilgi satırının sağındaki Seçenekler simgesini (üç yatay çizgi) tıklatın ve Tüm Web Kancalarını Göster'i seçin.
- Etkin olmayan web kancasını bir kez tıklatarak seçin
- Bu işlem, üstbilgi satırının hemen altındaki web kancası seçeneklerini gösterir
- Etkinleştir'i tıklatın
Etkin web kancası, bir sonraki olay tetiklendiği anda hedef URL'ye veri göndermeye başlar.
Web kancasını devre dışı bırakma
Web kancasını devre dışı bırakmak için
- Web Kancaları sayfasına gidin
- Devre dışı bırakmak istediğiniz web kancasını bir kez tıklatın
- Üstbilgi satırının altındaki menü öğelerinden Devre Dışı Bırak'ı seçin
- Devre dışı bırakılan web kancasında Devre Dışı durumu gösterilir
Web kancasını görüntüleme veya düzenleme
Web kancaları istenildiği zaman düzenlenebilir ve kaydedilebilir. Yeni bir yapılandırma kaydedildikten sonra da bu değişiklik hemen geçerli olur.
Yalnızca Olaylar ve Bildirim Parametreleri düzenlenebilir.
Ad, Kapsam veya URL'nin değiştirilmesi gerekiyorsa yeni bir web kancası oluşturulması gerekir.
Bir web kancasının parametrelerini düzenlemek için:
- Web Kancaları sayfasına gidin
- Düzenlemek istediğiniz web kancasını bir kez tıklatın
- Üstbilgi satırının altındaki Görüntüle/Düzenle seçeneğini tıklatın
- Gerekli değişiklikleri uygulayıp Kaydet'i tıklatın
Web kancasını silme
Bir web kancası istenildiği zaman silinebilir.
Silinen bir web kancası sistemde yok olacağı için silinen bir web kancasını kurtarmanız mümkün değildir.
Web kancalarının önce devre dışı bırakılması gerekmez.
Bir web kancasını silmek için:
- Web Kancaları'na gidin
- Silmek istediğiniz web kancasını bir kez tıklatarak seçin
- Üstbilgi satırının altındaki Sil seçeneğini tıklatın
- Web kancasını silmek istediğinizden emin olmak için karşınıza bir sorgulama çıkar. Tamam öğesini tıklatın
En İyi Uygulamalar
- Sunucuya giden HTTPS taleplerinin sayısını sınırlamak için belirli, gerekli olaylara abone olun. Web kancalarınızı ne kadar spesifik hâle getirirseniz incelemeniz gereken hacim de o kadar azalır.
- Yinelemelere karşı dirençli olun: Aynı web kancası URL'sini paylaşan birden fazla uygulamanız varsa ve aynı kullanıcı her uygulamayla eşlenmişse aynı olay, web kancanıza birden fazla kez gönderilir (uygulama başına bir kez). Bazı durumlarda web kancanız yinelenen olaylar alabilir. Web kancası uygulamanız buna karşı toleranslı olmalı ve olay kimliğine göre veri tekilleştirmesi yapılmalıdır.
- Web kancalarına her zaman hızlıca yanıt verin: Uygulamanızın, web kancası isteklerine yanıt vermesi için yalnızca beş saniyesi vardır. Uygulamanızın yanıt vermek için gerçek bir iş yapması gerekmediğinden, doğrulama isteği için bu nadiren sorun teşkil eder. Ancak bildirim istekleri söz konusu olduğunda, uygulamanız bu isteğe yanıt olarak genellikle zaman alan bir işlem gerçekleştirir. Beş saniye içinde yanıt verebilmeniz için ayrı bir iş parçacığı üzerinde veya bir kuyruk kullanarak eşzamanlı olmayan bir şekilde çalışmanız önerilir
- Eş zamanlı kullanımı yönetin: Bir kullanıcı arka arkaya birkaç değişiklik yaptığında, uygulamanızın aynı kullanıcı için neredeyse aynı anda birden fazla bildirim alması muhtemeldir. Eş zamanlı kullanımı yönetme konusunda dikkatli olmazsanız uygulamanız, aynı kullanıcı için aynı değişiklikleri birden fazla kez işleyebilir. Acrobat Sign web kancalarından yararlanmak için bilgilerin kullanımına dair net bir anlayış edinilmesi gerekir. Aşağıdaki gibi sorular sorduğunuzdan emin olun:
- Yükte hangi verileri döndürmek istiyorsunuz?
- Bu bilgilere kimler erişecek?
- Hangi kararlar veya raporlar oluşturulacak?
- İmzalanan belgeyi almayla ilgili öneriler: Belge yönetim sisteminizde, imzalanan PDF'yi Acrobat Sign'dan nasıl alacağınızı belirlerken göz önünde bulundurmanız gereken birkaç faktör vardır.
Bir web kancası oluştururken Sözleşme İmzalı Belge'nin seçilmesi tamamen kabul edilebilir olsa da tetikleyici bir olay (Sözleşme durumu tamamlandı gibi) söz konusu olduğunda belgeleri almak için Acrobat Sign API'yi kullanmayı düşünebilirsiniz.
Dikkate alınması gereken noktalar...
JSON boyut sınırlaması
JSON yük boyutu 10 MB ile sınırlıdır.
Bir olay daha büyük bir yük oluşturduğunda web kancası tetiklenir ancak koşullu parametre nitelikleri istekte mevcutsa yükün boyutunu azaltmak için kaldırılır.
"ConditionalParametersTrimmed", bu gerçekleştiğinde istemciye conditionalParameters bilgisinin kaldırıldığını bildirmek için yanıt olarak döndürülür.
"conditionalParametersTrimmed" kırpılan anahtarlarla ilgili bilgilerin olduğu bir dizi nesnesidir.
Kesme işlemi aşağıdaki sırayla yapılır:
- includeSignedDocuments
- includeParticipantsInfo
- includeDocumentsInfo
- includeDetailedInfo
İmzalanan belgeler önce kesilecek, ardından katılımcı bilgileri, belge bilgileri ve son olarak ayrıntılı bilgiler verilecektir.
Bu durum, örneğin imzalı belgeyi (taban 64 kodlu) de içeriyorsa bir sözleşme tamamlama olayında veya birden çok form alanı içeren bir sözleşmede olabilir.
Web kancası bildirimleri
Acrobat Sign web kancaları; kullanıcı, grubu veya hesapları için yapılandırılmış bir web kancası varsa bir sözleşmenin tüm katılımcıları için geçerli olan bildirimler gönderir.
Sözleşme etkinlikleri, söz konusu etkinliğin ilgili katılımcısı için yapılandırılmış bir web kancası varsa bu web kancası URL'sine bildirim gönderilecek şekilde işlenir. Başka bir deyişle web kancaları, web kancasının yapılandırıldığı grubun veya hesabın dışındakiler dahil tüm geçerli sözleşmelerdeki etkinlikler için tetiklenir.
Bildirimler yalnızca katılımcının dahil olduğu etkinlikler için gönderilir. Örneğin, bir sözleşmenin Göndereni hemen hemen her bildirimi alırken Alıcılar yalnızca sözleşmeye katıldıkları andan itibaren ve yalnızca dahil oldukları olaylar için bildirim alırlar.
Web kancası bildirimleri, Acrobat Sign'ın geçerli kimlik doğrulama ve görünürlük modelini uygular. Bu da kullanıcıların yalnızca katılımı başladığında bir sözleşmeye erişebildiği anlamına gelir.
Dinleme hizmeti kapalı olduğunda tekrar deneyin
Web kancası için hedef URL herhangi bir nedenle kapanırsa Acrobat Sign, JSON'yi sıraya alır ve 72 saat boyunca aşamalı bir döngüde yeniden gerçekleştirmeyi dener.
Teslim edilmeyen olaylar tekrar deneme kuyruğunda kalır ve sonraki 72 saat içinde bildirimler mümkün olduğunca gerçekleştikleri sırayla teslim edilmeye çalışılır.
Bildirimleri yeniden teslim etmeye çalışmak için denemeler arasındaki sürenin sürekli olarak iki katına çıkarıldığı bir strateji uygulanır. Denemelere 1 dakikalık aralıklarla başlanır, daha sonra bu aralık 12 saatte bir yükselir ve böylece 72 saat içinde 15 kez yeniden deneme yapılmış olur.
Web kancası alıcısı 72 saat içinde yanıt vermezse ve son yedi gün içinde başarılı bir bildirim gönderimi gerçekleşmediyse web kancası devre dışı bırakılır. Web kancası tekrar etkinleştirilene kadar bu URL'ye bildirim gönderilmez.
Web kancasının devre dışı bırakıldığı ve ardından tekrar etkinleştirildiği zaman arasındaki tüm bildirimler kaybolur.