Skip to main content
Microsoft Teams 연동은 Living Security Teams 앱을 통해 사용자와 채널에 Living Security 알림을 전송합니다. 교육 할당, 인간 위험 경고, 롤아웃 메시지, 보안 팀 공지에 사용하십시오. 이 연동은 알림 전용입니다. 사용자는 Microsoft Teams에서 봇에 명령을 보내지 않습니다. 앱이 설치되면 봇은 향후 선제적 알림을 위해 Teams 대화 참조를 저장합니다. 설치 메시지는 단방향이며 기업 롤아웃 요구 사항에 맞게 사용자 지정하거나 비활성화할 수 있습니다.
Microsoft Teams 관리자가 Living Security Teams 앱을 업로드, 승인 및 배포해야 합니다. Microsoft Entra User.Read.All 관리자 동의는 선택 사항이며, 이메일 또는 사용자 계정 이름(UPN) 조회 대체 기능만 활성화합니다.
넛지 및 플레이북 전송 설정은 설정 → 통신 → 채널에서 시작하여 Microsoft Teams 카드를 클릭하십시오. 이 페이지에서는 기반이 되는 Teams 앱 구성을 다룹니다.

사전 요구 사항

Microsoft Teams를 구성하기 전에 다음 사항을 확인하십시오.
  • 조직 앱을 업로드하고 승인할 수 있는 Microsoft Teams 관리자. 한 사람이 두 관리자 역할을 모두 보유할 수 있습니다.
  • 테넌트 전체 User.Read.All 애플리케이션 동의를 통해 선택적 이메일/UPN 조회 대체 기능을 활성화하려는 경우에만 필요한 Microsoft Entra 관리자
  • Living Security 관리자 권한
  • 활성 상태의 Living Security 조직
  • 채널 공지를 사용하는 경우, 보안 공지를 전달할 팀 및 채널 이름
  • Microsoft Entra 테넌트 ID (Microsoft Entra admin center → 아이덴티티 → 개요에서 확인 가능)

역할별 담당 업무

이 역할들은 서로 다른 사람이 맡을 수 있습니다. 패키지 체크섬, Teams 앱 ID, Bot 앱 ID 및 대상 롤아웃 사용자 범위를 Microsoft Teams 관리자에게 공유하십시오. 선택적 이메일/UPN 조회 대체 기능을 활성화하는 경우에만 생성된 동의 URL을 Microsoft Entra 관리자에게 공유하십시오. 관련 없는 Living Security 자격 증명은 공유하지 마십시오.

설정

1

Microsoft Teams 설정 패널 열기

Living Security에서 설정 → 통신 → 채널로 이동하여 Microsoft Teams를 선택합니다.패널에는 조직 리전, 패키지 파일 이름, Teams 앱 ID, 봇 앱 ID, SHA256 체크섬, Microsoft 테넌트 구성 상태, 설치 지침, 설치 메시지 제어, 검증 및 테스트 알림 도구가 표시됩니다.
Living Security에 표시된 리전이 조직이 호스팅되는 리전과 일치합니다.
2

Microsoft 테넌트 연결

Connect your tenant에서 알림을 수신하는 사용자와 Teams 채널을 소유한 Microsoft Entra 테넌트 ID를 입력한 다음 Save Microsoft tenant를 클릭합니다. 하나의 Microsoft 테넌트는 하나의 Living Security 조직에만 속할 수 있습니다.테넌트 제어를 사용할 수 없는 경우, 앱을 설치하기 전에 Living Security 구현 담당자 또는 지원 담당자에게 문의하여 테넌트를 연결하거나 변경하십시오.
계속하기 전에 Living Security에 Microsoft tenant connected가 표시됩니다.
가능하면 Teams 앱을 설치하기 전에 테넌트를 연결하십시오. 앱이 이미 설치되어 있는 경우 먼저 테넌트를 저장하고 Validate install을 선택하십시오. Living Security가 기존 설치를 자동으로 연결하려고 시도하며, 검증에서 이를 감지하지 못하는 경우에만 다시 설치하십시오.
3

