Ошибка установки Teams-приложения редко означает одно и то же. Оно может отсутствовать в каталоге tenant, быть заблокировано для пользователя, не пройти проверку пользовательского пакета или запросить разрешения, которые требуют согласия администратора. Начните с точного app ID и одного тестового пользователя; проверка «у коллеги работает» без tenant и назначений почти ничего не объясняет.

Не просите пользователя обходить организационные ограничения или загружать пакет в личный tenant. В Teams admin center проверьте страницу приложения и доступ конкретного пользователя. Учитывайте, что Microsoft переводит организации с классических permission policies на app-centric management: инструкции для одной модели могут не действовать в другой.

Четыре слоя дают четыре разных симптома

СлойТипичный симптомГде проверять
каталог и публикацияприложение не находитсяTeams admin center > Manage apps
доступ пользователювидно администратору, но не сотрудникуUsers and groups / app-centric access
установка и setupдоступно, но не добавлено автоматическиapp setup policy или назначение
permissions/consentустановка доходит до запроса доступаPermissions и Microsoft Entra consent
пакет/manifestupload отклонён сразуschema, IDs, URLs, icons и version

Сначала определите последний успешный слой. Если пользователь видит карточку, публикация уже состоялась. Если приложение открывается, но API возвращает запрет, установка прошла, а проблема находится в permissions или собственном backend. Эта граница не даёт смешать три независимые настройки в одно слово «заблокировано».

Доступ зависит от модели управления приложениями tenant

В app-centric management администратор задаёт, какие пользователи и группы могут использовать конкретное приложение. В организации, ещё работающей с app permission policies, доступ определяется назначенными политиками. Microsoft отдельно предупреждает, что permission policies перестают применяться после миграции на app-centric management, поэтому сначала посмотрите фактическую модель tenant.

  • Проверить org-wide и индивидуальный статус нужного app ID, а не приложения с похожим названием.
  • Убедиться, что тестовый пользователь входит в разрешённую группу и не исключён другой настройкой.
  • После изменения дать системе время распространить политику и фиксировать момент изменения.
  • Тестировать тем же типом клиента и аккаунта, но при необходимости повторить в web Teams для исключения локального кэша.

Consent не равен разрешению установить карточку

Teams-приложение может запрашивать ресурсные или Graph-разрешения. Страница Permissions в admin center показывает заявленные возможности, а Microsoft Entra управляет согласием для разрешений приложения. Пользовательский доступ к карточке не означает, что он вправе дать tenant-wide admin consent. Записывайте точное имя permission и тип — delegated или application — вместо общего сообщения «нужны права».

Выдавайте только требуемые разрешения и проверяйте издателя. После согласия повторите сценарий с новым сеансом тестового пользователя и посмотрите audit/sign-in logs. Если ошибка приходит от backend, подтвердите audience, tenant ID и scopes токена; повторная установка пакета не исправит неверную проверку токена на сервере.

Пользовательский пакет проверяется до публикации

ZIP-пакет должен содержать manifest и требуемые значки в корне, а manifest — соответствовать поддерживаемой схеме. Сверьте идентификатор приложения, версию, домены и URL вкладок. URL используют HTTPS и принадлежат разрешённым доменам. Для каждой сборки повышайте версию пакета осмысленно и сохраняйте hash загруженного ZIP, чтобы администратор и разработчик обсуждали один артефакт.

package_sha256=...
manifest.version=1.4.2
manifest.id=11111111-2222-3333-4444-555555555555
validDomains=[app.example.com]
contentUrl=https://app.example.com/teams/tab
webApplicationInfo.resource=api://app.example.com/1111...
test_user=user@example.invalid

Синтаксическая валидация не гарантирует работу: URL может быть закрыт корпоративным proxy, сертификат — недоверенным, а redirect URI — отсутствовать в регистрации Entra. Откройте каждый URL из сети пользователя, проверьте TLS и сопоставьте идентификаторы manifest с регистрацией приложения.

Исправление подтверждает отдельная тестовая группа

  1. Создать маленькую группу пилота и дать ей доступ к одному app ID.
  2. Проверить появление карточки и ручную установку под тестовым пользователем.
  3. Пройти consent только через утверждённый административный процесс.
  4. Открыть вкладку или bot и подтвердить серверный вызов с корректным tenant.
  5. Расширять назначение после записи результата и времени распространения настройки.

Готовый результат — это не только зелёный статус в admin center. Тестовый пользователь находит приложение, устанавливает его, проходит разрешённую аутентификацию и получает функциональный ответ. В отчёте остаются tenant ID, app ID, версия manifest, модель управления, назначенная группа и correlation ID ошибки; секрет приложения и токены туда не попадают.

Проверенные источники