Teams Chat Exporter uitrollen binnen je organisatie

Voor IT-beheerders

Teams Chat Exporter is een exporttool voor eindgebruikers die volledig in de browser draait als de ingelogde gebruiker. Er is geen app-registratie, geen Microsoft Graph-beheerderstoestemming en geen wijziging op tenantniveau nodig. Je kunt de extensie organisatiebreed uitrollen en beheren met je bestaande browserbeheer.

Extensie-ID's

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

Geforceerd installeren

Gebruik je bestaande beleidsbeheer voor browsers.

• Chrome en Edge: voeg de extensie-ID toe aan ExtensionInstallForcelist via Group Policy of Intune.
• Firefox: gebruik het beleid ExtensionSettings in policies.json (of het equivalent in je beheeromgeving), met de Firefox-add-on-ID hierboven.

Machtigingen, en waarom ze stuk voor stuk nodig zijn

Dit zijn de machtigingen die de extensie aanvraagt, overgenomen uit de gepubliceerde manifesten. Alles draait op het apparaat van de gebruiker zelf, als de ingelogde gebruiker.

• scripting: injecteert bij het exporteren een kleine helper in het actieve Teams-tabblad om afbeeldingen in de tekst op te halen die het contentscript niet kan bereiken (cookies zijn gepartitioneerd naar de afbeeldingshosts van Teams). Er wordt geen externe code geladen.
• activeTab: leest bij het exporteren het actieve Teams-tabblad om Teams' eigen berichten-API aan te roepen, en valt alleen terug op de DOM als de API niet beschikbaar is. Geen ander tabblad, geen lezen op de achtergrond.
• downloads, downloads.open: slaat de export op via het dialoogvenster Opslaan als van de browser wanneer de gebruiker op Exporteren klikt, en opent een opgeslagen bestand opnieuw vanuit de pop-upgeschiedenis. Beperkt tot download-ID's die de extensie zelf heeft aangemaakt.
• storage: slaat exportvoorkeuren lokaal op (formaten, taal, meegenomen onderdelen, datumfilters). Alleen gelezen door de pop-up, nooit buiten het apparaat verstuurd.
• offscreen (alleen Chrome en Edge): een verborgen offscreen-document zet emoji om in rasterafbeeldingen voor PDF-uitvoer en maakt de blob-URL aan die wordt gebruikt om grote bestanden op te slaan, beide volledig op het apparaat. Firefox gebruikt dit niet.

Toegang tot hosts

De extensie maakt alleen verbinding met Microsoft-hosts, en alleen met de hosts die voor een export nodig zijn. Het manifest vermeldt elke Teams-variant plus een paar Microsoft-mediahosts, zodat de tool werkt met alle tenanttypes. Eén export communiceert met de ene Teams-origin van de tenant waarbij de gebruiker is ingelogd (het actieve tabblad), en bereikt een mediahost alleen voor de items die een bepaald gesprek daadwerkelijk bevat.

• Teams-weborigins: teams.microsoft.com, teams.cloud.microsoft, teams.live.com, teams.microsoft.us (GCC High), plus de .mcas.ms-proxy en de soevereine-cloudvarianten (.us, .cn). Per export wordt alleen de origin van de ingelogde tenant gebruikt.
• graph.microsoft.com (.us voor de overheid): zoekt de weergavenamen van deelnemers op, en hun profielfoto's alleen wanneer de gebruiker "Avatars insluiten" inschakelt (standaard uit).
• *.asm.skype.com: in berichten geplakte afbeeldingen op persoonlijke Teams Free-accounts, alleen wanneer een bericht die bevat.
• *.sharepoint.com / .us: via de paperclip bijgevoegde afbeeldingsbestanden, alleen gedownload zodat de afbeelding in de export verschijnt. Andere bestandstypen worden als link bewaard en niet gedownload.
• Optioneel <all_urls>: standaard uit. Wordt alleen tijdens gebruik aangevraagd als de gebruiker de schakelaar "Terugval voor afbeeldingen" in Instellingen inschakelt, die miniaturen van linkvoorbeelden herstelt wanneer de afbeeldingsproxy van Teams onbereikbaar is.

Omgang met gegevens

Er gaan geen gegevens naar een server van derden of van de ontwikkelaar. Berichten en hun media worden gelezen uit Microsofts eigen diensten met behulp van de bestaande sessie van de gebruiker, op het apparaat opgemaakt en opgeslagen via het dialoogvenster Opslaan als van de browser, waar de gebruiker de map en bestandsnaam kiest. Er is geen proxy, geen cloudstap en geen enkele vorm van analytics of telemetrie in de extensie. Ze draait als de ingelogde gebruiker, met de toegang die die gebruiker al heeft.

Broncode en licentie

Open source onder de MIT-licentie. Lees de code of bouw de extensie zelf: github.com/gediz/teams-web-chat-exporter. De releasegeschiedenis staat in de changelog.