리전별 Teams 패키지 다운로드

Download Teams package를 클릭합니다. Living Security가 조직에 맞는 리전별 ZIP 패키지를 제공합니다.변경하기 전에 다운로드한 파일을 Living Security에 표시된 SHA256 체크섬과 대조하여 확인하십시오. 앱에 고유한 이름과 아이콘을 지정하려면 이 확인 후 패키지를 업로드하기 전에 리전별 패키지 리브랜딩을 따르십시오.
다운로드한 파일의 체크섬이 Living Security에 표시된 SHA256 체크섬과 일치합니다.
4

Teams 관리 센터에서 패키지 업로드 및 설치

Microsoft Teams 관리 센터에서 Teams apps → Manage apps → Actions → Upload new app으로 이동하여 Living Security에서 다운로드한 ZIP 파일을 업로드합니다.다음 사항을 확인하십시오.
  • Teams 앱 ID와 봇 앱 ID가 Living Security에 표시된 값과 일치합니다
  • 앱 이름이 리전별 Living Security 이름이거나, 패키지를 리브랜딩한 경우 설정한 이름입니다
  • 게시자가 Living Security입니다. 패키지를 리브랜딩해도 게시자는 변경되지 않습니다
  • 앱이 차단 해제되어 있습니다
  • 앱을 대상 사용자 또는 그룹이 사용할 수 있습니다
  • 알림을 수신해야 하는 사용자와 팀/채널에 앱 설정 정책 또는 대상 지정 설치를 통해 앱이 설치되어 있습니다
Microsoft에서 앱 사용 가능 여부와 설정 정책 변경 사항이 반영되는 데 시간이 걸릴 수 있습니다.
앱 정책을 변경한 직후 검증 또는 테스트가 실패하면 Microsoft Teams 관리 센터에서 정책 할당을 확인하고, Microsoft에서 반영이 완료된 후 다시 시도하십시오.
5

앱 설치 또는 열기

대상 사용자에게 개인 앱을 배포합니다. Living Security가 감지된 설치에 개인 테스트를 보내려면 먼저 최소 한 명의 사용자가 Microsoft Teams에서 Living Security 개인 앱을 설치하거나 열어야 합니다. 그러면 봇이 사용자의 신뢰할 수 있는 아이덴티티와 개인 대화 참조를 확보할 수 있습니다. 채널 설치만으로는 개인 감지 설치 테스트를 수행할 수 없습니다.채널 전송을 사용하려면 봇이 해당 채널 대화 참조를 확보할 수 있도록 대상 팀과 채널에 앱을 설치하십시오.
대상 사용자가 개인 앱을 설치했거나 열었거나, 앱이 대상 채널에 설치되어 있습니다.
6

설치 메시지 구성

Install message controls 섹션에서 Teams 설치 메시지의 전송 여부를 선택하고 조직에 맞게 단방향 문구를 사용자 지정합니다.사용 가능한 제어 항목:
  • Send install messages
  • Send personal install messages
  • Send channel install messages
  • Default message
  • Personal message
  • Channel message
메시지 필드는 앱을 설치한 사용자의 표시 이름으로 치환되는 {{installerName}}를 지원합니다. 개인 또는 채널 메시지를 비워 두면 구성된 기본 메시지가 사용됩니다. 기본 메시지도 비어 있으면 Living Security가 해당 범위의 기본 제공 메시지를 사용합니다.
7

설정 검증

Living Security에서 Validate install을 클릭합니다. 검증에서는 리전별 패키지 사용 가능 여부, Microsoft 테넌트 구성의 존재 및 이 Living Security 조직에 대한 고유성, 리전별 봇 자격 증명 구성 여부, 연결된 테넌트에서 활성 앱 설치가 감지되었는지 여부를 확인합니다.
실제 알림을 전송하기 전에 Validation passed가 표시됩니다.
8

테스트 알림 전송

