Konulara kullanıcı kimlik doğrulaması ekleme

Kullanıcı kimlik doğrulamasını doğrudan aracı konuşması içinden etkinleştirebilirsiniz. Kullanıcının adı ve kimliği gibi temel özelliklerini değişkenlere atayabilirsiniz. Ayrıca, bir konudaki kimlik doğrulama düğümünü kullanarak bir kullanıcıdan oturum açmasını isteyebilirsiniz; bu, bir kullanıcı belirtecini alır ve ardından bu belirteci kullanarak arka uç sisteminden kullanıcının bilgilerini alabilirsiniz.

Uyarı

Copilot Studio'da ve Microsoft Teams'de oluşturulan aracılar otomatik olarak Microsoft Entra ID kimlik doğrulaması için yapılandırılır.

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. Daha fazla bilgi için bkz. Microsoft Entra ID ile çoklu oturum açmayı yapılandırma.

Önkoşullar

• Değişkenlere genel bakış
• Copilot Studio'da kullanıcı kimlik doğrulamayı yapılandırın

Web uygulaması

Müşterilerinizin doğrudan konuşma içinde oturum açmasına izin vermek için konuya kimlik doğrulaması ekleyin. Kullanıcı değişkenleri ile konuşmayı kişiselleştirebilir ve kullanıcı adına arka uç sistemlerine erişmek için bu değişkenleri kullanabilirsiniz.

Microsoft Entra ID ile el ile kimlik doğrulamayı yapılandırma

Konularınızda kimlik doğrulamasını kullanabilmeniz için önce Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırmanız gerekir.

Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma başlığı altında yer alan yönergeleri izleyin.

Kullanıcı kimlik doğrulaması eklemek için "Oturum Açma Sistemi" konusunu kullanın

Aracı oluşturduğunuzda, Copilot Studio otomatik olarak Sign in adlı bir sistem başlığı ekler. Bunu kullanmak için, aracının kimlik doğrulamasını manuel olarak ayarlamanız ve kullanıcıların oturum açmasını zorunlu kılmanız gerekir. Müşteri aracıyla konuşmaya başladığında Oturum aç konusu tetiklenir ve kullanıcıdan oturum açması istenir. Oturum aç konusunu aracınıza uygun şekilde özelleştirebilirsiniz.

Önemli

Sign in konusunun yalnızca Copilot Studio tarafından sağlanan kimlik doğrulama yöntemini sağlamak için kullanılmasını öneririz. Başka eylemleri, akışları veya kimlik doğrulama yöntemlerini çağırmak amacıyla değiştirilmemelidir.

1. Aracınızı Copilot Studio'da açın, sayfanın üst kısmındaki Settings seçin ve ardından Güvenlik'i seçin.
2. Kimlik doğrulaması'nı seçin.
3. El ile Kimlik Doğrulaması'nı ve ardından Kullanıcıların oturum açmasını iste'yi seçin.
4. Tüm el ile kimlik doğrulama alanlarını gerektiği şekilde yapılandırın.
5. Kaydetseçeneğini seçin.

Özel konuyla kullanıcı kimlik doğrulaması ekleme

Oturum aç konusu konuşmanın başında kullanıcının kimlik doğrulamasını yapar. Kullanıcının daha sonra oturum açmasına izin vermek için, herhangi bir özel konu için bir Kimlik doğrulama düğümü ekleyebilirsiniz.

Müşteriler kullanıcı adı ve parolalarını girdiği zaman, bir doğrulama kodu girmeleri istenebilir. Oturum açtıktan sonra, başka bir Kimlik Doğrulama düğümüne ulaşsalar bile kimlik doğrulama tekrar istenmez.

1. Sayfanın üst kısmındaki Ayarlar'ı ve ardından Güvenlik öğesini seçin.

2. Kimlik Doğrulaması kutucuğunu seçin.

   Uyarı

   Özel konuya kullanıcı kimlik doğrulaması eklemek için El ile kimlik doğrulaması'nı seçmeniz gerekir.

3. El ile kimlik doğrulaması yapın'ı seçin ve Kullanıcıların oturum açmasını gerektir onay kutusunu temizleyin.

4. Tüm el ile kimlik doğrulama alanlarını gerektiği şekilde yapılandırın.

5. Kaydetseçeneğini seçin.

6. Sayfanın üst kısmında Konular'ı seçin.

7. Düğüm ekle ( ) >Gelişmiş>Kimlik Doğrulama'yı seçin.

8. Kimlik sağlayıcınızda yapılandırılan bir kullanıcıyı kullanarak konunuzu test edin.

Tip

