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.

Not

Copilot Studio ve Microsoft Teams içinde oluşturulan aracılar otomatik olarak Microsoft Entra ID 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çma yapılandırma.

Ön koşullar

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

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ğrulamasını yapılandırma

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

Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma bölümündeki talimatları izleyin.

Oturum açma sistem konusu ile kullanıcı kimlik doğrulaması ekleme

Bir aracı oluşturduğunuzda, Copilot Studio otomatik olarak Oturum Aç adlı bir sistem konusu 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

Oturum aç konusunun yalnızca Copilot Studio tarafından sağlanan kimlik doğrulama yöntemini sağlamak için kullanılmasını öneririz. Başka eylemler, akışlar veya başka kimlik doğrulama yöntemleri çağrılmak üzere değiştirilmemelidir.

1. Copilot Studio'da aracınızı açın, sayfanın üst kısmındaki Ayarlar'ı 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ı yapılandırın.
5. Kaydet'i 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 tekrar istenmezler.

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

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

   Not

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

3. Manuel olarak kimlik doğrulama seçeneğini belirleyin ve Kullanıcıların oturum açmasını gerektir onay kutusunun işaretini kaldırın.

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

5. Kaydet'i seçin.

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

7. Düğüm ekle ( ) >Gelişmiş>Kimlik doğrulaması öğesini seçin.

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

Bahşiş

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

Kimlik doğrulama değişkenleri

Aracınız için kullanıcı kimlik doğrulamasını yapılandırdığınızda, konularınızda kimlik doğrulama değişkenlerini kullanabilirsiniz. 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	Kullanılamaz	Uygun	Uygun
User.FirstName	Kullanılamaz	Uygun	Uygun
User.LastName	Kullanılamaz	Uygun	Uygun
User.PrincipalName	Kullanılamaz	Uygun	Uygun
User.Email	Kullanılamaz	Uygun	Uygun
User.Id	Kullanılamaz	Uygun	Uygun
User.IsLoggedIn	Kullanılamaz	Uygun	Uygun
User.AccessToken	Kullanılamaz	Kullanılamaz	Uygun
SignInReason	Kullanılamaz	Uygun	Uygun

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. Kullanıcı ismini aracıya açıkça belirtmeden önce onu karşılamak veya ondan bahsetmek için bu değişkeni kullanarak konuşmayı daha fazla kişiselleştirin.

Copilot Studio, manuel kimlik doğrulama yapılandırılırken profile kapsamı tanımlandığı sürece, kimlik sağlayıcısı tarafından sağlanan name talebinden otomatik olarak User.DisplayName değerini ayarlar. Kapsam hakkında daha fazla bilgi için Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma konusuna bakın.

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. Kullanıcı Kimliğini değer olarak alan API'leri çağırmak için Power Automate akışlarında bu değişkeni kullanın.

Copilot Studio, kimlik sağlayıcısı tarafından sağlanan sub talebinden otomatik olarak User.DisplayName değerini 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ı 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

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

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

SignInReason

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.

Klasik

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. Temsilcinizde kimlik doğrulamayı nasıl yapılandıracağınız hakkında daha fazla bilgi için Copilot Studio'da kullanıcı kimlik doğrulamasını yapılandırma bölümüne 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	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 talebinden elde edilir. OAuth sağlayıcıları için bu, name talebinde depolanan değerdir. Copilot Studio bu alanı otomatik olarak değişkene çıkarır, bu nedenle kimlik doğrulama kapsamı kurulumunuzun bir parçası olarak profile değerine sahip olduğunuzdan 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'yi bir değer olarak alan API'leri çağırmak için bu değeri kullanabilir. Bu alan değeri Microsoft Entra ID sub talebinden elde edilir. OAuth sağlayıcıları için bu, sub talebinde depolanan değerdir. Copilot Studio, bu alanı otomatik olarak değişkene ayıklar.

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

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ı olursa aracıdan bir onay iletisi alırsınız. Aracınız kimlik doğrulama kullanmıyorsa, bir hata alırsınız.

Test botu bölmesini sıfırlarsanız (veya Test botu'nun otomatik olarak sıfırlanmasına neden olabilecek konu değişiklikleri yaparsanız) komutları yeniden göndermeniz gerekir.

Değişken	Özel değer komutu	Boş değer komutu
User.DisplayName	/debug set bot.UserDisplayName "Value"	/debug set bot.UserDisplayName ""
User.Id	Kullanılamaz	/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'teki 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 Manuel olarak ayarlanmışsa, bir Kimlik Doğrulama düğümü eklemeniz gerekir (Teams kanalı için bile).

Not

Kimlik doğrulama seçeneğiniz Microsoft ile Kimlik Doğrulama olarak ayarlanmışsa 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. Bazı kanallar, örneğin Microsoft Teams, kullanıcıdan doğrulama kodu gerektirmez.

Aracınızda SSO yapılandırıldığında, kullanıcıdan oturum açması talep edilmez.

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.

   Not

   Aracınız Dynamics 365 Customer Service'e bağlıysa Kimlik Doğrulama düğümü, kullanıcıları ilk selamlarken aracının izlediği konuşma yolunun parçası olamaz; aksi takdirde, oturum açma 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. İleti düğümü eklemek için artı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.

   

   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.

   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. İlk olarak kullanıcı Kimliği Doğrulama düğümünden geçmeden User.AccessToken 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, User.AccessToken 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 User.AccessToken değişkenini kullanan düğüme geldiğinde kullanıcıdan yeniden oturum açması istenir.

Başarı yolu

Başarı yolu, User.IsLoggedIn = True'in bulunduğu yere eşittir ve kullanıcının başarılı bir şekilde oturum açtığı zamanı hesaba katar.

User.AccessToken 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. Örnek olarak, yeniden deneme veya canlı aracıya yönlendirme seçenekleri mevcuttur. Ö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. 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 oturum açamazsa veya kimlik sağlayıcısının oturum açma deneyimiyle ilgili bir hata oluşursa beklenmedik bir durumla karşılaşmazsınız.

İ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çma yapılandırma.