Power Virtual Agents botuna son kullanıcı kimlik doğrulaması ekleme

Burada kullandığınız Power Virtual Agents sürümünü seçin:

Kullanıcı kimlik doğrulamasını doğrudan Power Virtual Agents bot konuşması içinden etkinleştirebilirsiniz. Kullanıcı kimlik doğrulaması ad ve kimlik gibi kullanıcı temel özelliklerini bot değişkenlerinde almanızı sağlar. Ayrıca kullanıcıdan kimlik doğrulama düğümünü kullanarak oturum açmasını istemenizi, ilgili kullanıcı için kullanıcı belirtecini almanızı ve ardından bu belirteci kullanarak arka uç sisteminden kullanıcı bilgilerini almanızı sağlar.

Ayrıca kullanıcılarınızın el ile oturum açmasına gerek olmaması için çoklu oturum açma (SSO) özelliğini de yapılandırabilirsiniz.

Önemli

Bu özelliği kullanmadan önce son kullanıcı kimlik doğrulaması yapılandırma yönergelerini izlemeniz gerekir.

Ön koşullar

Kimlik doğrulama değişkenleri

Bot hesabınız "Yalnızca Teams için" veya "El ile" kimlik doğrulaması seçenekleriyle yapılandırıldıysa konularınız için kullanılabilir kimlik doğrulama değişkenleri kümesi olacaktır. Botunuzda kimlik doğrulaması yapılandırma hakkında daha fazla bilgi için kimlik doğrulama yapılandırması belgelerine bakın.

Aşağıdaki tabloda kimlik doğrulaması yapılandırma seçeneğine göre doğrulama değişkeni kullanılabilirliği karşılaştırılmıştır:

Kimlik Doğrulama Değişkeni Kimlik Doğrulaması Yok Yalnızca Teams için Manual
UserDisplayName ✔️ ✔️
UserID ✔️ ✔️
IsLoggedIn ✔️
AuthToken ✔️

UserDisplayName değişkeni

UserDisplayName değişkeni, kimlik sağlayıcısında depolanan kullanıcı görünen adını içerir. Son kullanıcı bota açıkça belirtmeden önce kullanıcıyı karşılamak veya kullanıcıdan bahsetmek için bunu kullanarak botunuzu daha fazla kişiselleştirebilirsiniz.

Bu alan değeri Azure Active Directory (Azure AD) name talebinden alınır. OAuth sağlayıcıları için bu, name talebinde depolanan değerdir. Power Virtual Agents, bu alanı otomatik olarak değişkene ayıklar. Bu nedenle kimlik doğrulama kapsamı kurulumunda profile öğesinin bulunduğundan emin olun.

UserID değişkeni

UserID değişkeni, kimlik sağlayıcısında depolanan kullanıcı kimliğini içerir. Power Automate akışları değer olarak UserID'yi alan API'leri çağırmak için bu değeri kullanabilir. Bu alan değeri Azure AD sub talebinden elde edilir. OAuth sağlayıcıları için bu, sub talebinde depolanan değerdir. Power Virtual Agents, bu alanı otomatik olarak değişkene ayıklar.

Uyarı

UserDisplayName ve UserID değişkenlerin doldurulacağı garanti edilmez ve kimlik sağlayıcısındaki kullanıcı yapılandırmasına bağlı olarak boş dizeler olabilir. Bu değişkenler boş olsa da, konularınızın düzgün çalıştığından emin olmak için kimlik sağlayıcınızdan gelen bir kullanıcıyla test edin.

IsLoggedIn değişkeni

IsLoggedIn değişkeni, kullanıcının oturum açıp açmadığını (oturum açma başarılı yolu olarak da bilinir) veya oturum açmaması (oturum açma başarısızlık yolu ile sonuçlanmasına yol açar) belirtir.

IsLoggedIn, kullanıcının oturum açma durumunu içeren boole türü bir değişkendir. Konunuzda (örneğin, Kimliği Doğrula düğümü eklemenin parçası olarak zaten sağlanan şablonda) başarılı oturum açmayı denetleyen dallanma mantığı oluşturmak veya yalnızca kullanıcının oturum açması durumunda, gerektiğinde kullanıcı bilgilerini getirmek için bu değişkeni kullanabilirsiniz.

AuthToken değişkeni

AuthToken değişkeni, kullanıcı oturum açtıktan sonra alınan kullanıcı belirtecini içerir. Arka uç API'lerine bağlanabilecekleri ve kullanıcının bilgilerini getirebilecekleri şekilde veya kullanıcı adına eylem uygulamak için bu değişkeni Power Automate akışlarına geçirebilirsiniz.

Uyarı

AuthToken değişkenini yalnızca güvenilir kaynaklara geçirdiğinizden emin olun. Bu, güvenliği aşılırsa kullanıcıya zarar verebilecek şekilde kullanıcı kimlik doğrulaması bilgilerini içerir.

AuthToken öğesini İleti düğümlerinde veya güvenmediğiniz akışlarda kullanmayın.

"Yalnızca Teams için" yapılandırması kullanılırken kimlik doğrulaması

