SSO 설정 매뉴얼 (Microsoft Entra ID)

​

싱글 사인온 기능

​

사전 요구 사항

​

ID 공급자 등록

​

Microsoft Entra ID 설정

1

엔터프라이즈 애플리케이션에 VoicePing 추가

Azure 포털에서 Microsoft Entra ID를 열고 엔터프라이즈 애플리케이션 페이지를 엽니다.

“새 애플리케이션”을 클릭하고 VoicePing을 추가합니다.

2

SAML 2.0 프로토콜 설정

IdP의 VoicePing 애플리케이션에 대해 SSO에 SAML 2.0 프로토콜을 사용하도록 설정합니다.

3

서비스 공급자(SP) 정보 설정

VoicePing 애플리케이션 내 워크스페이스 관리 대시보드의 “팀 관리 > SSO 설정” 탭에서 필요한 필드를 확인할 수 있습니다.

SSO가 활성화된 워크스페이스의 오너 또는 매니저만 접근 가능합니다.

항목	값
ACS URL	https://api.voiceping.io/api/v1/user/acs
Entity ID	voice-ping

4

SAML 클레임에 이메일 주소 포함

SAML 클레임에 사용자의 이메일 주소를 포함합니다. 이는 VoicePing 플랫폼 내에서 인증을 수행하기 위해 필요합니다.

IdP에서 정의된 이메일 주소는 VoicePing에서 사용자를 등록할 때 사용한 것과 동일해야 합니다.

Microsoft Entra ID에서는 기본적으로 설정되어 있어야 하지만, 설정되어 있지 않은 경우 추가해 주세요.

5

사용자 추가

생성한 VoicePing 앱에 사용자를 추가합니다.

1. Microsoft Entra ID의 VoicePing 앱에서 “사용자 및 그룹” 페이지 열기
2. “사용자/그룹 추가” 클릭
3. 접근을 허용할 사용자 또는 그룹 선택
4. “선택” 및 “할당” 클릭

6

이메일 주소 확인

추가한 사용자가 Microsoft Azure에서 이메일 주소를 설정했는지 확인하세요.

7

메타데이터 파일 다운로드

IdP(Microsoft Entra ID)에서 메타데이터 파일을 다운로드합니다. 이 파일은 나중에 VoicePing 측에서 사용합니다.

​

VoicePing 설정

1

SSO 활성화

워크스페이스 관리 대시보드로 이동하여 “팀 관리 > SSO 설정” 탭을 열고 SSO를 활성화합니다.

2

IdP 메타데이터 업로드

ID 공급자 탭으로 전환합니다. IdP로 Microsoft Entra ID를 선택하고 IdP 메타데이터 파일을 업로드한 후 변경 사항을 제출합니다.

메타데이터 파일은 Microsoft Entra ID에서 가져올 수 있습니다.

3

조직 ID 정의

조직 ID를 정의합니다. 이는 최소 3자, 최대 20자의 고유한 문자열이어야 합니다.

조직 ID는 SSO 로그인 시 사용자에게 요청됩니다.

4

사용자 추가

워크스페이스에 사용자를 추가합니다. 사용자의 이메일 주소는 Microsoft Entra ID 설정에서 선택한 사용자의 이메일 주소와 일치해야 합니다.사용자는 초대 또는 직접 생성 중 하나의 방법으로 추가할 수 있습니다.

​

SSO로 로그인

• 오너 및 매니저: 다른 방법으로도 VoicePing에 로그인 가능
• 멤버 사용자: SSO로 인증 필요

​

로그인 절차

1. VoicePing 로그인 페이지로 이동
2. “SSO 로그인” 버튼 클릭

3. 조직 ID 입력

4. Microsoft Entra ID 인증 페이지에서 인증