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

  • Статья

Перед обновлением манифеста приложения (ранее называемого манифестом приложения 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. Откройте папку манифеста приложения.

    Примечание.

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

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

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

    где

    • {Microsoft Entra AppId} — это идентификатор приложения, созданный при регистрации приложения в Microsoft Entra ID. Это 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, в коде приложения и в файле манифеста приложения. Теперь вы можете отправить пользовательское приложение вкладки в Teams и просмотреть его в среде Teams.

Приложение единого входа

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

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

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

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

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

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

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

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

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

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

    Диалоговое окно Teams со сведениями о необходимых дополнительных разрешениях

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

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

    Диалоговое окно согласия Microsoft Entra

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

    Пример приложения на вкладке

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

См. также