Başarılı ve başarısız oturum açma senaryoları için yollar oluşturmanız önemlidir. Kimlik sağlayıcısının oturum açma deneyimindeki hatalar da dahil olmak üzere birçok nedenden dolayı oturum açma başarısız olabilir.

Kimlik doğrulama değişkenleri

Yardımcı programınızda kullanıcı kimlik doğrulamasını yapılandırdığınızda, konularınız içinde kimlik doğrulama değişkenlerini uygulayabilirsiniz. Aşağıdaki tabloda, kimlik doğrulaması seçeneğine göre bu değişkenlerin kullanılabilirliği karşılaştırılmaktadır.

Değişkenler hakkında daha fazla bilgi için Değişkenlere genel bakış bölümüne bakın.

Kimlik doğrulama değişkeni	Kimlik doğrulaması yok	Microsoft ile kimlik doğrulaması yap	El ile kimlik doğrulaması yap
User.DisplayName	Mevcut değil	Mevcut	Mevcut
Kullanıcı.Adı	Mevcut değil	Mevcut	Mevcut
Kullanıcı.Soyadı	Mevcut değil	Mevcut	Mevcut
Kullanıcı.PrincipalName	Mevcut değil	Mevcut	Mevcut
Kullanıcı.E-posta	Mevcut değil	Mevcut	Mevcut
User.Id	Mevcut değil	Mevcut	Mevcut
User.IsLoggedIn	Mevcut değil	Mevcut	Mevcut
User.AccessToken	Mevcut değil	Mevcut değil	Mevcut
SignInReason	Mevcut değil	Mevcut	Mevcut

User.DisplayName

Uyarı

Bu değişkenin değer içerme garantisi yoktur. Konunuzun düzgün çalıştığından emin olmak için kimlik sağlayıcınızdan gelen bir kullanıcıyla test edin.

User.DisplayName değişkeni, kimlik sağlayıcısında depolanan görünen adını içerir. Bu değişkeni kullanarak, kullanıcının adını açıkça vermesine gerek kalmadan kullanıcıyı selamlayabilir veya ona atıfta bulunabilirsiniz, böylece sohbet daha kişiselleştirilmiş hale gelir.

Copilot Studio, kimlik sağlayıcısı tarafından sağlanan User.DisplayName talebinden name değerini, el ile kimlik doğrulaması yapılandırıldığında profile kapsamı tanımlanmışsa, otomatik olarak ayarlar. Kapsam hakkında daha fazla bilgi için bkz. Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma.

User.Id

Uyarı

Bu değişkenin değer içerme garantisi yoktur. Konunuzun düzgün çalıştığından emin olmak için kimlik sağlayıcınızdan gelen bir kullanıcıyla test edin.

User.Id değişkeni, kimlik sağlayıcısında depolanan kullanıcı kimliğini içerir. UserID değerini değer olarak alan API'leri çağırmak için bu değişkeni Power Automate flows içinde kullanın.

Copilot Studio, kimlik sağlayıcısı tarafından sağlanan User.DisplayName talepten sub değerini otomatik olarak ayarlar.

User.IsLoggedIn

User.IsLoggedIn, kullanıcının oturum açma durumunu depolayan bir Boole değişkenidir. true değeri, kullanıcının oturum açtığını belirtir. Konunuzda başarılı bir oturum açmayı kontrol eden dallanma mantığı oluşturmak veya yalnızca kullanıcının oturum açmış olması durumunda kullanıcı bilgilerini getirmek için bu değişkeni kullanabilirsiniz.

User.AccessToken

Uyarı

User.AccessToken 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.

User.AccessToken değişkeni, kullanıcı oturum açtıktan sonra alınan kullanıcı belirtecini içerir. Bu değişkeni Power Automate akışlarına geçirerek arka uç API'lerine bağlanabilir ve kullanıcı bilgilerini getirebilir veya kullanıcı adına eylem gerçekleştirebilir.

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

Oturum Açma Nedeni

SignInReason, kullanıcının oturum açması gerektiğini belirten seçim yapılan türde bir değişkendir. İki olası değeri vardır:

• SignInRequired, kullanıcının Oturum aç sistem konusunu kullanarak konuşmanın başlangıcında oturum açması gerektiğini belirtir. Kullanıcıların oturum açmalarını zorunlu kıl seçeneği açık olmalıdır.

• Initializer, bir kullanıcı oturum açmadığında ve konuşmada kimlik doğrulama değişkenlerini kullanan bir noktaya ulaştığında oturum açmasının istendiğini gösterir.

Classic

Kimlik doğrulama değişkenleri

