Tekli oturum açma özelliğini ayarlama

Adobe Sign Belge API, Adobe Sign tarafından yönetilen ayrı bir kayıt işlemi yapmanız gerekmeden mevcut uygulamanıza sorunsuz şekilde entegre edilecek şekilde tasarlanmıştır. Bu nedenle söz konusu uygulama, gönderen kişinin kayıtlı bir Adobe Sign kullanıcısı olmasından sorumludur. Gönderen kayıtlı bir kullanıcı değilse uygulama kişiyi programlı bir şekilde API kanalıyla kaydettirir. Alıcıların kaydolma zorunluluğu yoktur. Alıcı tarafında gerçekleşmesi gereken etkileşimleri her zaman Adobe Sign yönetir.

sendDocument (Belge Gönder) yöntemiyle yeni bir işlem başlatıldığında gönderen kişiyi belirtmenin çeşitli yolları vardır. Davranış, isteğe bağlı SenderInfo (Gönderen Bilgileri) parametresinden hangi değerlerin geçtiğine bağlıdır.

• Boş SenderInfo: Bu durumda, belgeyi gönderen kişi kullanılan API Anahtarıyla ilişkili tek kullanıcıdır. Bu yöntemin testlerde ve kapsamı sınırlı olan belirli uygulamalarda kullanılması uygundur; ancak, mevcut kullanıcı kümeleri olan büyük ölçekli entegrasyonlarda genelde kullanışlı değildir.

• E-posta ve parola içeren SenderInfo: Bu durumda, belgeyi gönderen kişi e-posta parametresinin belirttiği kullanıcıdır. Verilen parolanın kullanıcının Adobe Sign parolasıyla eşleşmesi gereklidir. Entegrasyon amaçları doğrultusunda, belge gönderilmek üzereyken söz konusu uygulama bağlamında kullanıcıdan e-posta ve parola talep edilebilir. Alternatif olarak, söz konusu uygulama, kullanıcıyı kendisi oluşturduğu veya kullanıcı bu bilgileri daha önceden verdiği ve bilgiler önbelleğe alındığı için e-posta ve parolayı hatırlayabilir.

• E-posta içeren ve parola içermeyen SenderInfo: Bu durumda, belgeyi gönderen kişi e-posta parametresinin belirttiği kullanıcıdır. Parola değeri boş (null) olmalıdır. Adobe Sign, API çağırıcısı ve hedeflenen gönderenin aynı hesabın sahibi olduğunu doğrular; fakat parola istemez veya parolayı kontrol etmez. Bu yöntem, kimi zaman belirli bir kuruluş içindeki API entegrasyonları için uygundur; fakat bireysel güvenlik düzeyi düşüktür. Bu kimlik doğrulama yönteminin Adobe Sign API ile kullanılabilmesi için yöntemin ana hesap sahibi tarafından özel olarak talep edilmesi gereklidir.

Yukarıda da belirtildiği gibi, çoğu durumda adına belge gönderdiğiniz kullanıcının e-posta adresi ve parolasını istersiniz. Aşağıdaki bölümde, bu bilgilerin alınabileceği farklı yollar açıklanmaktadır.

Gönderme prosedürünün bir parçası olarak, kullanıcıdan Adobe Sign e-postası ve parolasını isteyebilirsiniz. Kullanıcının Adobe Sign kaydı olup olmadığını ve parolanın geçerliliğini kontrol etmek için verifyUser (Kullanıcıyı Doğrula) yöntemini kullanabilirsiniz. Kullanıcı kayıtlı değilse Adobe Sign hesabını oluşturmasını isteyebilir veya kullanıcı adına siz bir hesap oluşturabilirsiniz (aşağıdaki bölüme bakın).

verifyUser çağrısı, bu e-posta adresine sahip bir kullanıcı olmadığını gösteriyorsa createUser yöntemini çağırarak bir Adobe Sign kullanıcısı oluşturabilirsiniz. Kullanıcı oluşturma işleminin başarılı olduğunu varsayarsak verdiğiniz e-posta ve parola belgenizin SenderInfo değeri olarak kullanılabilir.

Yukarıda belirtilen durumların ardından kullanıcının e-posta adresi ve parolasını hatırlayabilir ve daha sonra kullanıcı adına belge gönderirken bu bilgileri SenderInfo parametresi olarak kullanabilirsiniz. Kullanıcının dilediği zaman Adobe Sign hesabında oturum açarak parolasını değiştirmesi mümkündür. Bu nedenle, uygulamanızın daha önce kaydedilen parolanın geçersiz kalma durumu için hazırlıklı olması gerekir.

Adobe Sign Belge API kullanırken gönderenin kimliğini belirlemenin çeşitli yolları vardır. Uygulamanıza en uygun yöntemi seçmek için yukarıdaki bilgileri dikkatle okuyun. Sorularınız için lütfen bize ulaşın.