Aracılığıyla paylaş

Microsoft Teams içindeki Copilot Studio yardımcı pilot için Microsoft Entra ID ile tekli oturum açmayı yapılandırın

  • Makale

Önemli

Power Virtual Agents yetenekleri ve özellikleri, Microsoft Copilot genelinde üretken yapay zekaya ve gelişmiş tümleştirmelere yapılan önemli yatırımların ardından artık Microsoft Copilot Studio'nun parçasıdır.

Bazı makalelerde ve ekran görüntülerinde, belgeler ve eğitim içeriği güncelleştirilirken Power Virtual Agents'a başvurulabilir.

Microsoft Teams içindeki Copilot Studio uygulaması tekli oturum açmayı (SSO) destekler; bu, yardımcı pilotların kullanıcılarda Microsoft Teams kimlik bilgileriyle otomatik olarak oturum açabileceği anlamına gelir.

Teams'te Microsoft Copilot Studio uygulamasında SSO yalnızca Microsoft Entra ID kullanıldığında desteklenir. Azure AD v1 gibi diğer hizmet sağlayıcıları, Microsoft Teams'deki Microsoft Copilot Studio uygulamasında SSO'yu desteklemez.

Önemli

Yardımcı pilotunuz Dynamics 365 Customer Service ile tümleştirildiğinde SSO desteklenmez.

Not

Teams SSO kimlik doğrulamasını el ile kimlik doğrulama seçeneğiyle kullanıyorsanız ve özel web sitelerinde aynı anda yardımcı pilotu kullanıyorsanız, Teams uygulamasını uygulama bildirimini kullanarak dağıtmanız gerekir.

Daha fazla bilgi için bkz Yardımcı pilotun Teams uygulama bildirimini indirme.

El ile dışındaki kimlik doğrulama seçenekleri gibi diğer yapılandırmalar veya Copilot Studio tek tıklama kullanarak Teams ile dağıtım çalışmaz.

Önkoşullar

Uygulama kaydını yapılandırma

Teams için SSO'yu yapılandırmadan önce Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırmanız gerekir. Bu işlem sırasında, SSO ayarlamak için kullanacağınız bir uygulama kaydı oluşturursunuz.

  1. Uygulama kaydı oluşturun. Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma bölümündeki yönergelere bakın.
  2. Yeniden yönlendirme URL'sini ekleyin.
  3. Gizli anahtar oluşturun.
  4. El ile kimlik doğrulamasını yapılandırın.

Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma bölümündeki yönergeleri izleyin ve ardından bu makaleye dönün.

Microsoft Teams kanal uygulaması kimliğinizi bulma

  1. Microsoft Copilot Studio içinde, SSO'yu yapılandırmak istediğiniz yardımcı pilotu açın.

  2. Yardımcı pilot ayarları altından Kanallar'ı seçin. Microsoft Teams kutucuğunu seçin.

  3. Ayrıntıları düzenle sekmesini seçin, Daha fazla öğesini genişletin ve ardından Kopyala'yı seçerek Uygulama kimliğini kopyalayın.

Uygulama Kimliği kopyala düğmesinin vurgulanmış olduğu Teams kanalı ayrıntıları bölmesinin ekran görüntüsü.

Not

Henüz Microsoft Teams kanalını açmadıysanız kanalın kapalı olduğu konusunda bilgilendirilirsiniz. Teams'i Aç seçeneğini belirleyip uygulama kimliğini almak için 1. Adımı yeniden deneyin.

Kanalın kapatıldığını gösteren, Teams kanalı bölmesinin ekran görüntüsü.

Microsoft Teams kanalı uygulama kimliğini uygulama kaydınıza ekleme

  1. Azure portalına gidin. Yardımcı pilotunuz için kullanıcı kimlik doğrulamasını yapılandırırken oluşturduğunuz uygulama kaydına ilişkin uygulama kaydı dikey penceresini açın.

  2. Yan bölmede API kullanıma sun'u seçin. Uygulama Kimliği URl'si için Ayarla'yı seçin.

    Uygulama kimliği URI'si için Ayar düğmesi konumunun ekran görüntüsü.

  3. api://botid-{teamsbotid} girin ve {teamsbotid} öğesini daha önce bulduğunuz Teams kanalı uygulama kimliği ile değiştirin.

    Uygulama Kimliği URI'si kutusuna girilen doğru biçimlendirilmiş URI'nın ekran görüntüsü.

  4. Kaydet'i seçin.

Uygulamalar, onay sürecinin parçası olarak kullanıcılar/yöneticiler tarafından izin verildiğinde API'leri çağırmaya yetkilidir. Onay hakkında Daha fazla bilgi edinmek için bkz. Microsoft kimlik platformunda izinler ve onay

Yönetici onayı seçeneği, kiracı yöneticiniz tarafından etkinleştirilmemişse grileştirilmiş olabilir. Ancak, kullanılabiliyorsa, onay vermeniz gerekir:

  1. Uygulama kaydı dikey penceresinde Azure portalda API İzinleri'ne gidin.

  2. <Kiracı adınız> için yönetici izni verin'i ve ardından Evet'i seçin.

    Yönetici onayı ver düğmesi seçili ekran görüntüsü.

Bahşiş

Kullanıcıların, her bir uygulamayı onaylamak zorunda kalmasını önlemek için bir Genel Yönetici, Uygulama Yöneticisi veya Bulut Uygulaması Yöneticisi, uygulama kayıtlarınıza kiracı çapında onay verebilir.

API izinleri ekleme

  1. Uygulama kaydı dikey penceresinde Azure portalda API İzinleri'ne gidin.

  2. İzin ekle'yi ve Microsoft Graph'ı seçin.

  3. Atanan izinler'i seçin. İzinlerin listesi aşağıda görünür. OpenId izinleri'ni genişletin ve openid ve profil'i açın.

  4. İzinler ekle'yi seçin.

