> 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)

SSO는 Roboflow Enterprise 고객에게 제공됩니다.

{% hint style="info" %}
싱글 사인온(SSO)은 **프리미엄** 기능이며 Enterprise에서만 사용할 수 있습니다.

요금제와 각 요금제에 포함된 기능에 대한 최신 정보는 요금 페이지를 참조하세요.
{% endhint %}

Enterprise 고객은 싱글 사인온 인증을 요청할 수 있습니다.

이는 SSO가 있는 소프트웨어 사용에 대한 엔터프라이즈 인증 요구사항이 있는 경우 유용합니다.

싱글 사인온에 대해 자세히 알아보려면 다음에 문의하세요. [Roboflow 영업팀](https://roboflow.com/sales) 또는 계정 담당자에게 문의하세요.

## 설정

### 시작하기 전에

\- Workspace Admin 역할 접근 권한.

\- 워크스페이스에서 SSO가 활성화되어 있음: [Roboflow](https://roboflow.com/sales).

\- 도메인 확인을 위한 DNS 제공업체에 대한 접근 권한

### 1단계 - 도메인 확인

\- 설정 → 구성원 및 역할 → SSO로 이동합니다.

\- 도메인 확인을 클릭합니다 → SSO 설정 포털이 열립니다 → 이메일 도메인을 추가합니다 → TXT 레코드를 복사합니다 → DNS에 추가합니다

<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=""><figcaption></figcaption></figure>

\- 여러 도메인을 지원합니다.

### 2단계 - ID 공급자 연결

\- 하나 이상의 도메인이 확인되면 SSO 설정이 클릭 가능해집니다.

\- SSO 설정을 클릭합니다 → 연결 페이지에서 SSO 설정 포털이 열립니다 → SAML 또는 OIDC를 선택하고 공급자별 설정 마법사를 따릅니다.

### 3단계 - 첫 로그인 테스트

\- Roboflow에서 로그아웃합니다.

\- app.roboflow\.com으로 이동해 확인된 도메인의 업무용 이메일을 입력합니다.

\- ID 공급자로 리디렉션되는지 확인합니다.

## 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 %}

AD 그룹 멤버십은 사용자가 IdP를 통해 로그인할 때마다 새로 고쳐집니다. 사용자가 IdP에서 필수 AD 그룹에서 제거되면 다음 Roboflow 로그인 시 게이팅된 워크스페이스에 대한 접근 권한을 잃게 됩니다.

워크스페이스 접근 게이팅을 구성하려면 다음에 문의하세요. [Roboflow 영업팀](https://roboflow.com/sales) 또는 계정 담당자에게 문의하세요.

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

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

SSO 그룹 매핑이 있는 역할은 각 로그인 시 재조정됩니다:

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

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

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

SSO 그룹 매핑이 있는 사용자 지정 역할의 경우, 다음도 활성화할 수 있습니다. [슈퍼 유저](/get-started/ko/platform/enterprise-features/role-based-access-control.md#super-user-roles) 플래그를 사용해 해당 역할을 통해 전체 워크스페이스 접근 권한을 부여할 수 있습니다.

## 인증 그룹

인증 그룹은 이름이 지정된 워크스페이스 구성원 집합이므로, 사람을 한 명씩이 아니라 팀 단위로 관리할 수 있습니다.

프로젝트 폴더 권한이 있는 워크스페이스에는 설정 아래에 "Auth Groups" 탭이 표시됩니다. "Create Auth Group"을 클릭해 그룹 이름을 지정하고, 매핑되는 ID 공급자 그룹 이름을 나열하세요.

직접 지정한 구성원에는 "Manual" 배지가 표시됩니다. ID 공급자 그룹이 매핑과 일치하는 구성원에는 "SSO" 배지가 표시되며, 이는 각 로그인 시 다시 확인됩니다.

## 사용자 지정 브랜딩

Enterprise SSO 환경은 사용자 지정 브랜딩을 지원하므로 Roboflow 경험이 조직의 시각적 아이덴티티와 일치합니다. 관리자는 엔지니어링 개입 없이 SSO 관리자 패널을 통해 브랜딩을 구성할 수 있습니다.

사용자 지정 가능한 요소는 다음과 같습니다:

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

워크스페이스 관리자는 설정에서 브랜딩을 편집한 다음 "브랜딩"을 선택할 수 있습니다. 변경 사항을 적용하려면 "변경 사항 저장"을 클릭하고, 저장된 브랜딩으로 돌아가려면 "변경 사항 버리기"를 클릭하세요.

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

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