SSO kimlik doğrulaması

Single Sign-On (SSO), kullanıcılarınızı Ducalis Oylama Panonuzda önceden yetkilendirir ve ayrı giriş sürecini ortadan kaldırır. Her Fikri kimin gönderdiğini tam olarak bilirsiniz.

👀 Canlı demo: Ducalis sistemine giriş yapın, ardından https://feedback.ducalis.io/Ducalis-roadmap/summary adresini ziyaret edin. Aynı giriş bilgileriniz, e-posta, ad, avatar ve şirket adınızın otomatik olarak uygulandığını göreceksiniz.

SSO neden kullanılır

Kullanıcılarınızı tanımlayın: Her Fikri kimin gönderdiğini anlamak, geri bildirim için temel bağlam sağlar. SSO, hangi kullanıcıların hangi geri bildirimi sağladığını tam olarak bilmenizi sağlar.

uyarı

Gizli Oylama Panoları SSO gerektirir. Widget, herhangi bir içerik görüntülemeden önce her kullanıcının kimliğini ve izinlerini doğrular. SSO olmadan widget hiç kimse için yüklenmez.

Sorunsuz deneyim: Kullanıcıların Fikir göndermek veya oy vermek için ayrı giriş yapması gerekmez. Ürün değişiklik günlüğünüze tek tıklamayla abone olabilirler.

Güvenlik: Kimlik Doğrulama, konuşmaları gizli tutar ve kimliğe bürünme saldırılarını önler. Tüm Ducalis müşterilerine Kimlik Doğrulamayı etkinleştirmelerini önemle tavsiye ediyoruz.

Oylama Panosu Settings (Ayarlar) bölümüne gidin.
Embed (Göm) seçeneğini seçin ve talimatları izleyin.

Kimlik doğrulama parametrelerini yapılandırın

Widget kodunuzu user parametreleriyle genişletin:

<script>
  !function(b,c,f,d,a,e){b.dclsPxl||(((d=b.dclsPxl=function(){d.callMethod?d.callMethod.apply(d,arguments):d.queue.push(arguments)}).push=d).queue=[],(a=c.createElement("script")).async=!0,a.src=f,(e=c.getElementsByTagName("script")[0]).parentNode.insertBefore(a,e))}(window,document,"https://hi.ducalis.io/js/widget.js")
  dclsPxl("initWidget", {
    appId: "_YOUR_APP_ID", // Gerekli
    boardId: "_YOUR_BOARD_ID", // Gerekli
    user: {
     // gerekli
     email: "Your user Email",
     hash: "User hash",
     // isteğe bağlı
     userID: "Your user ID",
     name: "Your user Name",
     avatar: "https://you-user-avatar-domain/avatar.png",
     company: "Your user Company name",
    },
  });
</script>

Kullanıcı parametreleri

email (gerekli): Kullanıcının ürününüzde kayıtlı e-postası. Kullanıcıların çift katılım ile değişiklik günlüğü veya Oylama Panosu güncellemelerine açıkça abone olması gerekir. E-posta, yalnızca panonuzun içindeki Ducalis ekip arkadaşlarınız tarafından görülebilir.

hash (gerekli): Kimlik güvenliği doğrulaması. Aşağıdaki Kullanıcı hash'i oluşturma bölümüne bakın.

userID (isteğe bağlı): Ürününüzün giriş yapmış kullanıcı için benzersiz tanımlayıcısı.

name (isteğe bağlı): Kullanıcının ürününüzdeki adı. Oy veren ve Fikir yazarı olarak görüntülenir. Yalnızca panonuzun içindeki Ducalis ekip arkadaşlarınız tarafından görülebilir.

avatar (isteğe bağlı): Kullanıcının ürününüzdeki avatarı. Geri bildirimi değerlendirirken panonuzda görüntülenir. Kimin oy verdiğini ve ne için oy verdiğini netleştirir.

company (isteğe bağlı): Ürününüzün gruplandırılmış hesapları varsa organizasyon adı. Oylama Panosu isteklerini organizasyona göre gruplandırılmış şekilde görüntülemek için önerilir.

Bireysel müşteri geri bildirimi için

Geri bildiriminiz öncelikle şirketlerden ziyade bireysel kullanıcılardan geliyorsa, company parametresi için kullanıcının verilerini kullanın (örneğin, kullanıcının adı veya e-postası). Bu, şirketin kullanıcı adına eşit olduğu şirket düzeyinde verilerle çalışmanızı sağlar.

Özel alanlar ekleyin

Satışlar, ARR veya pazar segmenti gibi ek bilgileri yakalamak için her Oy Veren için özel bağlam verileri ekleyin. Geri bildirim, şirket büyüklüğüne, pazara veya müşteri yaşına göre farklılık gösterebilir.

