Обновление манифеста приложения для единого входа и предварительный просмотр приложения

Перед обновлением манифеста приложения (ранее называемого манифестом приложения Teams), убедитесь, что код приложения вкладки настроен для включения единого входа.

Настройка кода

Вы зарегистрировали приложение вкладки в Microsoft Entra идентификаторе и получили идентификатор приложения. Вы также настроили свой код для вызова getAuthToken() и обработки маркера доступа. Теперь необходимо обновить манифест приложения, чтобы включить единый вход для приложения вкладки. Манифест приложения описывает, как приложение интегрируется с Teams.

Свойство webApplicationInfo

webApplicationInfo Настройте свойство в файле манифеста приложения. Это свойство включает единый вход для вашего приложения и помогает вашим пользователям беспрепятственно получать доступ к вашему приложению с вкладками.

  

У webApplicationInfo есть два элемента: id и resource.

Элемент	Описание
id	Введите идентификатор приложения (GUID), созданный в Microsoft Entra id.
resource	Введите URI поддомена приложения и URI идентификатора приложения, созданный в Microsoft Entra id при создании область. Его можно скопировать из раздела Microsoft Entra ID>Предоставление API.

Примечание.

Для реализации webApplicationInfo свойства используйте манифест приложения версии 1.5 или более поздней.

URI идентификатора приложения, зарегистрированный в Microsoft Entra ID, настраивается с помощью область предоставленного API. Настройте URI поддомена приложения в resource , чтобы убедиться, что запрос на проверку подлинности из getAuthToken() домена, указанного в манифесте приложения.

Дополнительные сведения см. в webApplicationInfo.

Настройка манифеста приложения

1. Откройте вкладку проекта приложения.

2. Откройте папку манифеста приложения.

   Примечание.

   • Папка манифеста приложения должна находиться в корне проекта. Дополнительные сведения см. в статье Создание пакета приложения Microsoft Teams.
   • Дополнительные сведения о создании файла manifest.json см. в разделе Схема манифеста приложения.

3. manifest.json Открытие файла

4. Добавьте следующий фрагмент кода в файл манифеста приложения, чтобы добавить новое свойство:

   "webApplicationInfo":
   {
   "id": "{Microsoft Entra AppId}",
   "resource": "api://subdomain.example.com/{Microsoft Entra AppId}"
   }
   

   где

   • {Microsoft Entra AppId}— это идентификатор приложения, созданный при регистрации приложения в Microsoft Entra идентификатор. Это GUID.
   • subdomain.example.com— это URI идентификатора приложения, зарегистрированный при создании область в Microsoft Entra id.

5. Обновите идентификатор приложения с Microsoft Entra идентификатора в свойстве id.

6. Обновите URL субдомена в следующих свойствах:

   1. contentUrl
   2. configurationUrl
   3. validDomains

7. Сохраните файл манифеста приложения. Дополнительные сведения см. в манифесте приложения.

Ниже приведен пример обновленного манифеста приложения.

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json",
  "manifestVersion": "1.11",
  "version": "1.0.0",
  "id": "bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c",
  "developer": {
    "name": "Microsoft",
    "websiteUrl": "https://www.microsoft.com",
    "privacyUrl": "https://www.microsoft.com/privacy",
    "termsOfUseUrl": "https://www.microsoft.com/termsofuse"
  },
  "name": {
    "short": "Teams Auth SSO",
    "full": "Teams Auth SSO"
  },
  "description": {
    "short": "Teams Auth SSO app",
    "full": "The Teams Auth SSO app"
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "accentColor": "#60A18E",
  "staticTabs": [
    {
      "entityId": "auth",
      "name": "Auth",
      "contentUrl": "https://contoso.com/Home/Index",
      "scopes": [ "personal" ]
    }
  ],
  "configurableTabs": [
    {
      "configurationUrl": "https://contoso.com/Home/Configure",
      "canUpdateConfiguration": true,
      "scopes": [
        "team"
      ]
    }
  ],
  "permissions": [ "identity", "messageTeamMembers" ],
  "validDomains": [
    "contoso.com"
  ],
  "webApplicationInfo": {
    "id": "bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c",
    "resource": "api://contoso.com/bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c"
  }
}

Примечание.

Во время отладки можно использовать ngrok для тестирования приложения в Microsoft Entra идентификаторе. В этом случае необходимо заменить поддомен в api://subdomain.example.com/00000000-0000-0000-0000-000000000000 url-адресом ngrok. Вам потребуется обновлять URL-адрес при каждом изменении поддомена ngrok. Например, api://23c3-103-50-148-128.ngrok.io/bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c.

Отправка пользовательского приложения и предварительный просмотр в Teams

Вы настроили приложение-вкладку, чтобы включить единый вход в Microsoft Entra id, в коде приложения и в файле манифеста приложения. Теперь вы можете отправить пользовательское приложение вкладки в Teams и просмотреть его в среде Teams.

Чтобы предварительно просмотреть приложение с вкладками в Teams:

1. Создайте пакет приложения.

   Пакет приложения представляет собой ZIP-файл, содержащий файл манифеста приложения и значки приложений.

2. Откройте Teams.

3. Выберите Приложения>Управление приложениями>Отправка приложения.

   Появятся варианты отправки приложения.

4. Выберите Отправить пользовательское приложение , чтобы отправить пользовательское приложение вкладки в Teams.

5. Выберите ZIP-файл пакета приложения, а затем нажмите кнопку Добавить.

   Ваше пользовательское приложение вкладки будет отправлено, и появится диалоговое окно с информацией о дополнительных разрешениях, которые могут потребоваться.

6. Нажмите Продолжить.

   

   Откроется диалоговое окно согласия Microsoft Entra.

7. Выберите Принять, чтобы дать согласие на использование областей с открытым идентификатором.

   

   Teams открывает приложение на вкладке, и вы можете его использовать.

   

   Поздравляем! Вы включили систему единого входа для своего приложения вкладки.

См. также

• Схема манифеста приложения
• Формат схемы манифеста приложения
• Создание манифеста приложения в Microsoft Teams