조직 전체에 Teams Chat Exporter 배포하기

IT 관리자용

Teams Chat Exporter는 로그인한 사용자 권한으로 브라우저에서 전적으로 실행되는 사용자용 내보내기 도구입니다. 앱 등록, Microsoft Graph 관리자 동의, Teams 환경 수준 변경이 필요 없습니다. 조직 전체에 배포하고 기존 브라우저 관리로 제어할 수 있습니다.

확장 프로그램 ID

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

강제 설치

기존 브라우저 정책 관리를 사용하세요.

• Chrome 및 Edge: Group Policy 또는 Intune을 통해 확장 프로그램 ID를 ExtensionInstallForcelist에 추가합니다.
• Firefox: 위의 Firefox 부가 기능 ID와 함께 policies.json(또는 동등한 관리 방식)에서 ExtensionSettings 정책을 사용합니다.

권한과 각 권한이 필요한 이유

다음은 게시된 매니페스트에서 가져온, 확장 프로그램이 요청하는 권한입니다. 모두 사용자 본인의 기기에서 로그인한 사용자 권한으로 실행됩니다.

• scripting: 내보내기 시 활성 Teams 탭에 작은 헬퍼를 삽입해, 콘텐츠 스크립트가 접근할 수 없는 인라인 이미지를 가져옵니다(쿠키는 Teams의 이미지 호스트별로 분리되어 있음). 외부 코드는 로드되지 않습니다.
• activeTab: 내보내기 시 활성 Teams 탭을 읽어 Teams 자체 메시지 API를 호출하며, API를 사용할 수 없을 때만 DOM 폴백을 사용합니다. 다른 탭이나 백그라운드 읽기는 없습니다.
• downloads, downloads.open: 사용자가 내보내기를 클릭하면 브라우저의 다른 이름으로 저장 대화상자를 통해 내보내기를 저장하고, 팝업 기록에서 저장된 파일을 다시 엽니다. 확장 프로그램이 만든 다운로드 ID로 제한됩니다.
• storage: 내보내기 설정(형식, 언어, 포함 섹션, 날짜 필터)을 로컬에 저장합니다. 팝업에서만 읽으며, 기기 밖으로 전송되지 않습니다.
• offscreen (Chrome 및 Edge 전용): 숨겨진 오프스크린 문서가 PDF 출력용 이모지를 래스터화하고 대용량 파일 저장에 사용되는 blob URL을 생성하며, 둘 다 전적으로 기기에서 처리됩니다. Firefox는 사용하지 않습니다.

호스트 액세스

확장 프로그램은 Microsoft 호스트에만, 그리고 내보내기에 필요한 호스트에만 연결합니다. 매니페스트는 도구가 다양한 Teams 환경에서 작동하도록 모든 Teams 종류와 몇 개의 Microsoft 미디어 호스트를 나열합니다. 한 번의 실행은 사용자가 로그인한 Teams 환경의 단일 Teams 오리진(활성 탭)과만 통신하며, 특정 대화에 실제로 포함된 항목에 대해서만 미디어 호스트에 접근합니다.

• Teams 웹 오리진: teams.microsoft.com, teams.cloud.microsoft, teams.live.com, teams.microsoft.us (GCC High), 그리고 .mcas.ms 프록시 및 소버린 클라우드(.us, .cn) 변형. 실행마다 로그인한 Teams 환경의 오리진만 사용됩니다.
• graph.microsoft.com (정부 클라우드는 .us): 참가자의 표시 이름을 확인하고, 사용자가 "프로필 사진 포함"을 켠 경우(기본값 꺼짐)에만 프로필 사진을 가져옵니다.
• *.asm.skype.com: 개인용 Teams Free 계정에서 메시지에 붙여넣은 인라인 이미지로, 메시지에 해당 이미지가 있을 때만 사용됩니다.
• *.sharepoint.com / .us: 클립 아이콘으로 첨부된 이미지 파일로, 이미지가 내보내기에 표시되도록 하기 위해서만 다운로드됩니다. 다른 파일 유형은 다운로드하지 않고 링크로 유지됩니다.
• 선택적 <all_urls>: 기본값은 꺼짐입니다. 사용자가 설정에서 "이미지 가져오기 폴백" 옵션을 활성화한 경우에만 런타임에 요청되며, 이는 Teams의 이미지 프록시에 연결할 수 없을 때 링크 미리보기 썸네일을 복구합니다.

데이터 처리

어떤 데이터도 타사 또는 개발자 서버로 가지 않습니다. 메시지와 그 미디어는 사용자의 기존 세션을 사용해 Microsoft 자체 서비스에서 읽고, 기기에서 형식을 맞춘 뒤, 브라우저의 다른 이름으로 저장 대화상자를 통해 저장되며, 거기서 사용자가 폴더와 파일 이름을 선택합니다. 확장 프로그램에는 프록시, 클라우드 경유 단계, 어떤 종류의 분석 기능이나 텔레메트리도 없습니다. 로그인한 사용자 권한으로, 그 사용자가 이미 가진 액세스로 실행됩니다.

소스 및 라이선스

MIT 라이선스에 따른 오픈 소스입니다. 코드를 읽거나 직접 빌드할 수 있습니다: github.com/gediz/teams-web-chat-exporter. 릴리스 기록은 다음에서 확인할 수 있습니다: 변경 로그.