Aracılığıyla paylaş

Copilot Studio Kit'te kullanıcı kimlik doğrulamasını etkinleştirme

Copilot Studio Kit, SSO etkin hizmet sağlayıcısı olarak Entra ID v2 kullandığınızda kullanıcı kimlik doğrulaması ile özel aracıların testini destekler. Özetle, Azure portalında gerekli uygulamaları oluşturup yapılandıracak ve ardından Copilot Studio Kit'te aracı yapılandırmasını oluşturacaksınız.

Copilot Studio Kit'te kullanıcı kimlik doğrulamasını etkinleştirmek için:

  • Özellikle Copilot Studio Kit kimlik doğrulaması amacıyla uygulama kaydı oluşturun.
  • Copilot Studio kimlik doğrulaması için uygulama kaydı oluşturun.
  • Copilot Studio aracısı için kimlik doğrulamasını etkinleştirin.
  • Son kullanıcı kimlik doğrulaması etkin olarak Copilot Studio Kit'te aracı yapılandırın.
  • Copilot Studio Kit'in Copilot Studio kimlik doğrulamasını kullanarak Direct Line'da kimlik doğrulamasından geçebilmesi için uygulamaları bağlayın.

Önkoşullar

  • Henüz yüklemediyseniz Copilot Studio Kit'i yükleyin.
  • Uygulama kayıtları oluşturmak için Azure Active Directory kiracınızda uygun izinlere sahip olun.

Aşağıdaki yapılandırma adımlarında aşağıdaki değerleri kullanmanızı öneririz:

  • Copilot Studio Kit kimlik doğrulama uygulaması: KitAuthApp
  • Copilot Studio kimlik doğrulama uygulaması: CopilotStudioAuthApp
  • Copilot Studio kapsamı: copilot.studio.scope

Copilot Studio Kit için kimlik doğrulama uygulaması oluşturma

Copilot Studio Kit için bir kimlik doğrulama uygulaması oluşturmak için Özel tuvaliniz için Microsoft Entra Id'de uygulama kaydı oluşturma makalesindeki adımları izleyin. Ek adımları not edin.

Şunları yapmanız gerekir:

  1. Microsoft Entra Id'de uygulama kaydını oluşturun.

    (Önerilen) Yeni uygulamaya KitAuthApp adını verin.

    Kayıt işlemi sırasında Dizin (kiracı) kimliği ve Uygulama (istemci) kimliğini not alın. Daha sonra Copilot Studio Kit'te aracı kaydı oluştururken ve Copilot Studio'yu Copilot Studio Kit uygulamasıyla ilişkilendirirken bu değerlere ihtiyacınız vardır. Bu kimlikleri istediğiniz zaman uygulama kaydı için Genel Bakış sayfasından alabilirsiniz.

  2. Yeniden yönlendirme URL'sini ekleme

    Dataverse ortamı URL'nizi işaret etmeye dikkat edin; mesela https://<hostname>.crm.dynamics.com

  3. Ek bir adım olarak,Sertifikalar ve gizli diziler'e gidin ve yeni bir istemci gizli dizisi oluşturun.

    (Önerilen) Gizli anahtarı KitAuthApp gizli anahtarı olarak adlandırın.

    Bu gizli değeri güvenli bir geçici dosyada depolayın. Daha sonra aracınızın kimlik doğrulamasını yapılandırırken buna ihtiyacınız olacak.

  4. API izinleri'nden Kiracı adınız için yönetici iznini ver<>'i seçin ve ardından Evet'i seçin. Düğme kullanılamıyorsa, kiracı yöneticisinden sizin için bunu girmesini istemeniz gerekebilir.

Copilot Studio için kimlik doğrulama uygulaması oluşturma

Copilot Studio için bir kimlik doğrulama uygulaması oluşturmak için Microsoft Entra Id ile kullanıcı kimlik doğrulamasını yapılandırma makalesindeki adımları izleyin.

Önerilen ek adımları not alın.

Uygulama kaydını oluştururken:

  • Yeni uygulamaya CopilotStudioAuthApp adını verin.

  • Desteklenen hesap türleri altında, Herhangi bir kurumsal kiracıdaki (herhangi bir Microsoft Entra ID dizini - çoklu kiracı) Hesaplar ve kişisel Microsoft hesapları (örneğin, Skype, Xbox) öğesini seçin.

  • Dizin (kiracı) kimliğini ve Uygulama (istemci) kimliğini not alın. Daha sonra Copilot Studio'da son kullanıcı kimlik doğrulamasını etkinleştirirken bu değerlere ihtiyacınız vardır. Bu kimlikleri istediğiniz zaman uygulama kaydı için Genel Bakış sayfasından alabilirsiniz.

