Использование сертификата или MSI для проверки подлинности приложения

Для проверки приложения бота можно использовать проверку подлинности на основе сертификата или MSI, а не идентификатора и секрета бота. Эта проверка подлинности устраняет проблемы соответствия требованиям, связанные с использованием Microsoft Entra ID и секрета бота.

Предварительные условия

Убедитесь, что у вас есть приложение бота Teams, развернутое в Azure со следующими ресурсами:

• Бот Azure.
• Идентификатор Entra с секретом, используемым для проверки подлинности бота.
• Ресурс, в котором размещается приложение бота, например Служба приложений Azure, Функции Azure.

Обновление до проверки подлинности на основе сертификатов

Чтобы обновить приложение бота для использования проверки подлинности на основе сертификатов, выполните следующие действия.

1. Создание и отправка сертификата в Azure AD
2. Обновление кода приложения бота
3. Удаление секрета бота

Создание и отправка сертификата в Azure AD

Чтобы использовать сертификат для проверки подлинности бота, выполните следующие действия:

1. Подготовьте сертификат и закрытый ключ.

2. Перейдите к портал Azure.

3. Выберите Регистрация приложений.

   

4. Выберите зарегистрированные приложения.

5. В левой области в разделе Управление выберите Сертификаты & секреты.

6. В разделе Сертификаты выберите Отправить сертификат.

   

   Откроется окно Отправка сертификата .

   Примечание.

   Отправьте сертификат (открытый ключ) с одним из следующих типов файлов: .cer, .pem, .crt.

7. Отправьте подготовленный сертификат.

8. Введите Описание.

9. Нажмите Добавить.

   

Обновление кода приложения бота

Чтобы обновить код приложения бота, выполните следующие действия:

1. Откройте проект приложения бота в Visual Studio или Visual Studio Code.

2. Обновите код.

   JavaScript

       const credentialsFactory = new ConfigurationServiceClientCredentialFactory({
       MicrosoftAppId: config.botId,
       CertificatePrivateKey: '{your private key}',
       CertificateThumbprint: '{your cert thumbprint}',
       MicrosoftAppType: "MultiTenant",
       });
   
       const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(
       {},
       credentialsFactory
       );
   
       const adapter = new CloudAdapter(botFrameworkAuthentication);
   

   C#

       builder.Services.AddSingleton<ServiceClientCredentialsFactory>((e) => new CertificateServiceClientCredentialsFactory("{your certificate}", "{your entra id}"));
   

3. Убедитесь, что вы протестируете бота, чтобы убедиться, что операция соответствует обновленной проверке подлинности.

Удаление секрета бота

Перед удалением секрета бота убедитесь, что приложение бота использует сертификат для проверки подлинности.

Чтобы удалить секрет бота, выполните следующие действия:

1. Перейдите к портал Azure.

2. Выберите Регистрация приложений.

   

3. Выберите зарегистрированные приложения.

4. В левой области в разделе Управление выберите Сертификаты & секреты.

5. Удалите секреты из Entra.

   

Теперь приложение бота использует сертификат для проверки подлинности.

Обновление до проверки подлинности на основе MSI

Чтобы обновить приложение бота для использования проверки подлинности на основе MSI, выполните следующие действия.

1. Создание службы бота с типом MSI в Azure AD
2. Обновление кода приложения бота для MSI
3. Удаление секрета бота

Примечание.

Идентификатор и тип службы Azure Bot нельзя изменить после создания.

Создание службы бота с типом MSI в Azure AD

Чтобы создать новую службу Azure Bot с типом MSI, выполните следующие действия:

1. Перейдите к портал Azure.

2. Перейдите на домашнюю страницу.

3. Выберите + Создать ресурс.

4. В поле поиска введите Azure Bot.

5. Выберите клавишу ВВОД .

6. Выберите Azure Bot.

7. Нажмите Создать.

   

8. Введите имя бота в поле Дескриптор бота.

9. Выберите свою подписку в раскрывающемся списке.

10. Выберите свою группу ресурсов в раскрывающемся списке.

    

    Если у вас нет существующей группы ресурсов, можно создать новую группу ресурсов. Чтобы создать новую службу бота Azure и управляемое удостоверение, выполните следующие действия.

    1. Выберите Создать.
    2. Введите имя ресурса и нажмите кнопку ОК.
    3. Выберите расположение в раскрывающемся списке Расположение новой группы ресурсов .

    

11. В разделе Идентификатор приложения Майкрософт выберите Тип приложения в качестве управляемого удостоверения, назначаемого пользователем.

12. В поле Тип создания выберите Создать новый идентификатор приложения Майкрософт.

    

    ИЛИ

    Сначала можно вручную создать управляемое удостоверение, а затем создать бот Azure с помощью параметра Использовать существующую регистрацию приложения.

13. Обновите новую конечную точку и каналы обмена сообщениями Azure Bot в соответствии со старой службой.

14. Перейдите к ресурсу для размещения приложений.

15. Выберите Параметры. > Удостоверение > назначено пользователю.

16. Добавьте созданное управляемое удостоверение.

Обновление кода приложения бота для MSI

Чтобы обновить код приложения бота для MSI, выполните следующие действия.

1. Откройте проект приложения бота в Visual Studio или Visual Studio Code.

2. Обновите код.

   JavaScript

       const credentialsFactory = new ConfigurationServiceClientCredentialFactory({
       MicrosoftAppType: 'UserAssignedMsi',
       MicrosoftAppId: '{your MSI’s client ID}',
       MicrosoftAppTenantId: '{your MSI’s tenant ID}',
       });
   
       const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(
       {},
       credentialsFactory
       );
   
       const adapter = new CloudAdapter(botFrameworkAuthentication);
   

   C#

       builder.Configuration["MicrosoftAppType"] = "UserAssignedMsi";
       builder.Configuration["MicrosoftAppId"] = "{your MSI’s client ID}";
       builder.Configuration["MicrosoftAppTenantId"] = "{your MSI’s tenant ID}";
       builder.Services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();
   

3. Обновите в BOT_ID файле .env .

4. Убедитесь, что вы протестируете бота, чтобы убедиться, что его работа соответствует обновленной проверке подлинности.

Удаление секрета бота

Перед удалением секрета бота убедитесь, что приложение бота использует сертификат для проверки подлинности.

Чтобы удалить секрет бота, выполните следующие действия:

1. Перейдите к портал Azure.

2. Выберите Регистрация приложений.

   

3. Выберите зарегистрированные приложения.

4. В левой области в разделе Управление выберите Сертификаты & секреты.

5. Удалите секреты из Entra.

   

Приложение бота теперь использует MSI для проверки подлинности.

См. также

• Создание ботов для Teams
• Создать расширения для сообщений
• Проверка подлинности пользователей в Microsoft Teams