Aracınız Microsoft ile kimlik doğrulaması veya Manuel kimlik doğrulama seçeneklerinden biriyle yapılandırılmışsa, konularınızda kullanabileceğiniz bir dizi kimlik doğrulama değişkeniniz vardır. Aracınızda kimlik doğrulamasını yapılandırma hakkında daha fazla bilgi için bkz. Copilot Studio'da kullanıcı kimlik doğrulamasını yapılandırma.

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	Microsoft ile kimlik doğrulaması yap	El ile
User.DisplayName	❌	✔️	✔️
User.Id	❌	✔️	✔️
User.IsLoggedIn	❌	❌	✔️
User.AccessToken	❌	❌	✔️

UserDisplayName değişkeni

User.DisplayName değişkeni, kimlik sağlayıcısında depolanan kullanıcı görünen adını içerir. Bu değişkeni, müşterinin aracıya açıkça söylemesine gerek kalmadan, müşteriyi selamlamak veya ona hitap etmek için kullanabilir, böylece daha kişiselleştirilmiş bir hale getirebilirsiniz.

Bu alan değeri Microsoft Entra ID name talepten alınır. OAuth sağlayıcıları için bu, name talebinde depolanan değerdir. Copilot Studio bu alanı otomatik olarak bir değişkene ayıklar, bu nedenle, kimlik doğrulama kapsamı kurulumunuzun bir parçası olarak profile bulunduğundan emin olun.

UserID değişkeni

User.Id değişkeni, kimlik sağlayıcısında depolanan kullanıcı kimliğini içerir. Power Automate akışları, UserID değerini değer olarak alan API'leri çağırmak için bu değeri kullanabilir. Bu alan değeri Microsoft Entra ID sub talepten alınır. OAuth sağlayıcıları için bu, sub talebinde depolanan değerdir. Copilot Studio bu alanı otomatik olarak değişkene aktarır.

Uyarı

User.DisplayName ve User.Id değişkenleri doldurulmayabilir ve bunun yerine kimlik sağlayıcısındaki kullanıcı yapılandırmasına bağlı olarak bu değişkenler 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

User.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.

User.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.

User.AccessToken değişkeni

User.AccessToken değişkeni, kullanıcı oturum açtıktan sonra alınan kullanıcı belirtecini içerir. Bu değişkeni Power Automate akışlarına geçirebilirsiniz böylece arka uç API'lerine bağlanabilir ve kullanıcının bilgilerini getirebilir veya kullanıcı adına eylemler gerçekleştirebilir.

Uyarı

User.AccessToken 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.

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

Kimlik doğrulama değişkenlerini test etme

Varsayılan olarak, Test botu bölmesi User.DisplayName ve User.Id değişkenlerini doldurmak için o anda oturum açmış kullanıcının hesabını kullanır. Ancak, kimlik doğrulaması kullanan konuları test ederken, bu değişkenler için başka değerler (veya boş bir değer) kullanmak isteyebilirsiniz.

Örneğin, özel karakterlerin nasıl kullanıldığını veya değişkenin boş olması durumunda ne olacağını test etmek isteyebilirsiniz.

Aşağıdaki tabloda bu değişkenleri dolduracak komutlar listelenmektedir. Bu komutlar yalnızca Test bot bölmesine uygulanır; bunları bir kanala dağıtılan yayınlanmış bir aracıda kullanamazsınız.

İstenen komutu normalde aracıyla sohbet ediyormuşsunuz gibi Test botu bölmesine girin. Başarılıysanız aracıdan bir onay iletisi alırsınız. Acenteniz kimlik doğrulaması kullanmıyorsa bir hata alırsınız.

Test botu bölmesini sıfırlarsanız (veya Test botunun otomatik olarak sıfırlanması için bir konuda değişiklik yaparsanız), komutları yeniden göndermeniz gerekir.

Variable	Özel değer komutu	Boş değer komutu
User.DisplayName	/debug set bot.UserDisplayName "Value"	/debug set bot.UserDisplayName ""
User.Id	Mevcut değil	/debug set bot.UserID ""

Önemli

Güvenlik nedeniyle, User.Id değişkenini özel bir değerle (boş veya tanımsız değer dışında) dolduramazsınız.

"Microsoft ile kimlik doğrulaması" kullanılırken kimlik doğrulaması

Kimlik doğrulama seçeneğiniz Microsoft ile Kimlik Doğrulama olarak ayarlanmışsa konularınıza açıkça kimlik doğrulaması eklemeniz gerekmez. Bu yapılandırmada, Microsoft Teams'daki tüm kullanıcılar Teams kimlik bilgileriyle otomatik olarak oturum açar ve kimlik doğrulama kartıyla açıkça oturum açmaları gerekmez. Kimlik doğrulama seçeneğiniz Manuel olarak ayarlanmışsa, bir Kimlik Doğrulama düğümü eklemeniz gerekir (Teams kanalı için bile).

