Фраза «внешний пользователь» в Teams неоднозначна. Guest имеет B2B-учётную запись в host tenant, external access user остаётся в своей организации, anonymous participant приходит по ссылке без Entra identity. Один и тот же bot manifest не даёт этим трём типам одинаковые возможности.
До изменения кода воспроизведите проблему в конкретном контексте: personal, group chat, meeting chat, standard или shared channel. Microsoft отдельно указывает, что приложения в one-to-one чате с external access users не поддерживаются; такой тест нельзя починить дополнительным Graph permission.
Матрица поддержки задаёт правильное ожидание
| Участник | Кто добавляет app | Где бот может работать |
|---|---|---|
| внутренний | сам пользователь/админ/host | по объявленным scopes и policy |
| guest B2B | пользователь host organization | уже добавленные chats/channels; personal по правилам |
| external access | native host user/meeting host | group/meeting chat после добавления; не external 1:1 |
| anonymous | сам не добавляет | ограниченное взаимодействие с уже доступным meeting app |
| shared channel member | в host channel context | при поддержке shared channel и cross-tenant access |
Клиентская кнопка «добавить» может отсутствовать по дизайну платформы или policy. Проверяйте, установлено ли приложение в нужный conversation scope и разрешено ли оно политиками host organization, а не только публикацию в каталоге.
Доставку activity отделяют от авторизации
log {
activityId, activityType, conversationType, conversationIdHash,
activity.conversation.tenantId, from.idHash, from.aadObjectIdHash,
serviceUrlHost, appVersion, authStage
}
// Не логировать token, displayName, email и текст сообщения целикомЕсли endpoint вообще не получил activity, исследуйте installation/scope/policy и Bot service. Если activity пришла, но ответ 401/403 выдаёт ваш backend или Graph, проблема уже в token audience, tenant, consent либо вашей модели доступа. Это разные инциденты.
Shared channel имеет host IDs, отличные от привычных team IDs
Для shared channel Microsoft рекомендует использовать `channel.ownerGroupId` как team ID для Graph channel APIs и `channel.ownerTenantId` как host tenant. `team.groupId` в этом контексте может быть пустым. В activity бота host tenant доступен как `activity.conversation.tenantId`.
- Не считайте весь parent team списком участников shared channel.
- Получайте прямых и косвенных участников через channel membership APIs.
- Сравнивайте tenant участника с ownerTenantId перед доступом к данным.
- Проверяйте доступ пользователя к каналу, а не только существование account.
- Не переносите данные private/shared channel в общий отчёт без разрешения.
Home tenant и host tenant отвечают за разные ресурсы
Для внешнего пользователя token может требоваться от его home tenant, тогда как SharePoint/канал принадлежат host tenant. Документация shared channels отдельно просит передавать правильный tenant ID в `getAuthToken` по сценарию. Приложение должно быть multitenant там, где это требуется, а consent проверяется в нужной организации.
Не исправляйте 403 заменой tenant на `common` без проверки issuer, audience и permission. Backend валидирует подпись и claims токена, затем собственное разрешение пользователя на конкретный conversation/resource.
Scope в manifest должен совпадать с местом использования
Bot для meeting/group chat и bot для channel получают разные conversation types. SSO для Teams bot официально поддерживается в one-to-one и group chat, но не в channel scope; для канала планируйте подходящий auth flow. App policy, admin consent и `webApplicationInfo` проверяются отдельно от messaging endpoint.
Пять тестовых персон заменяют один аккаунт разработчика
- Внутренний user host tenant проверяет baseline.
- Guest B2B вызывает бота в уже добавленном standard channel.
- External access user взаимодействует в group/meeting chat, куда app добавил host.
- Shared channel member из другой организации проходит in-channel действие и SSO.
- Anonymous attendee взаимодействует только в поддерживаемом meeting-сценарии.
- Каждый тест повторяется без admin role и в разрешённом policy наборе.
- Отдельно фиксируется ожидаемо неподдерживаемый external one-to-one chat.
В диагностический пакет включите тип пользователя, host/home tenant IDs в сокращённом виде, conversation type, app scopes, policy result, activity ID и sanitised 401/403. Access tokens, email и содержимое корпоративного чата удалите. Результат подтверждён, когда поддерживаемые внешние сценарии проходят, а неподдерживаемые показывают понятное ограничение.