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.

Web kancalarını yapılandırmadan önce ağınızın işlevsellik için gereken IP aralıklarını kabul ettiğinden emin olun.

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.

Not:

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:

REST v6 ayrıntıları

Ön koşullar

Hizmetin çalışması için ağ güvenliğiniz aracılığıyla web kancalarına yönelik IP aralıklarına izin vermeniz gerekir.

REST v5'teki eski geri çağırma URL hizmeti, web kancası hizmetiyle aynı IP aralıklarını kullanır.

Yöneticiler, kullanıcı eklemek için Adobe Admin Console'da oturum açabilir. Oturum açtıktan sonra yönetici menüsüne gidin ve Web Kancaları
öğesine ilerleyin.

Admin Console'da oturum açın

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.

Yukarıda belirtildiği gibi, Sign'dan gelen her bildirim isteğinde olan "X-AdobeSign-ClientId" üstbilgisinin (istemci kimliği) değeri yanıt olarak aşağıdaki yollardan biriyle tekrar belirtilmelidir:

1. X-AdobeSign-ClientId HTTP üstbilgisi ve bu istemci kimliğiyle aynı değer

İstemci kimliğini almak, doğrulamak ve ardından yanıt üstbilgisinde geri döndürmek için örnek Javascript kodu
// İstemci kimliğini getirin var clientid = request.headers['X-ADOBESIGN-CLIENTID']; 13.3 Genel //Onaylayın if (clientid ==="BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın { //Yanıt üstbilgisinde geri döndürün response.headers['X-AdobeSign-ClientId'] = clientid; response.status = 200; // varsayılan değer }

İstemci kimliğini almak, doğrulamak ve ardından yanıt üstbilgisinde geri döndürmek için örnek Javascript kodu

// İstemci kimliğini getirin

var clientid = request.headers['X-ADOBESIGN-CLIENTID'];

13.3 Genel

//Onaylayın