Uyarı

Kimlik doğrulama seçeneğiniz Microsoft ile kimlik doğrulaması olarak ayarlandıysa, konularınıza açıkça kimlik doğrulaması ekleyemezsiniz.

Konuya kullanıcı kimlik doğrulaması ekleme

Kimlik Doğrulama düğümü, kullanıcıdan bir oturum açma kartıyla oturum açmasını ister. Bir kullanıcı oturum açtıktan sonra, başka bir Kimlik Doğrulama düğümüne ulaşsalar bile, kendilerine tekrar sorulmaz.

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 için kullanıcıdan doğrulama kodu gerekmez.

Temsilciniz SSO yapılandırıldığında, kullanıcıdan oturum açması istenmez.

Konunuza Kimlik doğrulama düğümü eklemek için:

1. Düzenlemek istediğiniz aracının Konu sayfasına gidin.

2. Kimlik doğrulama şablonunu eklemek istediğiniz konuyu açın.

   Uyarı

   Eğer temsilciniz Dynamics 365 Customer Service'e bağlıysa, Kimlik Doğrulama düğümü, kullanıcıları ilk selamlarken temsilcinin takip ettiği konuşma yoluna dahil edilemez; aksi halde giriş kartı iki kez gösterilir. Bunun yerine, Kimlik doğrulama düğümünü kullanıcı yanıtı tarafından tetiklenen başka bir konuya eklemeniz gerekir.

3. Mesaj düğümü eklemek için Düğüm ekle (+) öğesini seçin. Bir oturum açma deneyiminin gerçekleşmek üzere olduğunu belirtmek için aracının söylemesi gerekenleri girin.

4. İleti düğümünün altında, Düğüm ekle (+) simgesini, Eylem çağır'ı ve ardından Kimlik doğrula'yı seçin.

   

   Uyarı

   Kimlik doğrulama düğümü, bir diyaloq ağacının sonunda (yaprak düğüm olarak) eylem seçicisinde bulunabilir. Diyalogun ortasına eklenemez. Eklendikten sonra, altına başka düğümler eklenebilir.

   Yeni düğümler otomatik olarak görünür: bir üst Kimlik Doğrulama düğümü, ardından bir başarı yolu ve bir başarısızlık yolu düğümleri gelir.

Kimliği Doğrula düğümü olmadan User.AccessToken kullanımı

User.IsLoggedIn ve User.AccessToken değişkenleri, Eylem çağır menü girişi tarafından sağlanan şablonu kullanmasanız bile kullanılabilir. Değişkeni önce kullanıcının User.AccessToken düğümünden geçmesine gerek kalmadan geçirirseniz, kullanıcıdan bu adımda oturum açması istenir.

Kullanıcının her zaman oturum açmasını bekliyorsanız veya farklı bir konuya yeniden yönlendiriliyorsa, User.AccessToken değişkeninin 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.

Uyarı

Kullanıcı konuşmanın ortasında oturumu kapatırsa, konu User.AccessToken değişkeni kullanan bir düğüme geldiğinde yeniden oturum açması istenecektir.

Başarı yolu

Başarı yolu, User.IsLoggedIn = True konumuna eşit olur ve kullanıcı başarıyla oturum açtığında bu durumu kapsar.

User.AccessToken değişkenini kullanan bir mantığınız varsa (örneğin, bir kullanıcının bilgilerini almak için bir akış kullanarak bir arka uç sistemine bağlanmak), bu yol izlenmelidir.

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 durumu ele almak için isteyebileceğiniz herhangi bir mantığı ekleyin. Örneğin, yeniden deneme veya canlı bir temsilciye yükseltme seçenekleri vardır. Özel senaryonuz ve kullanımınız için başarısızlık yolu eylemlerini özelleştirin.

Konunuzu test etme

Gerçek bir kullanıcıyı kimlik sağlayıcınızda yapılandırarak konunuzu test ettiğinize emin olun. Hem oturum açma başarılı hem de hata yollarının çalıştığından emin olun. Bunu yaptığınızda, kullanıcınızın oturum açamaması veya kimlik sağlayıcısının oturum açma deneyiminde bir hata olması sürpriz olmaz.

İlgili içerik

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. Daha fazla bilgi için bkz. Microsoft Entra ID ile çoklu oturum açmayı yapılandırma.