Использование существующего приложения Entra в TeamsFx

В этом разделе содержатся сведения об использовании существующего приложения Microsoft Entra или создании вручную Microsoft Entra приложения для проекта TeamsFx. Следуйте инструкциям и убедитесь, что все необходимые сведения правильно заданы в проекте TeamsFx.

Создание приложения Microsoft Entra

1. Перейдите к портал Azure и выберите Microsoft Entra ID.

2. Выберите Регистрация приложений>Новая регистрация, чтобы создать приложение Microsoft Entra:

   • Имя: имя приложения конфигурации.
   • Поддерживаемые типы учетных записей. Выберите Учетная запись только в этом каталоге организации.
   • Оставьте поле URL-адрес перенаправления пустым.
   • Нажмите Зарегистрировать.

3. Когда приложение зарегистрировано, вы перейдете на страницу обзора приложения. Скопируйте идентификатор приложения (клиента),идентификатор объекта и идентификатор каталога (клиента); он понадобится позже. Убедитесь, что для значения Поддерживаемые типы учетных записей задано значение Только моя организация.

Создание секрета клиента для приложения Microsoft Entra (необязательно)

1. Перейдите на страницу "Сертификаты & секреты " приложения, выберите Секрет клиента и выберите Новый секрет клиента.

   • Описание: описание секрета клиента.
   • Срок действия: время окончания срока действия секрета клиента.
   • Нажмите Добавить.

2. При добавлении секрета клиента нажмите кнопку копирования в столбце Значение , чтобы скопировать секрет клиента.

Создание доступа в качестве область пользователя для приложения Microsoft Entra (необязательно)

1. Перейдите на страницу приложения Предоставление API и выберите Добавить область в разделе Области, определенные этим API.

   • Нажмите кнопку Сохранить и продолжить.
   • Имя области: заполните access_as_user.
   • Кто может предоставить согласие? Выберите Администраторы и пользователи.
   • Администратор отображаемое имя согласия. Заполните в Teams доступ к веб-API приложения.
   • Администратор описание согласия. Заполните поле Позволяет Teams вызывать веб-API приложения в качестве текущего пользователя.
   • Отображаемое имя согласия пользователя. Заполните в Teams доступ к веб-API приложения и выполнять запросы от вашего имени.
   • Описание согласия пользователя. Заполните поле Разрешить Teams вызывать веб-API этого приложения с теми же правами, что и у вас.
   • Состояние: выберите Включено.
   • Нажмите Добавить область.

2. На той же странице выберите Добавить клиентское приложение в разделе Авторизованные клиентские приложения.

   • Идентификатор клиента: укажите 1fec8e78-bce4-4aaf-ab1b-5451cc387264 , который является идентификатором клиента для Microsoft Teams на мобильных устройствах и клиентах.
   • Авторизованные области. Выберите существующую область access_as_user.
   • Нажмите кнопку Добавить приложение.

3. Еще раз выберите Добавить клиентское приложение.

   • Идентификатор клиента: введите 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 , который является идентификатором клиента для Teams в Интернете.
   • Авторизованные области. Выберите существующую область access_as_user.
   • Нажмите кнопку Добавить приложение.

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

Получение необходимых сведений из существующего приложения Microsoft Entra

1. Перейдите к портал Azure и выберите Microsoft Entra ID.

2. Выберите Регистрация приложений и найдите существующее приложение Microsoft Entra.

3. Перейдите на страницу обзор приложения и скопируйте идентификатор приложения (клиента),идентификатор объекта и идентификатор каталога (клиента). он понадобится позже. Убедитесь, что для значения Поддерживаемые типы учетных записей задано значение Только моя организация.

4. Перейдите на страницу "Сертификаты & секреты " приложения и нажмите кнопку копирования в столбце Значение , чтобы скопировать секрет клиента.

   Примечание.

   Если вы не можете скопировать секрет, следуйте инструкциям по созданию секрета клиента.

5. Перейдите на страницу приложения Предоставление API . Если вы уже добавили access_as_user область в разделе Области, определенные этим API, и предварительно выполните проверку подлинности двух идентификаторов клиента Teams, перейдите на страницу манифеста приложения и скопируйте идентификаторв разделе oauth2Permissions в качестве идентификатора области доступа как области пользователя.

Установка необходимых сведений в проекте TeamsFx

1. Откройте teamsapp.yml и найдите aadApp/create действие.

2. Найдите имена переменных среды, в которые хранятся сведения для Microsoft Entra приложения, в свойстве writeToEnvironmentFile . Ниже приведено определение по умолчанию writeToenvironmentFile при создании проектов с помощью набора средств Teams:

    writeToEnvironmentFile:
      clientId: AAD_APP_CLIENT_ID
      clientSecret: SECRET_AAD_APP_CLIENT_SECRET
      objectId: AAD_APP_OBJECT_ID
      tenantId: AAD_APP_TENANT_ID
      authority: AAD_APP_OAUTH_AUTHORITY
      authorityHost: AAD_APP_OAUTH_AUTHORITY_HOST
   

3. Добавьте значения для каждой переменной среды из шага 2.

   1. Добавьте в файл следующие переменные среды и их значения env\.env.{env} .

      AAD_APP_CLIENT_ID=<value of Microsoft Entra application's client id (application id)> # example: 00000000-0000-0000-0000-000000000000
      AAD_APP_OBJECT_ID=<value of Microsoft Entra application's object id> # example: 00000000-0000-0000-0000-000000000000
      AAD_APP_TENANT_ID=<value of Microsoft Entra's (tenant) id> # example: 00000000-0000-0000-0000-000000000000
      AAD_APP_OAUTH_AUTHORITY=<value of Microsoft Entra's authority> # example: https://login.microsoftonline.com/<Directory (tenant) ID>
      AAD_APP_OAUTH_AUTHORITY_HOST=<host of Microsoft Entra's authority> # example: https://login.microsoftonline.com
      AAD_APP_ACCESS_AS_USER_PERMISSION_ID=<id of access_as_user permission> # example: 00000000-0000-0000-0000-000000000000
      

   2. Если приложению требуется секрет клиента приложения Microsoft Entra, добавьте в файл переменную среды ниже и ее значениеenv\.env.{env}.user.

      SECRET_AAD_APP_CLIENT_SECRET=<value of Microsoft Entra application's client secret>
      

      Примечание.

      Не забудьте обновить имена переменных среды в примерах, если вы используете другие имена в writeToEnvironmentFile.

4. Откройте расширение Набора средств Teams и выберите Подготовить в облаке. Дождитесь успешной подготовки проекта.

Отправка манифеста приложения Microsoft Entra в портал Azure

Если Teams Toolkit не удается обновить Microsoft Entra приложение, появится сообщение об ошибке:

Insufficient privileges to complete the operation.

Если вы видите приведенное выше сообщение, обновите разрешение Microsoft Entra приложения и следуйте инструкциям по обновлению разрешения.

1. Найдите манифест приложения Microsoft Entra в разделе build/aad.manifest.{env}.json.

2. Скопируйте содержимое в файл манифеста.

3. Перейдите к портал Azure и выберите Microsoft Entra ID.

4. Выберите Регистрация приложений и найдите существующее приложение Microsoft Entra.

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