if (clientid ==="BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın

{

//Yanıt üstbilgisinde geri döndürün

response.headers['X-AdobeSign-ClientId'] = clientid;

response.status = 200; // varsayılan değer

}

İstemci kimliğini almak, doğrulamak ve ardından yanıt üstbilgisine geri döndürmek için örnek PHP kodu
<?php // İstemci kimliğini getirin $clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID']; //Onaylayın if($clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın { //Yanıt üstbilgisinde geri döndürün header("X-AdobeSign-ClientId:$clientid"); header("HTTP/1.1 200 OK"); // varsayılan değer } ?>

2. xAdobeSignClientId anahtarına ve müşteri kimliğiyle aynı değere sahip JSON yanıt gövdesi

İstemci kimliğini almak, doğrulamak ve yanıt gövdesinde geri döndürmek için örnek Javascript kodu
// İstemci kimliğini getirin var clientid = request.headers['X-ADOBESIGN-CLIENTID']; 13.3 Genel 13.3 Genel //Onaylayın if (clientid ==="BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın { var responseBody = { "xAdobeSignClientId" : clientid // Gövdedeki istemci kimliğini geri döndürün }; response.headers['Content-Type'] = 'application/json'; response.body = responseBody; response.status = 200; }

İstemci kimliğini almak, doğrulamak ve yanıt gövdesinde geri döndürmek için örnek Javascript kodu

// İstemci kimliğini getirin

var clientid = request.headers['X-ADOBESIGN-CLIENTID'];

13.3 Genel

//Onaylayın

if (clientid ==="BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın

{

var responseBody = {

"xAdobeSignClientId" : clientid // Gövdedeki istemci kimliğini geri döndürün

};

response.headers['Content-Type'] = 'application/json';

response.body = responseBody;

response.status = 200;

}

İstemci kimliğini almak, doğrulamak ve yanıt gövdesinde geri döndürmek için örnek PHP kodu
<?php // İstemci kimliğini getirin $clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID']; //Onaylayın if($clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın { //Yanıt gövdesinde geri döndürün header("Content-Type: application/json"); $body = array('xAdobeSignClientId' => $clientid); echo json_encode($body); header("HTTP/1.1 200 OK"); // varsayılan değer } ?>

İstemci kimliğini almak, doğrulamak ve yanıt gövdesinde geri döndürmek için örnek PHP kodu

<?php

// İstemci kimliğini getirin

$clientid = $_SERVER['HTTP_X_ADOBESIGN_CLIENTID'];

//Onaylayın

if($clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın

{

//Yanıt gövdesinde geri döndürün

header("Content-Type: application/json");

$body = array('xAdobeSignClientId' => $clientid);

echo json_encode($body);

header("HTTP/1.1 200 OK"); // varsayılan değer

}

Yanıtın örnek JSON gövdesi
{ "xAdobeSignClientId": "BGBQIIE7H253K6" }

Ön Koşullar

Şunlara ihtiyacınız vardır:

Azure İşlevleri Uygulamaları oluşturma lisansına sahip bir Microsoft hesabı
Mevcut bir Azure İşlevi Uygulaması. https://docs.microsoft.com/tr-tr/azure/azure-functions/functions-create-first-azure-function adresini kullanarak oluşturabilirsiniz
Kodu istediğiniz dilde anlayıp yazabilmeniz için temel Javascript bilgileri

Acrobat Sign web kancası olarak hizmet veren bir Azure İşlevleri Tetikleyicisi oluşturma adımları

Javascript HTTP Tetikleyici işlevi oluşturmak için:

1. Microsoft hesabınız ile oturum açın https://portal.azure.com/

2. İşlev Uygulamaları sekmesi altında gösterilen Azure İşlev Uygulamanızı açın.

Azure İşlev Uygulamaları listeniz açılır:

3. Bu yeni işlevi oluşturmak istediğiniz uygulamayı seçin

4. Yeni bir Azure işlevi oluşturmak için Oluştur (+) düğmesini tıklatın

13.3 Genel

5. Senaryo olarak Web Kancası + API'yi, dil olarak da Javascript'i seçin

6. Bu işlevi oluştur öğesini tıklatın

Gelen bir API isteğini işleme yeteneğine sahip yeni bir işlev oluşturulur.

Acrobat Sign web kancasını kaydetmek için mantık ekleyin

Acrobat Sign, bir web kancasını başarıyla kaydetmeden önce kayıt isteğinde sağlanan web kancası URL'sinin gerçekten 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, X-AdobeSign-ClientId özel HTTP üstbilgisiyle web kancası URL'sine gönderilen bir HTTPS GET isteğidir. Bu üstbilgideki değer, web kancasını oluşturmak/kaydetmek isteyen uygulamanın istemci kimliğine 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 GEREKİR.

İzleyebileceğiniz iki seçenek vardır:

1. Seçenek: X-AdobeSign-ClientId içindeki İstemci Kimliğini yanıt Üstbilgisi olarak iletmek

X-AdobeSign-ClientId'yi yanıt üstbilgisinde iletmek. İstekte iletilen üstbilgi aynıdır ve yanıt olarak tekrar iletilmesi gerekir.

Index.js dosyasını aşağıdakilerle değiştirin:

module.exports = function (context, req) {

var clientId = req.headers['x-adobesign-clientid'];

// Gelen İstemci Kimliğinin orijinal olduğunu doğrulayın

if (clientId === '123XXX456') {

context.res = {

// status: 200, /* Varsayılan=200 */ // tüm 2XX yanıtları kabul edilir

body: "Notification Accepted",

headers : {

'x-adobesign-clientid' : req.headers['x-adobesign-clientid']

}

};

}

else {

context.res = {

status: 400,

body: "Opps!! Illegitimate Call identified"

};

}

context.done();

};

13.3 Genel

İsteği taklit ederek davranışı test edin:

1. En sağ köşedeki Test düğmesini tıklatın

2. Sahte isteği taklit edin

Yanıt üstbilgileri yukarıda gösterilmese de postman/DHC veya başka bir hizmet ile taklit ederek bunu gözlemleyebilirsiniz.

2. Seçenek: İstemci Kimliğini xAdobeSignClientId anahtarıyla yanıt gövdesinde iletin

xAdobeSignClientId anahtarına ve istek üstbilgisinde gönderilen istemci kimliğiyle aynı değere sahip olacak şekilde JSON yanıt gövdesinde.

Index.js dosyasını aşağıdakilerle değiştirin:

module.exports = function (context, req) {

var clientId = req.headers['x-adobesign-clientid'];

// Gelen İstemci Kimliğinin orijinal olduğunu doğrulayın

if (clientId === '123XXX456') {

context.res = {

// status: 200, /* Varsayılan=200 */ // tüm 2XX yanıtları kabul edilir

body: {

'xAdobeSignClientId' : clientId

headers : {

'Content-Type' : 'application/json'

}

};

}

else {

context.res = {

status: 400,

body: "Opps!! Illegitimate Call identified"

};

}

context.done();

};

İsteği taklit ederek davranışı test edin

1. En sağ köşedeki Test düğmesini tıklatın

2. Sahte isteği taklit edin

Ayrıca Web Kancası URL'si POST bildirimleri aldığında istemci kimliği için aynı davranışın beklendiğini unutmayın.

Kullanıma Hazır

Davranışı doğruladıktan sonra web kancası URL'si, Acrobat Sign standartlarına göre çalışır. Özel mantığı ihtiyaçlarınıza göre daha fazla güncelleyebilirsiniz.

İşlev URL'sini alma

İşlev URL'sini al'ı tıklatın

URL'yi kopyalayıp Acrobat Sign'da web kancaları oluşturmak için kullanın.

AWS Lambda İşlevini Oluşturma

AWS Lambda işlevi oluşturmak için AWS Yönetim Konsolunuzda oturum açın ve hizmetler listesinden AWS Lambda hizmetini seçin.

"Sıfırdan İçerik Oluştur"u kullanarak Lambda İşlevi Oluştur seçeneğini tıklatın
İşlevi yapılandır sayfasında "lambdaWebhooks" işlev adını girin ve Çalışma Zamanı olarak Node.js 4.3'ü seçin
Rol için mevcut bir rol seçin veya şablonlardan yeni bir rol oluşturun
- Şablonlardan yeni rol oluştur'u seçtiyseniz bir rol adı girip (ör. lambda rolü) Politika şablonları listesinden Basit Mikro Hizmetler izinleri'ni seçin
İşlev oluştur düğmesini tıklatın

Yeni AWS lambda işlev sayfasında, "Kod girişi türü" olarak "Kod satır içi düzenle" öğesini seçip index.handler seçeneğini İşleyici olarak tutun.
Acrobat Sign Web Kancasını kaydetmek için mantık ekleyin
Acrobat Sign, bir web kancasını başarıyla kaydetmeden önce kayıt isteğinde sağlanan web kancası URL'sinin gerçekten 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, X-AdobeSign-ClientId özel HTTP üstbilgisiyle web kancası URL'sine gönderilen bir HTTPS GET isteğidir. Bu üstbilgideki değer, web kancasını oluşturmak/kaydetmek isteyen uygulamanın istemci kimliğine 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 GEREKİR. Ayrıca Web Kancası URL'si POST bildirimleri aldığında istemci kimliği için aynı davranışın beklendiğini unutmayın.

İki durumdan birini uygulayın:

1. Durum: X-AdobeSign-ClientId içindeki İstemci Kimliğini yanıt Üstbilgisi olarak iletmek
- X-AdobeSign-ClientId'yi yanıt üstbilgisinde iletmek. İstekte iletilen üstbilgi aynıdır ve yanıt olarak tekrar iletilmesi gerekir.
  
  Kod Parçacığı
  index.js dosyasında, otomatik olarak oluşturulan kod parçacığını aşağıdaki kodla değiştirin:

İstemci kimliğini almak, doğrulamak ve ardından yanıt başlığına geri döndürmek için örnek JS kodu
exports.handler = function index(event, context, callback) { // İstemci kimliğini getirin var clientid = event.headers['X-AdobeSign-ClientId']; //Onaylayın if (clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın { var response = { statusCode: 200, headers: { "X-AdobeSign-ClientId": clientid } }; callback(null,response); } else { callback("Oops!! illegitimate call"); } }

İstemci kimliğini almak, doğrulamak ve ardından yanıt başlığına geri döndürmek için örnek JS kodu

exports.handler = function index(event, context, callback) {

// İstemci kimliğini getirin

var clientid = event.headers['X-AdobeSign-ClientId'];

//Onaylayın

if (clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın

{

var response = {

statusCode: 200,

headers: {

"X-AdobeSign-ClientId": clientid

}

};

callback(null,response);

}

else {

callback("Oops!! illegitimate call");

}

2. Durum: İstemci Kimliğini xAdobeSignClientId anahtarıyla yanıt gövdesinde iletin

xAdobeSignClientId anahtarına ve istek üstbilgisinde gönderilen istemci kimliğiyle aynı değere sahip olacak şekilde JSON yanıt gövdesinde.

Kod Parçacığı

Index.js dosyasını aşağıdakilerle değiştirin:

İstemci kimliğini almak, doğrulamak ve ardından yanıt başlığına geri döndürmek için örnek JS kodu
exports.handler = function index(event, context, callback) { // İstemci kimliğini getirin var clientid = event.headers['X-AdobeSign-ClientId']; //Onaylayın if (clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın { var responseBody = { xAdobeSignClientId : clientid }; var response = { statusCode: 200, body: JSON.stringify(responseBody) }; callback(null,response); } else { callback("Opps!! illegitimate call"); } }

İstemci kimliğini almak, doğrulamak ve ardından yanıt başlığına geri döndürmek için örnek JS kodu

exports.handler = function index(event, context, callback) {

// İstemci kimliğini getirin

var clientid = event.headers['X-AdobeSign-ClientId'];

//Onaylayın

if (clientid == "BGBQIIE7H253K6") //"BGBQIIE7H253K6" yerine web kancasının oluşturulduğu uygulamanın istemci kimliğini kullanın

{

var responseBody = {

xAdobeSignClientId : clientid

};

var response = {

statusCode: 200,

body: JSON.stringify(responseBody)

};

callback(null,response);

}

else {

callback("Opps!! illegitimate call");

}

İşlevi kaydedin. Lambda işlevi oluşturulur ve gerçek zamanlı bir web kancasında kullanıma neredeyse hazırız hale geliriz.

AWS API Ağ Geçidini Yapılandırma

Bu Lambda'yı, HTTP yöntemi aracılığıyla herkes tarafından erişilebilir hale getirmek için API'de arka uç olarak işlevimizi (yukarıda oluşturulan) kullanarak AWS API Ağ Geçidini yapılandırmamız gerekir.

AWS Yönetim Konsolu'nda AWS hizmetlerinden API Ağ Geçidi'ni seçip API Oluştur düğmesini tıklatın

Yeni API oluştursayfasında Yeni API'yi seçip API adı olarak web kancaları'nı girin.
API Oluştur düğmesini tıklatın
İşlemler açılır listesini ve Kaynak Oluştur'u seçin
Proxy kaynağı olarak yapılandır seçeneğini işaretleyin, Kaynak Adı olarak doğrula'yı ve Kaynak Yolu'na da {proxy+} ifadesini girin
API Ağ Geçidi CORS'i Etkinleştir seçeneğini işaretlemeden bırakın veKaynak Oluştur düğmesini tıklatın
Entegrasyon türü olarak Lambda İşlevi Proxy'si'ni seçili tutun ve Lambda bölgesi açılır listesinde Lambda işlevinizi oluşturduğunuz bölgeyi seçin (muhtemelen API Ağ Geçidini oluşturduğunuz bölgedir).
Lambda İşlevi olarak doğrula'yı girip Kaydet düğmesini tıklatın.
Lambda İşlevine İzin Ekle açılır penceresinde Tamam'ı seçin

Yukarıdaki tüm adımlar başarıyla gerçekleştirilirse şuna benzer bir şey görürsünüz:

API Dağıtımı

Bir sonraki adım, kullanıma hazır hale getirmek için bu API'yi dağıtmaktır.

İşlemler açılır listesinde API'yi dağıt'ı seçin
Dağıtım aşamasında [Yeni Aşama] seçeneğini işaretleyip Aşama adına üret ifadesini (ya da bu aşamayı tanımlamak istediğiniz herhangi bir şeyi) girin
Dağıt düğmesini tıklatın

API artık kullanıma hazırdır ve aşağıda gösterildiği gibi mavi kutuda çağrı URL'sini bulabilirsiniz:

Gerçek zamanlı web kancası URL'niz olarak girmeniz gerekeceğinden bu URL'yi not edin.

Kullanıma Hazır

İşte bu kadar. Bu yukarıdaki URL'yi, POST /web kancaları API isteğinde web kancası URL'si olarak eklenen "/{nodeJSfunctionName}" ile kullanın. Davranışı doğruladıktan sonra Web Kancası URL'si,
Acrobat Sign standartlarına göre çalışır. Özel mantığı ihtiyaçlarınıza göre ekleyebilir/daha fazla güncelleyebilirsiniz.

Etkinleştirme veya devre dışı bırakma

Web Kancaları özelliğine erişim, işletme düzeyi hesaplar için varsayılan olarak etkindir.

Grup düzeyindeki yöneticiler yalnızca kendi gruplarında çalışan Web Kancalarını oluşturabilir veya kontrol edebilir.

Web Kancaları sayfasına erişim, Yönetici menüsünün sol tarafında bulunabilir.

Eş zamanlı işlem tabanlı hız sınırlaması

Web kancası (ve geri çağırma) oluşturma ve bildirim olayları, Acrobat Sign sisteminden müşteriye etkin bir şekilde gönderilen eş zamanlı bildirimlerin sayısıyla sınırlıdır. Bu sınır, hesap içindeki tüm grupları kapsayacak şekilde hesap için geçerlidir.
Bu hız sınırlama türü, kötü tasarlanmış bir hesabın orantısız miktarda sunucu kaynağı kullanmasını ve dolayısıyla bu sunucu ortamındaki diğer tüm müşterilerin olumsuz etkilenmesini engeller.

Hesap başına düşen eş zamanlı olay sayısı, iyi davranan web kancalarına sahip hesapların bildirimlerini en kısa sürede almasını ve çok fazla istek nedeniyle bildirimlerin geciktiği durumlarla nadiren karşılaşmasını sağlamak için hesaplanmıştır. Mevcut eşikler şunlardır:

Eylem (Olay)	Maksimum eş zamanlı olay	Açıklama
Web kancası oluşturma	10	Hesap başına en fazla 10 eş zamanlı web kancası oluşturma isteğine izin verilir. Bu sınırı aşan istekler 429 TOO_MANY_REQUESTS yanıt kodu ile sonuçlanır.
Web kancası/geri çağırma bildirimi	30	Hesap başına en fazla 30 eş zamanlı web kancası ve geri çağırma bildirimine izin verilir. Bu sınırı aşan bildirimler, teslim edilene kadar üstel geri çekilmeye göre tekrar denenir.

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ı, sözleşmeyi gönderen kişiye ve sözleşmenin gönderildiği grup içinde yapılandırılan tüm web kancalarına bildirim gönderir. Hesap kapsamındaki web kancaları tüm olayları alır.

Gönderen: A Kullanıcısı | İmzalayan: B Kullanıcısı | Paylaşılan: C Kullanıcısı

A Kullanıcısı ve B Kullanıcısı farklı hesaplarda

A Kullanıcısı ve C Kullanıcısı farklı hesaplarda

Kullanım örneği	Bildirim	Yorumlar/Notlar
A Kullanıcısının hesabı HESAP düzeyinde web kancasına sahiptir (A Kullanıcısı veya Hesap Yöneticisi tarafından oluşturulur).	Evet	HESAP düzeyinde bir web kancası, bu hesapta tetiklenen tüm olaylar hakkında bilgilendirilir.
A Kullanıcısının hesabında GRUP düzeyinde web kancası bulunur (A Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: A Kullanıcısı ve Grup Yöneticisi aynı gruptadır.	Evet	GRUP düzeyinde bir web kancası, o grupta tetiklenen tüm olaylar hakkında bilgilendirilir.
A Kullanıcısı KULLANICIdüzeyinde web kancasına sahiptir.	Evet	Gönderen olarak A Kullanıcısı'nın KULLANICI düzeyindeki web kancası tetiklenir.
A Kullanıcısı KAYNAK düzeyinde web kancasına sahiptir (yukarıda gönderilen sözleşme için).	Evet

B Kullanıcısının hesabı HESAP düzeyinde web kancasına sahiptir (B Kullanıcısı veya Hesap Yöneticisi tarafından oluşturulmuştur).	Hayır	B Kullanıcısının HESAP düzeyindeki web kancası, İmzalayan web kancası olarak kabul edilir.
B Kullanıcısının hesabı , GRUP düzeyinde web kancasına sahiptir (B Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: B Kullanıcısı ve Grup Yöneticisi aynı gruptadır.	Hayır	B Kullanıcısının GRUP düzeyindeki web kancası, İmzalayan web kancası olarak kabul edilir.
B Kullanıcısı KULLANICI düzeyinde web kancasına sahiptir.	Hayır	B Kullanıcısının KULLANICI düzeyindeki web kancası, İmzalayan web kancası olarak kabul edilir.

C Kullanıcısının hesabında HESAP düzeyinde web kancası bulunur (C Kullanıcısı veya Hesap Yöneticisi tarafından oluşturulmuştur).	Hayır	C Kullanıcısının HESAP düzeyindeki web kancası, oluşturucu olmayan web kancası olarak kabul edilir.
C Kullanıcısının hesabında GRUP düzeyinde web kancası bulunur (C Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: C Kullanıcısı ve Grup Yöneticisi aynı gruptadır.	Hayır	C Kullanıcısının GRUPdüzeyindeki web kancası, oluşturucu olmayan web kancası olarak kabul edilir.
C Kullanıcısı KULLANICI düzeyinde web kancasına sahiptir.	Hayır	C Kullanıcısının KULLANICI düzeyindeki web kancası, oluşturucu olmayan web kancası olarak kabul edilir.

Gönderen: A Kullanıcısı | İmzalayan: B Kullanıcısı | Paylaşılan: C Kullanıcısı

A Kullanıcısı, B Kullanıcısı ve C Kullanıcısı aynı hesaptadır

Kullanım örneği	Bildirim	Notlar
A Kullanıcısının hesabında HESAP düzeyinde web kancası bulunur (A Kullanıcısı veya Hesap Yöneticisi tarafından oluşturulmuştur).	Evet	HESAP düzeyindeki web kancaları, hesap tarafından tetiklenen olaylar için bildirimde bulunur.
A Kullanıcısının hesabında GRUP düzeyinde web kancası bulunur (A Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: A Kullanıcısı ve Grup Yöneticisi aynı gruptadır.	Evet	GRUP düzeyindeki web kancaları, gruplarındaki kullanıcılar tarafından tetiklenen olaylar için bildirimde bulunur.
A Kullanıcısı KULLANICIdüzeyinde web kancasına sahiptir.	Evet	Gönderen olarak A Kullanıcısı'nın Kullanıcı düzeyindeki web kancası tetiklenir.
A Kullanıcısı KAYNAK düzeyinde web kancasına sahiptir (yukarıda gönderilen sözleşme için).	Evet

B Kullanıcısının hesabı HESAP düzeyinde web kancasına sahiptir (B Kullanıcısı veya Hesap Yöneticisi tarafından oluşturulmuştur).	Evet	A Kullanıcısı ve B Kullanıcısı aynı hesapta olduğundan HESAP düzeyindeki web kancası bu hesapta tetiklenen tüm olaylar hakkında bilgilendirilir.
B Kullanıcısının hesabı , GRUP düzeyinde web kancasına sahiptir (B Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: A Kullanıcısı, B Kullanıcısı ve Grup Yöneticisi aynı gruptadır.	Evet	A Kullanıcısı ve B Kullanıcısı aynı grupta olduğundan GRUP düzeyindeki web kancası o grupta tetiklenen tüm olaylar hakkında bilgilendirilir.
B Kullanıcısının hesabı , GRUP düzeyinde web kancasına sahiptir (B Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: A Kullanıcısı ve B Kullanıcısı farklı gruplardadır.	Hayır	B Kullanıcısının GRUP düzeyindeki web kancası, İmzalayan web kancası olarak kabul edilir. A Kullanıcısının web kancası (KAYNAK/KULLANICI/GRUP/HESAP) tetiklenir.
B Kullanıcısı KULLANICI düzeyinde web kancasına sahiptir.	Hayır	Alıcı olduğundan, B Kullanıcısının KULLANICI düzeyindeki web kancası tetiklenmez.

C Kullanıcısının hesabında HESAP düzeyinde web kancası bulunur (C Kullanıcısı veya Hesap Yöneticisi tarafından oluşturulmuştur).	Evet	A Kullanıcısı ve C Kullanıcısı aynı hesapta olduğundan HESAP düzeyindeki web kancası bu hesapta tetiklenen tüm olaylar hakkında bilgilendirilir.
C Kullanıcısının hesabında GRUP düzeyinde web kancası bulunur (C Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: A Kullanıcısı, C Kullanıcısı ve Grup Yöneticisi aynı gruptadır.	Evet	A Kullanıcısı ve C Kullanıcısı aynı grupta olduğundan GRUP düzeyindeki web kancası o grupta tetiklenen tüm olaylar hakkında bilgilendirilir.
C Kullanıcısının hesabında GRUP düzeyinde web kancası bulunur (C Kullanıcısı veya Hesap/Grup Yöneticisi tarafından oluşturulmuştur). Varsayım: A Kullanıcısı ve C Kullanıcısı farklı gruplardadır.	Hayır	C Kullanıcısının GRUPdüzeyindeki web kancası, oluşturucu olmayan web kancası olarak kabul edilir. A Kullanıcısının web kancası (KAYNAK/KULLANICI/GRUP/HESAP) tetiklenir.
C Kullanıcısı KULLANICI düzeyinde web kancasına sahiptir.	Hayır	C Kullanıcısının KULLANICI düzeyindeki web kancası, oluşturucu olmayan web kancası olarak kabul edilir.

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.

Daha hızlı ve daha kolay yardım alın

Yeni kullanıcı mısınız?

Acrobat Sign Web Kancasına genel bakış

Genel Bakış

Ön koşullar

Nasıl kullanılır?

Web kancası URL'sinin amacını doğrulama

Web kancası bildirimine yanıt verme

1. X-AdobeSign-ClientId HTTP üstbilgisi ve bu istemci kimliğiyle aynı değer

2. xAdobeSignClientId anahtarına ve müşteri kimliğiyle aynı değere sahip JSON yanıt gövdesi

Ön Koşullar

Acrobat Sign web kancası olarak hizmet veren bir Azure İşlevleri Tetikleyicisi oluşturma adımları

Acrobat Sign web kancasını kaydetmek için mantık ekleyin

1. Seçenek: X-AdobeSign-ClientId içindeki İstemci Kimliğini yanıt Üstbilgisi olarak iletmek

2. Seçenek: İstemci Kimliğini xAdobeSignClientId anahtarıyla yanıt gövdesinde iletin

Kullanıma Hazır

AWS Lambda İşlevini Oluşturma

1. Durum: X-AdobeSign-ClientId içindeki İstemci Kimliğini yanıt Üstbilgisi olarak iletmek

2. Durum: İstemci Kimliğini xAdobeSignClientId anahtarıyla yanıt gövdesinde iletin

AWS API Ağ Geçidini Yapılandırma

API Dağıtımı

Kullanıma Hazır

Etkinleştirme veya devre dışı bırakma

Eş zamanlı işlem tabanlı hız sınırlaması

En İyi Uygulamalar

Dikkate alınması gereken noktalar...

JSON boyut sınırlaması

Web kancası bildirimleri

Dinleme hizmeti kapalı olduğunda tekrar deneyin

Daha hızlı ve daha kolay yardım alın

Topluluğa Sorun

Bizimle İletişime Geçin