기본 개인 테스트의 경우 Send test to detected installation을 클릭합니다. Living Security는 감지된 활성 개인 설치를 선택하고 저장된 신뢰할 수 있는 아이덴티티와 대화 참조를 사용합니다. 이 테스트는 Microsoft Graph를 호출하지 않으며 User.Read.All 동의가 필요하지 않습니다.감지된 개인 설치가 없으면 사용자에게 Living Security 개인 앱을 설치하거나 열도록 요청한 후 Validate install을 다시 선택하고 테스트를 다시 전송하십시오. 고급 대상 지정 이메일/UPN 테스트는 선택적 조회 대체 기능이 활성화된 경우에만 사용하십시오.
단방향 테스트 알림이 Microsoft Teams에 표시됩니다.
전송 진단이 필요한 경우 통신 로그에서 해당 시도를 검토하십시오.

리전별 패키지 리브랜딩

리전별 패키지는 manifest.json, color.png, outline.png의 세 파일로 구성된 ZIP 아카이브입니다. 업로드하기 전에 이 패키지에서 고유한 앱 이름과 아이콘을 설정할 수 있습니다. Living Security는 Teams 관리자가 직접 업로드하는 리전별 패키지에 대해 이 방식을 지원합니다. 패키지를 다운로드하여 확인한 후, Teams 관리 센터에 업로드하기 전에 이 작업을 수행하십시오.
1

패키지 압축 해제

ZIP 파일의 압축을 풉니다. 아카이브 루트에 정확히 세 개의 파일이 있습니다: manifest.json, color.png, outline.png.
2

아이콘 교체

color.png 및 outline.png을 고유한 아이콘으로 교체합니다. 두 파일 이름은 그대로 유지하십시오.
3

앱 이름 설정

manifest.json에서 다음 두 필드를 편집합니다.
  • name.short — Teams 앱 헤더 및 공간이 제한된 기타 영역에 표시되는 이름입니다. 최대 30자입니다.
  • name.full — 앱 카탈로그 및 앱 세부 정보에 표시되는 이름입니다. 최대 100자입니다.
    Teams 관리 센터에 Living Security 앱이 이미 업로드되어 있는 경우, version을 그곳에 설치된 버전보다 높게 설정하십시오. Microsoft Teams는 버전이 증가하지 않는 업데이트를 거부하며, 새로 다운로드한 패키지는 이미 설치한 패키지와 같거나 더 낮은 버전일 수 있습니다.설치된 버전은 Teams 관리 센터의 Teams apps → Manage apps에 있는 앱 세부 정보 페이지에서 확인합니다. 이를 방금 다운로드한 manifest.json의 version 값과 비교한 후, 둘 모두보다 높은 값으로 설정하십시오. 세 자리 숫자로 구성된 MAJOR.MINOR.PATCH 형식을 유지하십시오.예를 들어 설치된 앱이 1.1.1이고 새로 다운로드한 것이 1.1.0인 경우 1.1.2으로 설정합니다. 다운로드한 1.1.0을 1.1.1으로 올리면 설치된 버전과 동일해지므로 Teams가 업로드를 거부합니다.
4

아이덴티티 필드는 변경하지 않기

다음 필드는 변경하지 마십시오. 각 필드는 앱, 봇 또는 Single Sign-On 아이덴티티를 담고 있습니다.
  • id
  • bots의 botId
  • webApplicationInfo
  • validDomains
  • staticTabs의 contentUrl 및 websiteUrl
    아이덴티티 필드를 변경하면 앱은 설치할 수 있어도 알림을 전송하거나 Single Sign-On을 완료하지 못할 수 있습니다. Validate install은 테넌트, 봇 자격 증명 및 감지된 설치를 확인합니다. 매니페스트를 Living Security가 빌드한 패키지와 비교하지는 않습니다.
5

세 파일을 다시 압축

세 파일로 새 ZIP 아카이브를 만듭니다. 상위 폴더 없이 아카이브 루트에 파일을 배치하십시오. Microsoft Teams는 manifest.json이 폴더 안에 있는 패키지를 거부합니다.
6