Ducalis sisteminde, kullanıcı geri bildirim kalıplarını daha derinlemesine analiz etmek için bu verilere göre segmentlere ayırın.

Widget kodunuzu company parametreleriyle genişletin:

<script>
  !function(b,c,f,d,a,e){b.dclsPxl||(((d=b.dclsPxl=function(){d.callMethod?d.callMethod.apply(d,arguments):d.queue.push(arguments)}).push=d).queue=[],(a=c.createElement("script")).async=!0,a.src=f,(e=c.getElementsByTagName("script")[0]).parentNode.insertBefore(a,e))}(window,document,"https://hi.ducalis.io/js/widget.js")
  dclsPxl("initWidget", {
    appId: "_YOUR_APP_ID", // Gerekli
    boardId: "_YOUR_BOARD_ID", // Gerekli
    user: {
     // gerekli
     email: "Your user Email",
     hash: "User hash",
     // isteğe bağlı
     userID: "Your user ID",
     name: "Your user Name",
     avatar: "https://you-user-avatar-domain/avatar.png",
     company: {
          id: 123, // Gerekli
          name: "My Super Client", // Gerekli
            customFields: {
            prop1: "Active",
            prop2: 1.8
          }
     }
    },
  });
</script>

company.id, company.name (gerekli): Özel bağlam verileri geçerken gerekli alanlar.

customFields: İstediğiniz sayıda özel özellik ekleyin. Örneğin, status: "Active" veya arr: 50000.

Kullanıcı hash'i oluşturma

Kullanıcılarınızın Ducalis Oylama Panosunda hemen Fikirler için oy vermesine veya oluşturmasına izin vermek için verilerini widget'a iletin. Ducalis, kullanıcının sitenizden geldiğini kullanıcı verileriyle birlikte hash anahtarını kontrol ederek doğrular.

Hash, SHA-256 ile HMAC algoritması kullanılarak oluşturulur. Değer olarak kullanıcının e-postasını ve anahtar olarak organizasyonunuzun gizli anahtarını kullanın.

Uygulamanızın gizli anahtarını global organizasyon ayarlarında bulun:
Kullanıcı hash'i oluşturmayı https://www.freeformatter.com/hmac-generator.html adresinde kontrol edin

Hash oluşturma örnekleri

Node.js:

const crypto = require("crypto");

// Gizli anahtarınızı buraya koyun (gizli tutun!)
// Dikkat: aşağıdaki örnek bir örnektir, sizinki farklı olacaktır
const secretKey = "0fd72e0ff53b274293029fd1f3f40c92123123123easf2edq312edwe";
var email = "user@gmail.com";
var hash = crypto.createHmac("sha256", secretKey).update(email).digest("hex");

console.log("hash is:", hash);

PHP:

$secret = '0fd72e0ff53b274293029fd1f3f40c92123123123easf2edq312edwe';
$email = 'user@gmail.com';
$hash = hash_hmac('sha256', $email, $secret);

echo 'Hash is: '. $hash;

Kendi alan adınızı kullanın

Varsayılan olarak, Oylama Panonuz https://feedback.ducalis.io/Ducalis-roadmap/summary gibi hi.ducalis.io alan adında bulunur.

uyarı

Modern tarayıcılar, alan adları arası çerezleri engeller ve bu da özel bir alan adı olmadan kullanıcı tanımlamayı imkansız hale getirir.

Sorunsuz bir Oylama Panosu deneyimi için, Oylama Panonuzu ürününüz ve widget'ları gömdüğünüz sayfalarla aynı ikinci düzey alan adına yerleştirin. Bu, kullanıcıların hem widget'ta hem de Oylama Panosunda tanımlanmış kalmasını sağlar.

Oylama Panosu adresinizi ideas.yourcompanyname.com gibi yapılandırmak için Oylama Panoları için özel alan adı ayarlama bölümüne bakın.

Alan adları arası kimlik doğrulama örneği

Alan adınız superproduct.com. Ürününüz app.superproduct.com adresinde çalışıyor, pazarlama sayfalarınız superproduct.com adresinde ve yardım merkeziniz help.superproduct.com adresinde. Ducalis Oylama Panonuzu voting.superproduct.com gibi aynı alan adına bağlayın.

Ancak o zaman tüm kullanıcılarınız hem widget'ta hem de Oylama Panosunda aynı kimlik bilgileriyle tanımlanacaktır.

SSO neden kullanılır​

Widget kodunu alın​

Kimlik doğrulama parametrelerini yapılandırın​

Kullanıcı parametreleri​

Bireysel müşteri geri bildirimi için​

Özel alanlar ekleyin​

Kullanıcı hash'i oluşturma​

Hash oluşturma örnekleri​

Kendi alan adınızı kullanın​

Alan adları arası kimlik doğrulama örneği​

İlgili makaleler​