> ## Documentation Index
> Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt
> Use this file to discover all available pages before exploring further.

# SSO 설정 매뉴얼 (Microsoft Entra ID)

> Microsoft Entra ID(구 Azure AD)를 사용한 싱글 사인온 설정 가이드

export const ContactKo = () => <>
    <Tip>
      문의 사항이 있으시면 <a href="https://forms.gle/6AUho7oj3zBr79e96">이 양식</a>을 통해 연락해 주세요.
    </Tip>

    <h2>공식 링크</h2>

    <CardGroup cols={2}>
      <Card title="공식 웹사이트" icon="globe" href="https://voiceping.net/en/">
        공식 웹사이트 방문
      </Card>
      <Card title="X (Twitter)" icon="x-twitter" href="https://x.com/VoicePingMedia">
        X에서 팔로우
      </Card>
      <Card title="Facebook" icon="facebook" href="https://www.facebook.com/voiceping.inc">
        Facebook에서 좋아요
      </Card>
      <Card title="LinkedIn" icon="linkedin" href="https://www.linkedin.com/company/28684130/">
        LinkedIn에서 연결
      </Card>
    </CardGroup>
  </>;

## 싱글 사인온 기능

엔터프라이즈 플랜 고객은 워크스페이스에서 싱글 사인온(SSO)을 활성화하여 사용자가 Microsoft Entra ID를 사용하여 VoicePing에 로그인할 수 있습니다.

이 매뉴얼에서는 워크스페이스에서 SSO를 활성화하는 방법과 Microsoft Entra ID를 IdP(ID 공급자)로 설정하는 방법에 대해 설명합니다.

## 사전 요구 사항

<Check>VoicePing 엔터프라이즈 플랜 사용자 계정 보유</Check>
<Check>Microsoft Azure 계정 보유</Check>

***

## ID 공급자 등록

### Microsoft Entra ID 설정

<Steps>
  <Step title="엔터프라이즈 애플리케이션에 VoicePing 추가">
    Azure 포털에서 Microsoft Entra ID를 열고 엔터프라이즈 애플리케이션 페이지를 엽니다.

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/01-azure-entra-id.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=b02e79d9bff931861b8146854d8716bf" alt="Azure Entra ID" width="1440" height="700" data-path="ja/images/sso-entra/01-azure-entra-id.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/02-enterprise-apps.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=d15a2f004f309344646ec9a9cec6d924" alt="엔터프라이즈 애플리케이션" width="1486" height="794" data-path="ja/images/sso-entra/02-enterprise-apps.png" />
    </Frame>
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/03-saml-setup.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=d1ee7ef387296219c8e00eb18e29544f" alt="SAML 설정" width="1420" height="688" data-path="ja/images/sso-entra/03-saml-setup.png" />
    </Frame>
  </Step>

  <Step title="서비스 공급자(SP) 정보 설정">
    VoicePing 애플리케이션 내 워크스페이스 관리 대시보드의 "팀 관리 > SSO 설정" 탭에서 필요한 필드를 확인할 수 있습니다.

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

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/04-sp-config.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=d37efd4c234fecf241e8a29ee119a637" alt="SP 설정" width="1356" height="576" data-path="ja/images/sso-entra/04-sp-config.png" />
    </Frame>
  </Step>

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

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

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/05-claims.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=88af2ee3cc1463233ab55b5a9b46852e" alt="클레임 설정" width="942" height="238" data-path="ja/images/sso-entra/05-claims.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/14-configuration-step.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=0d361d1f642bbad50d2bb306a5c519de" alt="설정 단계" width="1132" height="942" data-path="ja/images/sso-entra/14-configuration-step.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/15-attributes-mapping.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=62b9ba6c8f3b5013a59763be13ca4541" alt="속성 매핑" width="1126" height="422" data-path="ja/images/sso-entra/15-attributes-mapping.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/16-claim-configuration.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=6b55f0de6c87852a3de9e50ea708f5d6" alt="클레임 구성" width="1324" height="514" data-path="ja/images/sso-entra/16-claim-configuration.png" />
    </Frame>
  </Step>

  <Step title="사용자 추가">
    생성한 VoicePing 앱에 사용자를 추가합니다.

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/UDonPy9U4TF-4rTr/ja/images/sso-entra/06-add-users.png?fit=max&auto=format&n=UDonPy9U4TF-4rTr&q=85&s=669c43583e467126f06e9ad0db5c4024" alt="사용자 추가" width="1512" height="766" data-path="ja/images/sso-entra/06-add-users.png" />
    </Frame>
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/07-verify-email.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=4a4424d581be8ffc3db16bd508527283" alt="이메일 주소 확인" width="1132" height="942" data-path="ja/images/sso-entra/07-verify-email.png" />
    </Frame>
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/17-download-metadata.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=eebd136808932f4a3df27ff401669a08" alt="메타데이터 다운로드" width="1078" height="534" data-path="ja/images/sso-entra/17-download-metadata.png" />
    </Frame>
  </Step>
