SSO kimlik doğrulaması

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

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

Neden SSO kullanmalısınız

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

uyarı

Özel Oylama Panoları SSO gerektirir. Widget, içerik göstermeden ö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 Fikirler göndermek veya oy vermek için ayrı giriş yapmasına gerek yoktur. Tek tıkla ürün güncellemelerinize abone olabilirler.

Güvenlik: Kimlik Doğrulama, konuşmaları özel tutar ve kimliğe bürünmeyi önler. Tüm Ducalis müşterilerinin Kimlik Doğrulamayı etkinleştirmesini şiddetle öneriyoruz.

Widget kodunu alın

1. Oylama Panosu Settings (Ayarlar) bölümüne gidin.

   

2. 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", // Required
    boardId: "_YOUR_BOARD_ID", // Required
    user: {
     // required
     email: "Your user Email",
     hash: "User hash",
     // optional
     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 (zorunlu): Ürününüzde kayıtlı kullanıcının e-postası. Kullanıcılar, değişiklik günlüğüne veya Oylama Panosu güncellemelerine çift katılım onayıyla açıkça abone olmalıdır. E-posta yalnızca panonuzdaki Ducalis takım arkadaşlarınıza görünür.

hash (zorunlu): Kimlik güvenlik doğrulaması. Aşağıda 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 kimliği.

name (isteğe bağlı): Ürününüzdeki kullanıcının adı. Oy veren ve Fikir yazarı olarak görüntülenir. Yalnızca panonuzdaki Ducalis takım arkadaşlarınıza görünür.

avatar (isteğe bağlı): Ürününüzdeki kullanıcının 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üzde gruplandırılmış hesaplar varsa organizasyon adı. Oylama Panosu isteklerini organizasyona göre gruplandırılmış olarak 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ıza olanak tanır.

Özel alanlar ekleyin

Her Oy Veren için satışlar, ARR veya pazar segmenti gibi ek bilgileri yakalamak 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'de bu verilere göre segmentlere ayırın ve kullanıcı geri bildirim modellerini daha derinlemesine analiz edin.

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", // Required
    boardId: "_YOUR_BOARD_ID", // Required
    user: {
     // required
     email: "Your user Email",
     hash: "User hash",
     // optional
     userID: "Your user ID",
     name: "Your user Name",
     avatar: "https://you-user-avatar-domain/avatar.png",
     company: {
          id: 123, // Required
          name: "My Super Client", // Required
            customFields: {
            prop1: "Active",
            prop2: 1.8
          }
     }
    },
  });
</script>

company.id, company.name (zorunlu): Özel bağlam verileri aktarırken zorunlu 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 aktarın. 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.

1. Uygulamanızın gizli anahtarını global organizasyon ayarlarında bulun:

   

2. Kullanıcı hash oluşturma işlemini https://www.freeformatter.com/hmac-generator.html adresinden kontrol edin

Hash oluşturma örnekleri

Node.js:

const crypto = require("crypto");

// Put your secret key here (keep it private!)
// Notice: the one below is an example, yours will be different
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 domain'inizi kullanın

Varsayılan olarak, Oylama Panonuz hi.ducalis.io domain'inde bulunur, örneğin https://feedback.ducalis.io/Ducalis-roadmap/summary.

uyarı

Modern tarayıcılar çapraz domain çerezlerini engelleyerek özel bir domain 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 seviye domain'e yerleştirin. Bu, kullanıcıların hem widget hem de Oylama Panosu içinde tanımlanmış kalmasını sağlar.

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

Çapraz domain kimlik doğrulama örneği

Domain'iniz superproduct.com. Ürününüz app.superproduct.com adresinde çalışıyor, pazarlama sayfaları superproduct.com adresinde ve yardım merkezi help.superproduct.com adresinde. Ducalis Oylama Panonuzu aynı domain'e bağlayın, örneğin voting.superproduct.com.

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

İlgili makaleler

• Oylama Panosu gizliliği
• Oylama Panoları için özel domain kurulumu
• Widget gömme