업로드 및 확인

리브랜딩한 ZIP 파일을 Teams 관리 센터에 업로드한 다음, Living Security로 돌아가 Validate install을 클릭합니다. 테스트 알림을 전송합니다.
Validation passed가 표시되고, 테스트 알림이 설정한 앱 이름과 아이콘으로 Microsoft Teams에 도착합니다.

게시자 및 체크섬

리브랜딩은 앱 이름과 아이콘을 설정합니다. 다음 두 가지는 변경되지 않습니다.
  • 게시자는 Living Security로 유지됩니다. 매니페스트의 developer 필드는 Living Security를 명시하고 Living Security 웹사이트, 개인정보 처리방침 및 서비스 약관으로 연결됩니다. 이 필드들은 함께 서비스를 운영하는 회사를 식별하므로, Teams는 앱 세부 정보 페이지, 권한 동의 대화 상자, 앱 사용 보고서에서 계속 Living Security를 게시자로 표시합니다. 사용자에게는 앱 헤더, 앱 카탈로그, 알림에서 설정한 이름과 아이콘이 표시됩니다.
  • SHA256 체크섬이 더 이상 일치하지 않습니다. Living Security에 표시된 체크섬은 다운로드한 상태의 패키지를 기준으로 합니다. 파일을 편집하기 전에 이를 확인하고, 롤아웃 기록을 위해 리브랜딩한 패키지의 체크섬을 별도로 기록해 두십시오.

선택 사항: 이메일/UPN 조회 대체 기능 활성화

일반적인 개인 전송은 Living Security가 이미 알고 있는 신뢰할 수 있는 Microsoft Entra 객체 ID와, 사용자가 앱을 설치하거나 열 때 확보된 봇 대화 참조를 함께 사용합니다. 채널 전송은 저장된 채널 대화 참조를 사용합니다. 두 경로 모두 Microsoft Graph가 필요하지 않습니다. 수신자에게 신뢰할 수 있는 Entra 객체 ID가 없는 경우, Living Security는 선택적으로 Microsoft Graph를 사용하여 이메일 주소 또는 UPN으로 수신자를 확인할 수 있습니다. 이 대체 기능을 활성화하려면 Microsoft Entra 관리자에게 Teams 설정 패널에서 Grant optional User.Read.All consent를 클릭하도록 요청하고, 리전별 Living Security Teams 애플리케이션에 대해 Microsoft Graph User.Read.All 애플리케이션 권한을 승인하도록 하십시오. 관리자 동의 흐름은 다음과 같은 Microsoft Entra 패턴을 따릅니다.
Living Security는 연결된 테넌트 ID와 설정 패널에 표시된 Bot 앱 ID로 이 URL을 생성합니다. 각 ID는 용도가 다릅니다.
  • Teams 앱 ID는 Microsoft Teams 관리 센터에서 설치 가능한 앱 패키지를 식별합니다.
  • Bot 앱 ID는 리전별 봇의 Microsoft Entra 애플리케이션을 식별하며, 선택적 관리자 동의 흐름에 사용되는 클라이언트 ID입니다.
동의 URL에 Teams 앱 ID를 대신 사용하지 마십시오. 연결된 연동 아래의 Microsoft Entra ID (Client Credentials) 연동은 별도의 범용 연동입니다. 해당 자격 증명이나 동의는 리전별 Teams 봇에서 재사용할 수 없으며, 관련 없는 Entra 애플리케이션에 부여된 동의로는 이 대체 기능이 활성화되지 않습니다.
동의를 선택 사항으로 변경해도 기존 리전별 Living Security 애플리케이션 등록에서 User.Read.All이 제거되지는 않습니다. 이미 동의를 부여한 고객은 재구성 없이 계속 이메일/UPN 대체 기능을 사용할 수 있습니다.

알림 유형

조직의 사용 권한 및 구성된 플레이북에 따라 Living Security는 다음을 전송할 수 있습니다.

사용자 지정