Kimlik doğrulama seçeneğiniz Yalnızca Teams için olarak ayarlanmışsa konularınıza açıkça kimlik doğrulaması eklemeniz gerekmez. Bu yapılandırmada, Microsoft Teams'deki tüm kullanıcılar otomatik olarak Teams kimlik bilgileriyle oturum açar ve kimlik doğrulaması kartıyla açıkça oturum açmalarına gerek yoktur. Kimlik doğrulama seçeneğiniz El ile olarak ayarlanmışsa kimlik doğrulama düğümünü (Teams kanalı da dahil) eklemeniz gerekir.

Not

Kimlik doğrulama seçeneğiniz "Yalnızca Teams için" olarak ayarlanmışsa konularınıza açıkça kimlik doğrulaması ekleme seçeneği sunulmaz.

Konuya kullanıcı kimlik doğrulaması ekleme

Kimlik doğrulaması düğüm şablonunu ekleyin:

  1. Düzenlemek istediğiniz botun Konu sayfası'na gidin.

  2. Kimlik doğrulaması şablonu eklemek istediğiniz konu için Yazma tuvali'ni açın.

  3. İleti düğümü eklemek için artı (+) simgesini seçin. Bir oturum açma deneyiminin gerçekleşmek üzere olduğunu belirtmek için botun söylemesi gerekenleri girin.

    Düğüm ekleme işleminin ekran görüntüsü

  4. İleti düğümünün altında, artı (+) simgesini ve sonra da bir eylem yap ' ı seçin ve sonra Doğrula'yı seçin.

    Kimliği Doğrula'yı seçme

  5. Seçildikten sonra bir dizi yeni düğüm otomatik olarak eklenir. Bu düğümler üst Kimlik doğrulaması düğümü içerir ve bunu başarı ve başarısızlık yolu için olan düğümler takip eder.

    Yeni düğümler

    Not

    Kimlik doğrulaması düğümü yalnızca bir iletişim kutusu ağacının sonundaki eylem seçicisinden kullanılabilir (yaprak düğüm olarak). Bu, bir iletişimin ortasına eklenemez. Eklendikten sonra, altına başka düğümler eklenebilir.

Kimliği Doğrula düğümü

Kimliği Doğrula düğümünde kullanıcıdan, henüz oturum açmamışsa oturum açma kartı istenir.

Oturum açma isteği

Kullanıcı istemde (kimlik sağlayıcısı tarafından barındırılan) kullanıcı adını ve parolasını girdiğinde kanala bağlı olarak kullanıcıdan doğrulama kodu girmesi istenebilir. Microsoft Teams gibi bazı kanallar, kullanıcının doğrulama kodu girmesini gerektirmez.

Botunuzda SSO yapılandırılmışsa kullanıcıdan oturum açma istenmeyeceğini unutmayın.

Kullanıcılar başka bir oturum açma kartıyla karşılaşsa bile konuşma sırasında yalnızca bir kez oturum açmaları istenir.

Kimliği Doğrula düğümü olmadan AuthToken kullanımı

IsLoggedIn ve AuthToken değişkenleri, Eylem çağır menü girişi tarafından sağlanan şablonu kullanmasanız bile kullanılabilir. İlk olarak kullanıcı Kimliği Doğrulama düğümünden geçmeden AuthToken değişkenini geçirirseniz bu adımda kullanıcıdan oturum açması istenir.

Kullanıcıyı her zaman oturum açmasını bekliyorsanız veya Kullanıcı farklı bir konu yeniden yönlendiriliyorsa, AuthToken değişken geçirilmesi yararlı olabilir. Kullanıcının oturum açamadığı servis taleplerini işlemek için Eylem çağır girişi tarafından sağlanan şablonu kullanmanızı öneririz.

Not

Konuşmanın ortasında oturumu kapatması durumunda konuda AuthToken değişkenini kullanan düğüme geldiğinde kullanıcıdan yeniden oturum açması istenir.

Başarı yolu

Başarı yolu, kullanıcı başarılı şekilde oturum açtığında (veya zaten oturum açtıysa) IsLoggedIn = True ve hesapları gösterir.

AuthToken değişkenini (örneğin, bir kullanıcının bilgilerini almak üzere akış kullanarak bir arka uç sistemine bağlanmak için) kullanan mantığa sahipseniz bu yoldan gidilmesi gerekir.

Hata yolu

Hata yolu, IsLoggedIn = True dışındaki tüm koşulları gösterir. Çoğu durumda hata yolu, Kullanıcı oturum açamadığından, yanlış parola kullanmış veya oturum açma deneyimini iptal ettiğinden oluşur.

Bu servis talebine değerlendirmek isteyebileceğiniz mantığa ekleyin. Örneğin, yeniden deneme veya canlı temsilciye görev aktarma seçenekleri sağladık. Özel senaryonuz ve kullanımınız için başarısızlık yolu eylemlerini özelleştirin.

Konunuzu test etme

kimlik sağlayıcınızın içinde yapılandırılan gerçek bir kullanıcıyı kullanarak konu sınadığınıza emin olun. Oturum açma başarı ve hata yollarının gösterildiğinden emin olun, böylece kullanıcınız oturum açamazsa veya kimlik sağlayıcının oturum açma deneyimi ile ilgili hata oluştuğunda sürprizle karşılaşmaz.