Ошибка установки 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 |
| пакет/manifest | upload отклонён сразу | 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 с регистрацией приложения.
Исправление подтверждает отдельная тестовая группа
- Создать маленькую группу пилота и дать ей доступ к одному app ID.
- Проверить появление карточки и ручную установку под тестовым пользователем.
- Пройти consent только через утверждённый административный процесс.
- Открыть вкладку или bot и подтвердить серверный вызов с корректным tenant.
- Расширять назначение после записи результата и времени распространения настройки.
Готовый результат — это не только зелёный статус в admin center. Тестовый пользователь находит приложение, устанавливает его, проходит разрешённую аутентификацию и получает функциональный ответ. В отчёте остаются tenant ID, app ID, версия manifest, модель управления, назначенная группа и correlation ID ошибки; секрет приложения и токены туда не попадают.