</Steps>

***

## VoicePing 설정

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/08-enable-sso.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=455be44d72a3955447f0438c5ee0e50f" alt="SSO 활성화" width="1126" height="422" data-path="ja/images/sso-entra/08-enable-sso.png" />
    </Frame>
  </Step>

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

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/09-upload-metadata.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=83ccfb799777efc8bc4fcf0b73888d2c" alt="메타데이터 업로드" width="1324" height="514" data-path="ja/images/sso-entra/09-upload-metadata.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/18-voiceping-sso-settings.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=e7d9b124a8056dc8b94c2be2422df5f5" alt="VoicePing SSO 설정" width="1134" height="370" data-path="ja/images/sso-entra/18-voiceping-sso-settings.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/19-upload-metadata-xml.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=168dae8854d6775e31f6c99f7bacc6da" alt="메타데이터 XML 업로드" width="940" height="306" data-path="ja/images/sso-entra/19-upload-metadata-xml.png" />
    </Frame>
  </Step>

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

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

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/10-org-id.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=6ab40a533c140ac9482eb9e3b519f474" alt="조직 ID 설정" width="1134" height="370" data-path="ja/images/sso-entra/10-org-id.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/20-organization-id.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=0ff5b81ad00148106d961eadf624377c" alt="조직 ID 입력 화면" width="1468" height="360" data-path="ja/images/sso-entra/20-organization-id.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/21-sso-enabled-confirmation.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=c6f12c9adccded7db5cd5412e3979461" alt="SSO 활성화 확인" width="934" height="762" data-path="ja/images/sso-entra/21-sso-enabled-confirmation.png" />
    </Frame>
  </Step>

  <Step title="사용자 추가">
    워크스페이스에 사용자를 추가합니다. 사용자의 이메일 주소는 Microsoft Entra ID 설정에서 선택한 사용자의 이메일 주소와 일치해야 합니다.

    사용자는 초대 또는 직접 생성 중 하나의 방법으로 추가할 수 있습니다.

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/11-add-workspace-users.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=d5f8aaf20d9af87901c7181838ccbbf7" alt="워크스페이스 사용자 추가" width="1468" height="360" data-path="ja/images/sso-entra/11-add-workspace-users.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/22-user-assignment.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=bc4bc3baab78f34b9d9a227d3939a8b1" alt="사용자 할당" width="1024" height="1667" data-path="ja/images/sso-entra/22-user-assignment.png" />
    </Frame>
  </Step>
</Steps>

***

## SSO로 로그인

워크스페이스에서 SSO가 설정되면:

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

새로운 VoicePing 사용자를 SSO 워크스페이스에 초대하면, 사용자가 SSO로 가입할 때 VoicePing 사용자 계정이 제공됩니다.

### 로그인 절차

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

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/12-sso-login.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=2bc56d7ceb21cab227505830301b5ec8" alt="SSO 로그인" width="1032" height="1680" data-path="ja/images/sso-entra/12-sso-login.png" />
</Frame>

3. 조직 ID 입력

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/13-org-id-input.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=b83087d876e61fc2f03f303cf0c8a92a" alt="조직 ID 입력" width="1212" height="904" data-path="ja/images/sso-entra/13-org-id-input.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/23-test-sso-login.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=23c62802ec383efc5a51a13ee3f8745e" alt="SSO 로그인 테스트" width="1212" height="904" data-path="ja/images/sso-entra/23-test-sso-login.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/24-org-id-login-screen.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=694925b91b1594a04ea55b51c7922e00" alt="조직 ID 로그인 화면" width="1268" height="886" data-path="ja/images/sso-entra/24-org-id-login-screen.png" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-entra/25-sso-complete.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=80a9bea3e92e40bc0d7219204a464783" alt="SSO 인증 완료" width="2048" height="976" data-path="ja/images/sso-entra/25-sso-complete.png" />
</Frame>

***

<ContactKo />