OpenID ve profil izinleri açık olarak ekran görüntüsü.

Yardımcı pilotunuz için özel bir kapsam tanımlayın

  1. Uygulama kaydı dikey penceresinde Azure portalda API'yi kullanıma sun'a gidin.

  2. Yeni bir kapsam ekle'yi seçin.

    Kapsam ekle düğmesinin vurgulanmış olduğu bir ekran görüntüsü.

  3. Aşağıdaki özellikleri ayarlayın:

    Özellik Değer
    Kapsam adı Test.Read girin
    Kimler onay verebilir? Yöneticiler ve kullanıcılar'ı seçin
    Yönetici onayı görünen adı Test.Read girin
    Yönetici onayı açıklaması Allows the app to log in the user. girin
    State Etkin'i seçin

    Not

    Test.Read kapsam adı bir yer tutucu değerdir ve ortamınızda anlamlı olacak bir adla değiştirilmelidir.

  4. Kapsam ekle'yi seçin.

Microsoft Teams istemci Kimliklerini ekleme

Önemli

Aşağıdaki adımlarda, Microsoft Teams istemci kimlikleri için sağlanan değerler, tüm kiracılar arasında aynı oldukları için değişmez şekilde kullanılmalıdır.

  1. Uygulama kaydı dikey penceresindeki Azure portalda API kullanıma sun'a gidin ve İstemci uygulaması ekle'yi seçin.

    İstemci uygulaması ekle düğmesinin vurgulanmış olduğu bir ekran görüntüsü.

  2. İstemci kimliği alanında Microsoft Teams mobil/masaüstü için 1fec8e78-bce4-4aaf-ab1b-5451cc387264 olan istemci kimliğini girin. Daha önce oluşturduğunuz kapsam için onay kutusunu seçin.

    İstemci kimliği ekle bölmesine girilen istemci kimliğinin ekran görüntüsü.

  3. Uygulama ekle'yi seçin.

  4. Yukarıdaki adımları tekrarlayın ancak İstemci Kimliği için webde 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 olan Microsoft Teams istemci kimliğini girin.

  5. API kullanıma sun sayfasının Microsoft Teams istemci uygulaması kimliklerini listelediğini onaylayın.

    Microsoft Teams istemci kimliklerini doğru şekilde listeleyen API kullanıma sun sayfasının ekran görüntüsü.

Belirteç değişimi URL'si ekleme

Copilot Studio'da Microsoft Entra ID kimlik doğrulaması ayarlarını güncelleştirmek için Microsoft Teams ve Copilot Studio'nun bilgi paylaşmasına izin vermek üzere belirteç değişimi URL'sini eklemeniz gerekir.

  1. Uygulama kaydı dikey penceresinde Azure portalda API'yi kullanıma sun'a gidin.

  2. Kapsamlar altında Panoya kopyala'yı seçin.

    Panoya kopyala düğmesinin ekran görüntüsü..

  3. Copilot Studio'ta, gezinti menüsünde Ayarlar altında Güvenlik seçeneğini belirleyin ve ardından Kimlik Doğrulaması kutucuğunu seçin.

  4. Belirteç değişimi URL'si (SSO için gereklidir) için daha önce kopyaladığınız kapsamı yapıştırın.

    Copilot Studio'ta Belirteç Değişim URL'si olarak girilen Uygulama Kimliği URL'sinin ekran görüntüsü.

  5. Kaydet'i seçin.

Yardımcı pilotunuzun Microsoft Teams kanalına SSO ekleyin

  1. Copilot Studio içinde, yardımcı pilot ayarları altından Kanallar'ı seçin.

  2. Microsoft Teams kutucuğunu seçin. Ayrıntıları düzenle'yi seçin ve Daha fazlası'nı genişletin.

  3. AAD uygulamasının istemci kimliği için uygulama kaydınızdan Uygulama (istemci) kimliği'ni girin.

    Copilot Studio'ta AAD uygulamasının istemci kimliği olarak girilen Uygulama (istemci) kimliğinin ekran görüntüsü.

    Bu değeri edinmek için Azure Portal'ı açın. Ardından uygulama kaydı dikey penceresinde Genel bakış'a gidin. Uygulama (istemci) kimliği kutusunda değeri kopyalayın.

    Azure portalda Uygulama (istemci) kimliğinin bulunduğu konumun ekran görüntüsü.

  4. Kaynak URI'si olarak uygulama kaydınızdan Uygulama Kimliği URI'si'ni girin.

    Copilot Studio'ta Kaynak URL'si olarak girilen Uygulama Kimliği URL'sinin ekran görüntüsü.

    Bu değeri edinmek için Azure Portal'ı açın. Ardından uygulama kaydı dikey penceresinde API kullanıma sun'a gidin. Uygulama kimliği URI'si kutusunda değeri kopyalayın.

    Azure portalda Uygulama Kimliği URI'sinin bulunduğu konumun ekran görüntüsü.

  5. Kaydet'i ve ardından Kapat'ı seçin.

  6. Yardımcı pilot ayarları altından Yayımla'yı seçin.

  7. En son yardımcı pilot içeriğini müşterilerinizin kullanımına sunmak için Yayımla'yı seçin.

  8. Gezinti menüsünde, Ayarlar altında Kanallar'ı seçin.

  9. Microsoft Teams ve sonra Yardımcı pilotu aç seçin.

  10. Otomatik olarak oturumunuzu imzalayıp imzalamadığından test etmek için Microsoft Teams içinde yardımcı pilotunuzla yeni bir konuşma başlatın.