> For the complete documentation index, see [llms.txt](https://guide.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.roundhr.com/setting/integrations/services/sso.md).

# SSO 연동

SSO 연동은 사내 도메인 계정(SAML 2.0)으로 라운드HR에 로그인하도록 설정해 조직의 로그인 방식을 통제하고 보안을 강화하는 기능입니다.

## 개요

**SSO(Single Sign-On) 연동**은 임직원이 사내 도메인 계정으로 라운드HR에 로그인하도록 설정하는 기능입니다. 별도 회원가입 없이 사내 계정으로 접근할 수 있어, 조직의 로그인 방식을 통제하고 보안을 강화할 수 있습니다.

### 핵심 이점

* **간편한 접근:** 임직원이 기존 사내 도메인 계정으로 별도 가입 없이 로그인합니다.
* **중앙 관리:** 관리자가 사내 시스템의 보안 토큰으로 사용자 접근 활성화 여부를 통제합니다.

{% hint style="success" %}
SSO 연동 도입 및 관련 문의는 전문 컨설턴트가 안내해 드립니다. 아래 문의하기로 폼을 제출해 주시면 연락드리겠습니다. ([**문의하기 >**](https://round.channel.io))
{% endhint %}

## 사전 준비

* **SAML 2.0**을 지원합니다. Okta는 OIDC 기반 SSO도 별도로 지원합니다.
* 자체 IdP, Okta, MS Azure AD, 메가존 등 IdP에서 이용할 수 있습니다.

***

## Google SAML 설정하기

1. 구글 관리 콘솔 > [웹 및 모바일 앱](https://admin.google.com/ac/apps/unified)으로 이동합니다.
2. **앱 추가** 버튼을 클릭합니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-286175971b1342b2a5e77107aad9d773f647b0eb%2Fset_integ_services_sso_s0_01.png?alt=media" alt="구글 관리 콘솔의 웹 및 모바일 앱에서 앱 추가 버튼을 클릭하는 화면"><figcaption><p>Google SAML 앱 추가</p></figcaption></figure>

3. **앱 세부정보**에서 앱 이름을 `roundHR`로 입력합니다.
4. **Google ID 공급업체 세부정보**에서 메타데이터를 다운로드해 roundHR에 전달합니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-54c2376ff75ee7bc68bbef692fae6ca964ad52f5%2Fset_integ_services_sso_s0_02.png?alt=media" alt="Google ID 공급업체 세부정보 확인 화면"><figcaption><p>ID 공급업체 세부정보</p></figcaption></figure>

5. **서비스 제공업체 세부정보**를 아래와 같이 입력합니다.
   * ACS URL: `https://link.roundhr.com/auth/saml/<id>/callback`
   * 엔티티 ID: `roundHR`
   * 시작 URL: `https://link.roundhr.com/auth/saml/<id>`
   * `<id>`에 들어갈 값은 라운드HR에서 별도로 전달합니다.
   * 이름 아이디 형식은 기본 설정 그대로 저장합니다.
6. **속성 매핑**은 빈 값으로 두고 마칩니다.

{% hint style="info" %}
추가로 궁금한 점이 있다면 [Google 가이드](https://support.google.com/a/answer/6087519)를 참고하세요.
{% endhint %}

***

## 자주 묻는 질문

<details>

<summary>어떤 SSO 프로토콜을 지원하나요?</summary>

SAML 2.0을 지원하며, Okta는 OIDC 기반 SSO도 별도로 지원합니다. 자체 IdP를 비롯해 Okta, MS Azure AD, 메가존 등 다양한 IdP에서 이용할 수 있습니다.

</details>

<details>

<summary>SSO를 도입하려면 어떻게 시작하나요?</summary>

전문 컨설턴트가 도입을 안내합니다. [문의하기](https://round.channel.io)로 폼을 제출하면 연락드리며, 설정에 필요한 `<id>` 값 등을 전달해 드립니다.

</details>

<details>

<summary>Google SAML 설정에서 속성 매핑은 어떻게 하나요?</summary>

속성 매핑은 빈 값으로 두고 마치면 됩니다. 서비스 제공업체 세부정보(ACS URL, 엔티티 ID, 시작 URL)를 입력하고 이름 아이디 형식은 기본 설정 그대로 저장하세요.

</details>