Como implantar o Teams Chat Exporter em toda a organização

Para administradores de TI

O Teams Chat Exporter é uma ferramenta de exportação voltada ao usuário que roda inteiramente no navegador com a identidade do usuário conectado. Ela não precisa de registro de aplicativo, nem de consentimento de admin para o Microsoft Graph, nem de mudança no nível do ambiente do Teams. Você pode implantá-la em toda a organização e controlá-la com o gerenciamento de navegadores que você já usa.

IDs das extensões

• Chrome: jmghclbfbbapimhbgnpffbimphlpolnm
• Edge: phlomfiieaggnbfpacmjmidcjdlaiplp
• Firefox: n.gedizaydindogmus@gmail.com

Instalação forçada

Use o gerenciamento de políticas de navegador que você já tem.

• Chrome e Edge: adicione o ID da extensão ao ExtensionInstallForcelist via Group Policy ou Intune.
• Firefox: use a política ExtensionSettings no policies.json (ou seu equivalente de gerenciamento), com o ID do add-on do Firefox acima.

Permissões e por que cada uma é necessária

Estas são as permissões que a extensão solicita, retiradas dos manifestos publicados. Tudo roda no próprio dispositivo do usuário, com a identidade do usuário conectado.

• scripting: insere um pequeno script auxiliar na aba ativa do Teams durante a exportação, para buscar imagens embutidas que o script de conteúdo não alcança (os cookies são particionados para os hosts de imagem do Teams). Nenhum código externo é carregado.
• activeTab: lê a aba ativa do Teams durante a exportação para chamar a própria API de mensagens do Teams, com um fallback de DOM apenas se a API estiver indisponível. Nenhuma outra aba, nenhuma leitura em segundo plano.
• downloads, downloads.open: salvam a exportação pela caixa de diálogo Salvar Como do navegador quando o usuário clica em Exportar, e reabrem um arquivo salvo a partir do histórico no popup. Limitado aos IDs de download que a extensão criou.
• storage: armazena as preferências de exportação localmente (formatos, idioma, seções incluídas, filtros de data). Lidas apenas pelo popup, nunca enviadas para fora do dispositivo.
• offscreen (apenas Chrome e Edge): um documento offscreen oculto rasteriza emoji para a saída em PDF e gera a URL de blob usada para salvar arquivos grandes, ambos inteiramente no dispositivo. O Firefox não o usa.

Acesso a hosts

A extensão contata apenas hosts da Microsoft, e somente os que uma exportação precisa. O manifesto lista todas as variantes do Teams mais alguns hosts de mídia da Microsoft para que a ferramenta funcione em diferentes ambientes do Teams. Uma única exportação se comunica apenas com a origem do Teams do ambiente em que o usuário está conectado (a aba ativa) e acessa um host de mídia apenas para os itens que uma determinada conversa realmente contém.

• Origens web do Teams: teams.microsoft.com, teams.cloud.microsoft, teams.live.com, teams.microsoft.us (GCC High), mais o proxy .mcas.ms e as variantes de nuvem soberana (.us, .cn). Apenas a origem do ambiente do Teams em que o usuário está conectado é usada em cada exportação.
• graph.microsoft.com (.us para governo): resolve os nomes de exibição dos participantes e suas fotos de perfil apenas quando o usuário ativa "Incluir fotos de perfil" (desativado por padrão).
• *.asm.skype.com: imagens embutidas coladas em mensagens em contas Teams Free pessoais, apenas quando uma mensagem as contém.
• *.sharepoint.com / .us: arquivos de imagem anexados pelo clipe, baixados apenas para que a imagem apareça na exportação. Outros tipos de arquivo são mantidos como link, não baixados.
• <all_urls> opcional: desativado por padrão. Solicitado em tempo de execução apenas se o usuário ativar a opção "Fallback de busca de imagens" nas Configurações, que recupera miniaturas de pré-visualização de links quando o proxy de imagens do Teams está inacessível.

Tratamento de dados

Nenhum dado vai para um servidor de terceiros ou do desenvolvedor. As mensagens e suas mídias são lidas dos próprios serviços da Microsoft usando a sessão existente do usuário, formatadas no dispositivo e salvas pela caixa de diálogo Salvar Como do navegador, onde o usuário escolhe a pasta e o nome do arquivo. Não há proxy, nem etapa na nuvem, nem analytics ou telemetria de qualquer tipo na extensão. Ela roda com a identidade do usuário conectado, com o acesso que esse usuário já tem.

Código-fonte e licença

Código aberto sob a licença MIT. Leia o código ou compile você mesmo: github.com/gediz/teams-web-chat-exporter. O histórico de versões está no changelog.