> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ko/platform/enterprise-features/single-sign-on-sso.md).

# 싱글 사인온(SSO)

팀이 ID 공급자를 통해 Roboflow에 로그인할 수 있도록 싱글 사인온(SSO)을 설정하세요.

{% hint style="info" %}
이 기능은 다음에서 사용할 수 있습니다. [Teams 애드온](https://docs.roboflow.com/get-started/ko/platform/billing-and-plans/teams-add-on.md) 및 Enterprise 워크스페이스. 자세한 내용은 [요금 페이지](https://roboflow.com/pricing) 를 참조하세요.
{% endhint %}

Single Sign On을 사용하면 팀이 회사의 ID 공급자를 통해 Roboflow에 로그인할 수 있습니다.

Teams에서는 워크스페이스 관리자가 "SSO" 탭에서 직접 SSO를 설정할 수 있습니다. Enterprise에서는 [Roboflow 영업팀](https://roboflow.com/sales) 또는 계정 담당자에게 문의하여 "SSO" 탭을 활성화하거나 Roboflow에 SSO 설정을 요청하세요. 이후 섹션에서는 [SSO로 로그인하기](#signing-in-with-sso) 에 대해 Enterprise 옵션을 다룹니다.

## 설정

설정하려면 도메인의 DNS 레코드를 추가하고 값(예: 클라이언트 ID, 리디렉션 URL)을 ID 공급자의 관리 콘솔에 복사할 수 있는 사람이 필요합니다. 관리자이거나 "Single Sign-On 관리" 권한이 있는 역할이어야 합니다.

1. Settings로 이동하여 "Team Members"를 클릭한 다음 "SSO" 탭을 엽니다.
2. "Enable Single Sign-On"을 클릭합니다.
3. "Domain Verification" 아래에서 "Verify Domain"을 클릭합니다. 새 탭에서 Admin Portal이 열립니다. 이메일 도메인을 추가한 다음 DNS 공급자에 표시된 TXT 레코드를 추가합니다. 도메인을 더 추가하려면 "Verify Another Domain"을 클릭합니다.
4. "SSO" 탭으로 돌아갑니다. 각 도메인의 상태는 "Pending", "Verified" 또는 "Failed"로 표시됩니다.
5. 하나 이상의 도메인 상태가 "Verified"로 표시되면 "Single Sign-On" 아래의 "Set up SSO"를 클릭합니다. Admin Portal에서 ID 공급자를 선택하고 안내에 따릅니다.
6. "SSO" 탭으로 돌아갑니다. 연결이 작동하면 "Single Sign-On" 카드에 "Active"가 표시됩니다. 나중에 변경하거나 교체하려면 "Manage SSO"를 클릭합니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-9699b26fdb309da6b889e798801a544c358f74e6%2Fimage%20(79).png?alt=media" alt="The SSO tab with the Domain Verification and Single Sign-On cards"><figcaption></figcaption></figure>

테스트하려면 Roboflow에서 로그아웃한 다음 [SSO로 로그인](#signing-in-with-sso) 을 클릭하고 인증된 도메인의 회사 이메일을 사용합니다. ID 공급자의 로그인 페이지로 이동해야 합니다.

아직 구성원이 아닌 사용자가 SSO로 로그인하면 Roboflow는 해당 사용자를 관리자로 워크스페이스에 추가합니다. 워크스페이스에서 [사용자 지정 역할](https://docs.roboflow.com/get-started/ko/platform/enterprise-features/role-based-access-control.md#custom-roles)을 사용하는 경우에는 기본 역할로 추가합니다. "Members" 탭에서 구성원의 역할을 변경할 수 있습니다.

## SSO로 로그인하기

Roboflow 로그인 페이지에는 Google, GitHub, 이메일 로그인 옵션과 함께 "Continue with SSO" 버튼이 있습니다. SSO로 로그인하려면 다음을 따르세요.

1. 로그인 페이지에서 "Continue with SSO"를 클릭합니다.
2. 회사 이메일 주소를 입력합니다.
3. 이메일 도메인에 SSO가 구성되어 있으면 인증을 완료하기 위해 소속 조직의 ID 공급자로 리디렉션됩니다.

도메인에 SSO가 구성되어 있지 않으면 인라인 오류가 표시됩니다. 워크스페이스 관리자 또는 [Roboflow 영업팀](https://roboflow.com/sales) 에 문의하여 조직의 SSO를 설정하세요.

## SSO 프로필 기반 권한 부여 그룹

SSO를 사용하는 Enterprise 고객은 **권한 부여 그룹 속성** 을 구성하여 Active Directory(AD) 그룹 멤버십과 같은 ID 공급자(IdP) 프로필 속성을 기준으로 사용자를 Roboflow 권한 부여 그룹에 자동으로 할당할 수 있습니다.

사용자가 SSO를 통해 로그인하면 Roboflow는 SSO 프로필의 `sign_in_attributes` 에서 지정된 속성을 읽어 Roboflow 권한 부여 그룹에 매핑합니다. 이를 통해 Roboflow에서 그룹을 수동으로 할당하는 대신 IdP를 통해 액세스 제어를 관리할 수 있습니다.

## 프로필 속성에서 계정 이메일 가져오기

Roboflow는 이메일 클레임이 아닌 다른 IdP 프로필 속성(예: `gevemail`)에서 계정 이메일을 설정할 수 있습니다. 계정 담당자에게 속성 이름을 알려주세요. 값이 없거나 유효하지 않거나 SSO 이메일 도메인에 속하지 않으면 사용자의 현재 이메일이 유지됩니다.

## AD 그룹을 기준으로 워크스페이스 액세스 제한

Enterprise SSO 환경에서는 AD 그룹 멤버십을 기준으로 워크스페이스별 액세스 제한을 설정할 수 있습니다. SSO 환경에서 허용된 각 워크스페이스에 다음을 구성할 수 있습니다.

* **필수 AD 그룹**: 지정된 AD 그룹 중 하나 이상에 속한 사용자만 워크스페이스에 액세스할 수 있습니다. 조건을 더 이상 충족하지 않는 사용자는 다음 로그인 시 액세스 권한을 잃습니다.
* **자동 참여**: 이 기능을 사용 설정하면 필수 AD 그룹을 충족하는 사용자(그룹이 구성되지 않은 경우 모든 SSO 사용자)가 초대 없이 로그인할 때 워크스페이스에 자동으로 추가됩니다.

이 옵션은 워크스페이스별로 조합할 수 있습니다.

| 필수 AD 그룹 | 자동 참여 | 동작                                                 |
| -------- | ----- | -------------------------------------------------- |
| 설정되지 않음  | 꺼짐    | 기본값: 관리자가 사용자를 직접 초대해야 함                           |
| 설정되지 않음  | 켜짐    | 모든 SSO 사용자가 워크스페이스에 자동으로 추가됨                       |
| 설정됨      | 꺼짐    | 기존 구성원 중 조건에 맞지 않는 사용자는 제거되지만, 신규 사용자는 여전히 초대가 필요함 |
| 설정됨      | 켜짐    | 조건에 맞는 사용자는 자동으로 추가되고, 조건에 맞지 않는 구성원은 제거됨          |

{% hint style="info" %}
Roboflow 관리자는 AD 그룹 제한에서 제외되며 항상 워크스페이스에 액세스할 수 있습니다. SSO 환경의 기본 워크스페이스에는 제한이 적용되지 않습니다.
{% endhint %}

사용자가 IdP를 통해 로그인할 때마다 AD 그룹 멤버십이 새로 고쳐집니다. IdP에서 사용자가 필수 AD 그룹에서 제거되면, 다음번 Roboflow 로그인부터 제한된 워크스페이스에 액세스할 수 없게 됩니다.

워크스페이스 액세스 제한을 구성하려면 [Roboflow 영업팀](https://roboflow.com/sales) 또는 담당 계정 관리자에게 문의하세요.

## SSO 그룹을 통한 사용자 지정 역할 매핑

워크스페이스에서 [사용자 지정 역할](https://docs.roboflow.com/get-started/ko/platform/enterprise-features/role-based-access-control.md#custom-roles) 을 활성화하면 ID 공급자 그룹을 사용자 지정 역할에 매핑할 수 있습니다. 사용자가 SSO로 로그인하면 Roboflow는 매핑된 그룹이 해당 사용자의 ID 공급자 그룹 멤버십과 일치하는 사용자 지정 역할을 할당합니다.

SSO 그룹 매핑이 있는 역할은 로그인할 때마다 동기화됩니다.

* 일치하는 그룹이 있는 역할은 자동으로 할당됩니다.
* 매핑된 그룹이 더 이상 사용자와 일치하지 않는 역할은 제거됩니다.
* SSO 그룹 매핑이 없는 역할(수동으로 할당한 역할)은 유지되며 SSO 동기화의 영향을 받지 않습니다.

구성원이 그룹 매핑 역할을 모두 잃고 수동으로 할당된 역할도 없는 경우, 워크스페이스의 기본 역할이 할당됩니다.

ID 공급자 그룹이 둘 이상의 매핑된 역할과 일치하면 구성원은 여러 사용자 지정 역할을 동시에 보유할 수 있습니다. 워크스페이스의 구성원 페이지에는 각 구성원이 현재 보유한 모든 역할이 표시됩니다.

SSO 그룹 매핑이 있는 사용자 지정 역할에는 [슈퍼 사용자](https://docs.roboflow.com/get-started/ko/platform/enterprise-features/role-based-access-control.md#super-user-roles) 플래그를 활성화하여 해당 역할을 통해 워크스페이스 전체 액세스 권한을 부여할 수도 있습니다.

## 인증 그룹

인증 그룹은 워크스페이스 구성원을 이름이 지정된 그룹으로 묶어, 사람들을 한 명씩이 아니라 팀 단위로 관리할 수 있게 해줍니다.

프로젝트 폴더 권한이 있는 워크스페이스의 경우 설정 아래에 "인증 그룹" 탭이 표시됩니다. "인증 그룹 만들기"를 클릭해 그룹 이름을 지정하고, 매핑할 ID 공급자 그룹 이름을 입력하세요.

직접 할당한 구성원에게는 "수동" 배지가 표시됩니다. ID 공급자 그룹이 매핑과 일치하는 구성원에게는 "SSO" 배지가 표시되며, 로그인할 때마다 일치 여부를 다시 확인합니다.

## 사용자 지정 브랜딩

엔터프라이즈 SSO 환경은 사용자 지정 브랜딩을 지원하므로 Roboflow 환경을 조직의 시각적 정체성에 맞출 수 있습니다. 관리자는 엔지니어링 팀의 도움 없이 SSO 관리자 패널에서 브랜딩을 구성할 수 있습니다.

사용자 지정할 수 있는 요소는 다음과 같습니다.

* **로그인 화면**: 조직 로고, 로고 크기, 강조 색상, 카드 배경 및 테두리 색상, 버튼 색상, Roboflow 워드마크 색상.
* **사이드바 탐색**: 배경 호버 색상, 선택 및 선택 해제 상태의 텍스트와 아이콘 색상, 로고 테두리 색상.
* 로딩 아이콘: 페이지가 로드되는 동안 재생되는 로딩 애니메이션을 대체하는 이미지입니다. 최대 2MB의 애니메이션 GIF 또는 WebP를 사용하세요(PNG 및 JPEG도 지원). SVG는 지원되지 않습니다.

워크스페이스 관리자는 설정에서 "브랜딩"을 선택해 브랜딩을 편집할 수 있습니다. "변경 사항 저장"을 클릭해 변경 사항을 적용하거나, "변경 사항 취소"를 클릭해 저장된 브랜딩으로 되돌리세요.

변경 사항은 SSO 환경의 모든 사용자에게 즉시 적용됩니다. SSO 환경 외부의 사용자는 영향을 받지 않습니다.

사용자 지정 브랜딩을 설정하려면 [Roboflow 영업팀](https://roboflow.com/sales) 또는 담당 계정 관리자에게 문의하세요.
