> ## 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.

# Microsoft Entra ID로 SSO 설정하기

> 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/">
        VoicePing 공식 웹사이트 열기
      </Card>
      <Card title="X (Twitter)" icon="x-twitter" href="https://x.com/VoicePingMedia">
        X에서 VoicePing 팔로우하기
      </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>
  </>;

## 싱글 사인온 기능

엔터프라이즈 플랜에서는 Microsoft Entra ID를 사용한 SSO를 설정할 수 있습니다. 이 페이지에서는 Microsoft Entra ID를 IdP로 등록하고 VoicePing에서 SSO를 활성화하는 절차를 설명합니다.

## 사전 요구 사항

<Check>VoicePing 엔터프라이즈 플랜을 계약 중일 것</Check>
<Check>Microsoft Entra ID 계정을 보유할 것</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 프로토콜 설정">
    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 설정**을 열어 서비스 공급자(SP) 정보를 확인합니다.

    <Info>
      오너 또는 매니저만 접근할 수 있습니다.
    </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 클레임에 이메일 주소 포함">
    VoicePing 인증에 필요하므로 SAML 클레임에 사용자의 이메일 주소를 포함합니다.

    <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 Entra ID 계정에 이메일 주소가 설정되어 있는지 확인하세요.

    <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 메타데이터 업로드">
    **Identity Provider** 탭으로 이동합니다. IdP로 Microsoft Entra ID를 선택하고 메타데이터 파일을 업로드한 뒤 변경 사항을 제출합니다.

    <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 입력">
    3\~20자의 고유한 조직 ID를 입력합니다.

    <Warning>
      사용자가 SSO로 로그인할 때 이 조직 ID를 입력해야 합니다.
    </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가 설정되면:

* **오너와 매니저:** SSO 외의 로그인 방법도 사용할 수 있습니다.
* **멤버:** SSO 인증이 필요합니다.

새 사용자를 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 />