Teams 알림은 Living Security 조직 구성을 사용합니다. 지원되는 필드에는 고객 표시 이름, 지원되는 로고 및 브랜드 필드, 메시지 문구, 클릭 유도 문구, 대상 링크, 롤아웃 텍스트, 지원/연락처 텍스트가 포함됩니다. 설치 메시지는 설정 → 통신 → 채널 → Microsoft Teams → Install message controls에서 구성할 수 있습니다. 설치 메시지를 완전히 비활성화하거나, 개인 또는 채널 설치 메시지만 비활성화하거나, 기본, 개인 또는 채널별 문구를 구성할 수 있습니다. Teams 앱 이름과 아이콘은 리전별 패키지에서 가져옵니다. 고유한 이름과 아이콘을 설정하려면 리전별 패키지 리브랜딩을 참조하십시오.

앱 업데이트 또는 제거

  • Living Security가 업데이트된 리전별 패키지를 제공하면 Microsoft Teams 채널 패널에서 다운로드하여 Teams 관리 센터를 통해 업로드하십시오. 롤아웃 전에 표시된 앱 ID, 봇 ID 및 체크섬을 확인하십시오.
  • 브랜딩 편집 내용은 패키지 업데이트 후 유지되지 않습니다. 새 리전별 패키지에는 매번 Living Security 앱 이름과 아이콘이 다시 포함됩니다. 새 패키지를 업로드하기 전에 리전별 패키지 리브랜딩으로 편집 내용을 다시 적용하십시오. 아이콘, 두 개의 이름 값, 마지막으로 업로드한 버전을 쉽게 찾을 수 있는 곳에 보관하면 업그레이드할 때마다 동일한 단계를 간단히 반복할 수 있습니다. 새 패키지가 설치된 버전보다 항상 높은 버전을 가지는 것은 아니므로, Teams에 설치된 것으로 표시되는 버전을 기준으로 버전을 설정하십시오.
  • 앱 또는 정책을 업데이트한 후에는 Validate install을 다시 실행하고 테스트를 한 번 더 전송하십시오.
  • 앱을 제거하거나 차단하면 해당 사용자 또는 채널에 대한 선제적 알림이 전송되지 않습니다. 앱을 다시 설치하고 새 테스트를 전송하여 Living Security가 최신 Teams 설치 이벤트를 수신하도록 하십시오.
  • Teams 전송을 중단하는 경우, Microsoft Teams에서 앱을 제거하기 전에 관련 플레이북에서 Teams를 제거하십시오.

문제 해결

  • Living Security Teams 개인 앱이 설치되어 있고, Living Security가 최신 대화 참조를 가지도록 사용자가 앱을 열었는지 확인하십시오
  • 구성된 Microsoft 테넌트 ID가 사용자가 속한 테넌트인지 확인하십시오
  • 진단에서 이메일/UPN 대체 기능이 시도된 것으로 나타나면, 올바른 테넌트에서 표시된 Bot 앱 ID에 User.Read.All 관리자 동의가 부여되었는지 확인하십시오
  • 이메일/UPN 대체 기능을 사용하는 경우, Living Security의 사용자 이메일 또는 UPN이 Microsoft Entra ID와 일치하는지 확인하십시오
  • 사용자가 이전에 앱을 제거하거나 차단한 경우 차단을 해제하거나 다시 설치하도록 요청하십시오
  • Living Security Teams 앱이 대상 팀 또는 채널에 설치되어 있는지 확인하십시오.
  • Living Security의 채널 매핑이 올바른 팀과 채널을 사용하는지 확인하십시오.
  • 채널이 제거, 이름 변경, 보관 또는 제한되었는지 확인하십시오.
  • 대상 팀 또는 채널에 앱을 다시 설치하고 테스트 알림을 다시 전송하십시오.
  • Microsoft Entra 관리자가 표시된 Bot 앱 ID에 Microsoft Graph User.Read.All에 대한 테넌트 전체 동의를 부여했는지 확인하십시오.
  • 구성된 테넌트 ID가 사용자와 Teams가 위치한 테넌트인지 확인하십시오.
  • 사용자가 Microsoft Entra ID에 존재하며 다른 테넌트의 게스트가 아닌지 확인하십시오.