El ile kimlik doğrulamasını yapılandırırken:

  • Federasyon kimlik bilgileri yerine istemci sırlarını kullanın. İstemci sırrı değerini not alın. Güvenli bir geçici dosyada depolayın. Daha sonra Copilot Studio'da son kullanıcı kimlik doğrulamasını etkinleştirirken buna ihtiyacınız vardır.

Aracınız için özel bir kapsam tanımlarken:

  • (Önerilen) Kapsam adı için copilot.studio.scope kullanın.

  • Kapsamlar altında tam kapsam adını not alın (api://xxx/copilot.studio.scope ile benzer biçimde). Bu değer daha sonra Copilot Studio'da son kullanıcı kimlik doğrulamasını etkinleştirirken gerekir.

  • Şu ek adımları tamamlayın:

    1. İstemci uygulaması ekle'yi seçin.
    2. İstemci Kimliği alanına, daha önce oluşturduğunuz KitAuthApp'in İstemci Kimliğini girin.
    3. Yetkili kapsamlardaki kapsamın daha önce oluşturduğunuz kapsam olduğunu doğrulayın (copilot.studio.scope). Kapsamı kontrol et seçeneğini açın.
    4. Uygulama ekle'yi seçin.

Özel aracınızda son kullanıcı kimlik doğrulamasını etkinleştirme

Özel aracınızda son kullanıcı kimlik doğrulamasını etkinleştirmek için şu adımları izleyin:

  1. Copilot Studio'da Ayarlar'ın altında Güvenlik > Kimlik Doğrulaması'nı seçin.
  2. El ile kimlik doğrulaması'nı seçin.
  3. Kullanıcıların oturum açmasını gerektir ayarını açık bırakın.
  4. Yeniden Yönlendirme URL'sini değiştirmeyin. Hizmet sağlayıcısınınAzure Active Directory v2 olduğundan emin olun.
  5. İstemci Kimliği için İstemci KimliğiniCopilotStudioAuthAppgirin.
  6. Gizli anahtar için, CopilotStudioAuthApp için oluşturulan Gizli anahtar'ı girin.
  7. Belirteç değişimi URL'sine, api://xxx/copilot.studio.scope için oluşturulan kapsamın tam adını (CopilotStudioAuthApp benzeri bir biçimde) girin.
  8. (İsteğe bağlı, SharePoint bilgi kaynağı için gereklidir) Kapsamlar'aFiles.Read.All ekleyin.
  9. (İsteğe bağlı, SharePoint bilgi kaynağı için gereklidir) Kapsamlar'aSites.Read.All ekleyin.
  10. Kaydet'i ve ardından iletişim kutusunda yeniden Kaydet'i seçin.
  11. Ayarlar'ı kapatın.
  12. Yayımla'yı ve ardından iletişim kutusunda yeniden Yayımla'yı seçin.

Aracı yapılandırmasını, son kullanıcı kimlik doğrulaması etkinken oluşturma

Son kullanıcı kimlik doğrulaması etkinleştirilmiş bir aracı yapılandırması oluşturmak için şu adımları izleyin:

  1. Copilot Studio Kit'e gidin.
  2. Gezinme menüsünden Aracılar'ı seçin.
  3. Yeni'yi seçin.
  4. Bir Ad girin.
  5. Yapılandırma Türleri'ndenTest Otomasyonu'nun seçin.
  6. Direct Line Ayarları'nı doldurun. Kanal Güvenliği'ni etkinleştirin ve Doğrudan Hat gizli anahtarını girin.
  7. Kullanıcı Kimlik Doğrulaması için Entra ID v2'yi seçin.
  8. İstemci Kimliği için KitAuthApp'in İstemci Kimliğini girin.
  9. Kiracı Kimliği için KitAuthApp'in Dizin Kimliğini girin.
  10. Kapsam için alanına CopilotStudioAuthApp için oluşturulan tam kapsam adını (benzer api://xxx/copilot.studio.scope biçimi) girin.
  11. Kaydet ve Kapat'ı seçin.

Artık son kullanıcı kimlik doğrulaması etkinken aracınızı test etmeye hazırsınız.

  • Last updated on