옥타로 통합 로그인 설정하기
옥타에서 Lingo.dev용 SAML 앱을 만들고 사용자를 할당한 뒤, 조직에 연결하고 SCIM으로 구성원을 프로비저닝하세요.
이 가이드에서는 SAML 2.0으로 옥타와 Lingo.dev를 연결하는 방법을 안내합니다. 앱 통합을 만들 수 있는 옥타 관리자 계정이 필요하며, Enterprise 요금제를 사용하는 Lingo.dev 조직의 소유자여야 합니다. Lingo.dev의 통합 로그인 작동 방식은 통합 로그인을 참고하세요.
Lingo.dev에서 설정 → 통합 로그인을 열어 두세요. 이 화면에 있는 두 값을 옥타에 복사합니다.
앱 통합 만들기 #
- 옥타 관리 콘솔에 로그인하세요.
- 애플리케이션 → 애플리케이션(최신 관리 콘솔에서는 애플리케이션 및 리소스 → 애플리케이션)으로 이동한 뒤 앱 통합 만들기를 선택하세요.
- SAML 2.0을 선택한 뒤 다음을 선택하세요.
- 앱 이름에
Lingo.dev을 입력한 뒤 다음을 선택하세요.
SAML 설정하기 #
다음 항목을 입력하고 나머지는 기본값으로 두세요.
| 옥타 필드 | 값 |
|---|---|
| 통합 로그인 URL | https://auth.lingo.dev/auth/v1/sso/saml/acs (Lingo.dev의 ACS URL) |
| 수신자 URL 및 대상 URL에 이 값 사용 | 선택됨 |
| 대상 URI (SP 엔터티 ID) | https://auth.lingo.dev/auth/v1/sso/saml/metadata (Lingo.dev의 엔터티 ID) |
| 기본 릴레이 상태 | 빈칸 |
| 이름 ID 형식 | 이메일 주소 |
| 애플리케이션 사용자 이름 | 이메일 |
속성 구문에서 속성을 하나 추가하세요.
| 이름 | 이름 형식 | 값 |
|---|---|---|
email | 지정되지 않음 | user.email |
이름 ID 형식을 이메일 주소로 설정하고 위의 email 속성을 추가하면 옥타가 Lingo.dev에 필요한 이메일 주소를 전송합니다.
최근에 생성된 옥타 조직에서는 앱을 만드는 동안 속성 구문이 표시되지 않습니다. 이 경우 마침을 선택한 후 속성을 추가하세요. 앱의 로그인 탭에서 속성 구문 섹션의 표현식 추가를 선택하세요. 이름에 email을, 표현식에 user.profile.email을 입력한 뒤 저장을 선택하세요.
다음을 선택하세요. 피드백 단계에서 내부 앱을 추가하는 옥타 고객입니다를 선택한 뒤 마침을 선택하세요.
메타데이터 URL 복사하기 #
앱의 로그인 탭에서 메타데이터 세부 정보 섹션의 메타데이터 URL을 복사하세요. 형식은 https://your-company.okta.com/app/exk.../sso/saml/metadata과 같습니다.
사용자 할당하기 #
- 앱의 할당 탭을 여세요.
- 할당을 선택한 뒤 사용자에게 할당 또는 그룹에 할당을 선택하세요.
- 각 사용자 또는 그룹 옆의 할당을 선택한 뒤 완료를 선택하세요.
할당된 사용자만 옥타를 통해 Lingo.dev에 로그인할 수 있습니다.
Lingo.dev에서 연결하기 #
- 설정 → 통합 로그인을 여세요.
- ID 공급자 메타데이터 URL에 옥타 메타데이터 URL을 붙여 넣으세요.
- 이메일 도메인에 회사 이메일 도메인을 쉼표로 구분해 입력하세요.
- 연결을 선택하세요.
도메인이 거부되면 도메인 규칙을 참고하세요.
로그인 테스트하기 #
- 브라우저의 비공개 창을 열고 Lingo.dev 로그인 페이지로 이동하세요.
- 통합 로그인으로 계속을 선택하고, 할당된 사용자의 이메일을 입력한 뒤 로그인을 선택하세요.
- 옥타에 로그인하세요.
조직 구성원으로 로그인된 상태로 Lingo.dev에 돌아옵니다. 조직 페이지에 표시되는 이메일을 확인하세요. 이 이메일은 옥타에서 로그인한 계정의 이메일로, 앞서 입력한 이메일과 다를 수 있습니다. 예를 들어 앱을 설정한 관리자 계정으로 브라우저에 옥타 세션이 이미 열려 있다면, 옥타는 해당 계정으로 계속 진행합니다. 앱에 할당되지 않은 관리자에게는 "사용자가 이 애플리케이션에 할당되지 않았습니다"라는 메시지가 표시됩니다. 따라서 테스트할 때는 비공개 창을 사용해야 합니다.
테스트는 Lingo.dev에서 시작하세요. 옥타 대시보드에 있는 SAML 앱 자체 타일을 누르면 로그인되지 않고, 로그아웃 상태로 Lingo.dev 홈페이지로 이동합니다. 대시보드에서 로그인하려면 옥타 대시보드에서 로그인하기에 설명된 북마크를 추가하세요.
테스트가 성공하면 통합 로그인을 필수로 설정할 수 있습니다. 먼저 활성화하기에 설명된 대로 본인의 통합 로그인 계정을 소유자로 지정하세요.
옥타 대시보드에서 로그인하기 #
구성원이 Lingo.dev 타일을 눌러 로그인할 수 있도록 대시보드 로그인 링크를 여는 북마크 앱을 추가하세요. 그런 다음 구성원에게 북마크만 보이도록 SAML 앱 자체 아이콘을 숨기세요.
- Lingo.dev에서 설정 → 통합 로그인을 열고 대시보드 로그인 링크를 복사하세요. 형식은
https://lingo.dev/auth/sso?domain=example.com과 같습니다. - 옥타 관리 콘솔에서 애플리케이션 → 애플리케이션(최신 관리 콘솔에서는 애플리케이션 및 리소스 → 애플리케이션)으로 이동한 뒤 앱 카탈로그 찾아보기를 선택하세요.
- 북마크 앱을 검색해 선택한 뒤 통합 추가를 선택하세요.
- 일반 설정에서 이름에
Lingo.dev을 입력하고 URL에 링크를 붙여 넣으세요. 사용자에게 애플리케이션 아이콘을 표시하지 않음은 선택하지 않은 상태로 두세요. 완료를 선택하세요. - 북마크의 할당 탭에서 SAML 앱에 할당한 것과 동일한 사용자 또는 그룹을 할당하세요.
- Lingo.dev SAML 앱을 여세요. 일반 탭의 앱 설정에서 편집을 선택하세요.
- 애플리케이션 표시 여부에서 사용자에게 애플리케이션 아이콘을 표시하지 않음과 옥타 모바일 앱에 애플리케이션 아이콘을 표시하지 않음을 선택하세요. 저장을 선택하세요.
SAML 앱에 대한 사용자 할당은 유지하세요. 앱은 숨겨질 뿐, 사용자 로그인은 계속 이 앱이 처리합니다.
이제 구성원에게 Lingo.dev 타일 하나만 표시됩니다. 이 타일을 누르면 Lingo.dev가 열리고, 이메일을 입력할 필요 없이 옥타를 거쳐 로그인된 상태로 돌아옵니다.
SCIM으로 구성원 프로비저닝하기 #
옥타는 SCIM으로 Lingo.dev 구성원을 관리하고 그룹을 통해 역할을 설정할 수 있습니다. 먼저 이 가이드에 따라 통합 로그인을 설정하세요. Lingo.dev의 SCIM 작동 방식은 SCIM으로 구성원 프로비저닝하기를 참고하세요.
- Lingo.dev에서 SCIM 키를 생성하세요.
- 옥타 관리 콘솔에서 Lingo.dev SAML 앱을 여세요. 일반 탭의 앱 설정에서 편집을 선택하세요.
- 프로비저닝을 SCIM으로 설정하고 저장을 선택하세요. 앱에 프로비저닝 탭이 추가됩니다.
- 프로비저닝 탭에서 통합을 열고 편집을 선택하세요.
다음 항목을 입력하세요.
| 옥타 필드 | 값 |
|---|---|
| SCIM 커넥터 기본 URL | https://api.lingo.dev/v2/scim (Lingo.dev의 SCIM 기본 URL) |
| 사용자 고유 식별자 필드 | userName |
| 지원되는 프로비저닝 작업 | 새 사용자 푸시, 프로필 업데이트 푸시, 그룹 푸시. 가져오기 작업은 선택하지 않은 상태로 두세요. 옥타는 Lingo.dev에서 사용자나 그룹을 가져오지 않습니다. |
| 인증 모드 | HTTP 헤더. SCIM 키를 전달자 토큰으로 붙여 넣으세요. |
커넥터 구성 테스트를 선택하세요. 테스트에 성공하면 테스트 창을 닫고 저장을 선택하세요.
프로비저닝 탭에서 앱으로를 열고 편집을 선택하세요. 사용자 생성, 사용자 속성 업데이트, 사용자 비활성화를 켠 뒤 저장을 선택하세요.
사용자 생성 설정을 저장하기 전까지 옥타는 Lingo.dev에 사용자를 전송하지 않습니다. 저장한 후에는 할당하는 사용자마다 Lingo.dev에 대기 중인 초대가 생성되며, 해당 사용자가 통합 로그인으로 처음 로그인하면 구성원이 됩니다.
옥타에서 사용자의 할당을 해제하거나 사용자를 비활성화하면, Lingo.dev에서도 해당 사용자가 비활성화되어 구성원 자격이 제거됩니다. 사용자 제거하기를 참고하세요.
옥타 그룹으로 역할 설정하기 #
- 옥타 그룹 이름이
Translator등 Lingo.dev 역할 이름과 일치하는지 확인하세요. - 앱의 그룹 푸시 탭에서 그룹 푸시를 선택한 뒤 이름으로 그룹 찾기를 선택하세요.
- 그룹을 찾아 저장을 선택하세요.
앱 할당에 사용하는 그룹과는 다른 그룹을 푸시하세요. 옥타에서는 하나의 그룹을 두 용도로 함께 사용할 수 없습니다. 옥타는 앱에 할당된 구성원만 푸시하므로, 푸시할 그룹의 모든 구성원을 직접 또는 다른 그룹을 통해 앱에 할당하세요.
옥타는 그룹을 같은 이름의 역할에 연결합니다. 그룹 구성원에게는 해당 역할이 부여되고, 그룹에서 제거한 사용자는 해당 역할을 잃습니다. 그룹과 같은 이름의 역할이 없으면 푸시할 때 "해당 이름의 역할이 없습니다"라는 오류가 표시됩니다. Lingo.dev에서 역할을 만든 뒤 그룹을 다시 푸시하세요.
그룹 푸시를 중단할 때 옥타에서 앱의 해당 그룹도 삭제할지 묻는 경우, 삭제를 선택하면 그룹 구성원에게 부여된 역할이 해제됩니다. 역할 자체는 Lingo.dev에 그대로 남습니다.
문제 해결 #
| 문제 | 해결 방법 |
|---|---|
| 옥타에 로그인한 후 Lingo.dev에 "통합 로그인이 완료되지 않았습니다"라는 메시지가 표시됩니다. | 대상 URI (SP 엔터티 ID) 와 통합 로그인 URL을 확인하세요. Lingo.dev의 엔터티 ID 및 ACS URL과 정확히 일치해야 하며, 끝에 슬래시가 없어야 합니다. |
| Lingo.dev에 "ID 공급자가 이메일 주소를 보내지 않았습니다"라는 메시지가 표시됩니다. | 이름 ID 형식을 이메일 주소로, 애플리케이션 사용자 이름을 이메일로 설정하고 email 속성 구문을 추가하세요. 설정 마법사에서는 user.email을, 로그인 탭에서는 user.profile.email을 사용하세요. |
| 옥타에 앱에 할당되지 않았다는 메시지가 표시됩니다. | 할당 탭에서 해당 사용자 또는 사용자가 속한 그룹을 할당하세요. 할당된 사용자의 이메일을 입력했는데 옥타에 관리자 계정이 표시된다면 브라우저에 옥타 세션이 남아 있는 것입니다. 옥타에서 로그아웃하거나 비공개 창을 사용하세요. |
| Lingo.dev에 "통합 로그인을 완료하는 데 너무 오래 걸렸습니다. 다시 시도하세요."라는 메시지가 표시됩니다. | 최초 다중 인증 설정 등의 이유로 옥타 로그인에 약 5분 이상 걸린 경우입니다. Lingo.dev에서 다시 시도하세요. 다음 시도에서는 정상적으로 로그인됩니다. |
| Lingo.dev에 "로그인했지만 조직에 추가하지 못했습니다."라는 메시지가 표시됩니다. | 통합 로그인으로 다시 로그인하세요. 계속 실패하면 소유자에게 설정 → 통합 로그인에 연결 시작일이 표시되는지 확인해 달라고 요청하세요. |
| Lingo.dev에 해당 도메인에 대해 "통합 로그인이 설정되어 있지 않습니다"라는 메시지가 표시됩니다. | 설정 → 통합 로그인에서 도메인을 추가하거나 입력한 이메일을 확인하세요. |
커넥터 구성 테스트 또는 프로비저닝이 401 Unauthorized 오류로 실패합니다. | SCIM 키가 교체되었거나 폐기된 경우입니다. 통합에 현재 키를 붙여 넣거나 Lingo.dev에서 새 키를 생성하세요. |
| 옥타에서 할당한 사용자가 설정 → 팀의 초대 탭에 표시되지 않습니다. | 앱으로에서 사용자 생성이 켜져 있는지 확인하세요. 이 설정을 저장하기 전에 할당한 사용자는 옥타의 프로비저닝 작업 목록에서 해당 작업을 다시 시도하세요. |
그 밖의 메시지는 문제 해결을 참고하세요.