오류 범주 TEAMS_ADMIN_CONSENT_REQUIRED 또는 Microsoft 오류 AADSTS7000229는 이메일/UPN 수신자 조회에서 선택적 Microsoft Graph 대체 기능을 시도했지만, 연결된 Microsoft Entra 테넌트에 리전별 Living Security Teams 앱의 서비스 주체(엔터프라이즈 애플리케이션)가 없다는 의미입니다. 기본 신뢰 ID 및 저장된 대화 경로에는 이 동의가 필요하지 않습니다. 이는 Living Security 시크릿이 만료된 것이 아닙니다.
  1. 설정 → 통신 → 채널 → Microsoft Teams를 엽니다. 통신 로그 오류에서 Open Microsoft Teams setup을 사용할 수도 있습니다.
  2. 올바른 Microsoft Entra 테넌트 ID가 연결되어 있는지 확인합니다.
  3. 이메일/UPN 대체 기능이 필요한 경우, Microsoft Entra 관리자에게 Grant optional User.Read.All consent를 클릭하고 표시된 Bot 앱 ID에 대해 User.Read.All을 승인하도록 요청하십시오. 그렇지 않은 경우, 수신자가 개인 앱을 열었고 Living Security가 해당 수신자의 신뢰할 수 있는 Entra 객체 ID를 보유하고 있는지 확인하십시오.
  4. Microsoft에서 동의 처리가 완료된 후 Microsoft Teams 설정에서 고급 대상 지정 이메일/UPN 테스트를 전송합니다. 통신 로그는 전송 기록과 진단을 보여주며, 실패한 메시지를 다시 전송하지는 않습니다.
**Microsoft Entra ID (Client Credentials)**를 다시 구성해도 이 오류는 해결되지 않습니다. 해당 연동은 Teams 알림 전송에 사용되지 않기 때문입니다.
  • 봇이 차단, 제거 또는 설치 해제되었는지 확인하십시오
  • Living Security에서 테넌트를 연결하기 전에 앱이 설치된 경우, 테넌트를 저장하고 Validate install을 선택하여 Living Security가 기존 설치를 연결할 수 있도록 하십시오
  • 검증에서 기존 설치를 감지하지 못하는 경우에만 다시 설치하십시오
  • 대상 사용자 또는 채널이 최신 앱 설치 이벤트를 수신했는지 확인하십시오
  • 앱을 다시 설치한 후 새 테스트 알림을 전송하십시오
문제 해결에 사용되는 설치 이벤트 필드 예시:

보안

Living Security는 선택적 이메일/UPN 수신자 조회 대체 기능에만 Microsoft Graph User.Read.All을 사용합니다. 기본적으로 개인 알림 라우팅은 Living Security의 엔터티 데이터에 있는 신뢰할 수 있는 Entra 객체 ID와 Microsoft Teams에서 확보한 봇 대화 참조를 사용합니다. 호출자가 제공한 객체 ID와 대화 참조는 신뢰할 수 있는 라우팅 데이터가 아닙니다. Microsoft Teams 메시지는 Microsoft Teams 선제적 메시징을 사용하여 Living Security 알림 전용 Teams 봇을 통해 전송됩니다. Living Security는 표준 Teams 앱 설정을 위해 고객이 자체 Microsoft Entra 앱 등록을 만들거나 고객 소유 클라이언트 시크릿을 공유하도록 요구하지 않습니다. 리전별 Teams 패키지는 앱 ID, 봇 ID 및 메시징 엔드포인트를 조직이 호스팅되는 Living Security 리전과 일치하도록 유지합니다.

관련 문서

이메일 연동

이메일을 전송 채널로 구성합니다.

Slack 연동

Slack을 전송 채널로 구성합니다.

통신 로그

Teams 전송 상태와 기록을 추적합니다.

인증

Microsoft Entra ID 및 SSO 구성.