통합 로그인
구성원이 회사의 인증 공급자를 통해 SAML로 로그인하도록 하고, 조직에서 이 로그인 방식을 필수로 설정하세요.
통합 로그인(SSO)을 사용하면 회사 구성원이 옥타나 마이크로소프트 엔트라 아이디 같은 인증 공급자를 통해 Lingo.dev에 로그인할 수 있습니다. SAML 2.0으로 인증 공급자를 한 번만 연결하면 됩니다. 이후에는 인증 공급자가 로그인을 허용하고 연결된 도메인의 이메일 주소를 사용하는 사람이 처음 로그인할 때 초대 없이 조직에 가입합니다.
통합 로그인을 필수로 설정할 수도 있습니다. 이 경우 인증 공급자를 통해 로그인한 사람만 조직에 접근할 수 있습니다.
시작하기 전에 #
- 통합 로그인을 사용하려면 Enterprise 요금제가 필요합니다. 결제 및 기능 이용 권한을 참고하세요.
- 설정 → 통합 로그인에서 설정할 수 있습니다.
- 소유자만 통합 로그인을 연결하거나 변경하고, 필수로 설정하거나 연결을 해제할 수 있습니다.
org:manage_settings권한이 있어도 소유자가 아닌 구성원은 설정을 볼 수만 있고 변경할 수는 없습니다. 이들에게는 다음 메시지가 표시됩니다. "소유자만 통합 로그인 설정을 변경할 수 있습니다. 이 조직의 소유자에게 변경을 요청하세요." 역할 및 권한을 참고하세요. - 소유자는 Lingo.dev 조직에서 소유자 역할을 가진 사람을 뜻합니다. 옥타나 마이크로소프트 엔트라 아이디의 관리자라고 해서 소유자 역할이 부여되지는 않습니다. 인증 공급자 관리자가 해당 서비스에서 앱을 설정하면 Lingo.dev 소유자가 이를 연결합니다.
- 인증 공급자를 제어하는 사람은 소유자를 포함해 통합 로그인을 사용하는 모든 구성원의 계정으로 로그인할 수 있습니다. 따라서 통합 로그인 설정은 소유자만 변경할 수 있습니다.
- 통합 로그인 필수를 켜려면 인증 공급자를 통해 로그인한 소유자여야 합니다. 켜기를 참고하세요.
- 연결하려는 도메인의 인증된 이메일 주소로 비밀번호, 이메일 링크 또는 구글을 사용해 Lingo.dev에 로그인하세요.
- 인증 공급자가 SAML 2.0을 지원해야 합니다.
인증 공급자에 입력할 값 #
설정 → 통합 로그인에 다음 값이 복사 버튼과 함께 표시됩니다. 이 값은 모든 조직에서 동일합니다.
| Lingo.dev 항목 | 값 | 옥타 필드 | 마이크로소프트 엔트라 아이디 필드 |
|---|---|---|---|
| 엔터티 식별자 | https://auth.lingo.dev/auth/v1/sso/saml/metadata | 대상 URI(서비스 공급자 엔터티 식별자) | 식별자(엔터티 식별자) |
| 인증 응답 수신 URL | https://auth.lingo.dev/auth/v1/sso/saml/acs | 통합 로그인 URL | 회신 URL(인증 응답 수신 서비스 URL) |
| 서비스 공급자 메타데이터 | https://auth.lingo.dev/auth/v1/sso/saml/metadata | 필요 없음 | 필요 없음 |
인증 공급자가 URL에서 이 설정을 읽어 올 수 있는 경우에만 서비스 공급자 메타데이터 URL을 사용하세요.
통합 로그인을 연결하면 설정 → 통합 로그인에 조직의 대시보드 로그인 링크도 표시됩니다. 이 링크는 SAML 앱이 아니라 대시보드 타일에 사용합니다. 대시보드 타일에서 로그인하기를 참고하세요.
SAML 응답에는 사용자의 이메일 주소가 포함되어야 합니다.
- 옥타에서 이름 식별자 형식을 이메일 주소로 설정하고
email속성 구문을 추가하세요. - 마이크로소프트 엔트라 아이디의 엔트라 관리 센터에서 만든 앱은 기본적으로
emailaddress클레임과 이메일 형식의 이름 식별자를 보냅니다. API로 만드는 경우처럼 기본 클레임 없이 생성한 앱은 이메일을 보내지 않습니다. 특성 & 클레임에서 이메일 클레임(user.mail)을 추가하세요.
인증 공급자 연결하기 #
- 인증 공급자에서 위의 값으로 Lingo.dev용 SAML 앱을 만드세요. 단계별 안내는 옥타 및 마이크로소프트 엔트라 아이디를 참고하세요.
- Lingo.dev를 사용할 사용자나 그룹을 할당하세요.
- 앱의 SAML 메타데이터 URL을 복사하세요. 이 URL의 시작 부분은
https://입니다. - Lingo.dev에서 설정 → 통합 로그인을 여세요.
- 인증 공급자 메타데이터 URL에 URL을 붙여 넣으세요.
- 이메일 도메인에 회사의 이메일 도메인을 쉼표로 구분해 입력하세요. 예:
example.com, eu.example.com. - 연결을 선택하세요.
이제 상태에 연결 시작일과 날짜가 표시됩니다. 연결을 테스트하려면 비공개 브라우저 창을 열고 구성원 로그인 방법에 따라 할당된 사용자 중 한 명의 계정으로 로그인하세요.
도메인 규칙 #
- 각 도메인은 본인 이메일 주소의 도메인이거나 그 하위 도메인이어야 합니다. 로그인한 이메일 주소가
jane@example.com인 경우 추가할 수 있는 도메인은example.com및eu.example.com이며,example.org은 추가할 수 없습니다. 다른 도메인을 추가하려면 해당 도메인의 이메일 주소를 사용하는 관리자에게 요청하세요. gmail.com또는yahoo.es같은 무료 및 일회용 이메일 서비스의 도메인과 그 하위 도메인은 허용되지 않습니다.lingo.dev도 허용되지 않습니다.- 추가한 도메인과 정확히 일치하는 이메일 도메인을 사용하는 구성원만 가입할 수 있습니다.
example.com을 추가해도eu.example.com은 포함되지 않습니다. 구성원이 로그인에 사용하는 하위 도메인을 각각 추가하세요. acme.net.ua또는acme.co.uk처럼 국가별 2단계 등록 도메인 아래에 있는 회사 도메인은 사용할 수 있습니다.net.ua같은 등록 도메인 자체는 허용되지 않습니다.- 하나의 도메인은 하나의 조직에만 속할 수 있습니다. 다른 조직에서 이미 사용 중이라면 support@lingo.dev로 이메일을 보내 이전을 요청하세요.
- 한 번 추가한 도메인은 조직에 계속 연결됩니다. 통합 로그인 연결을 해제한 뒤에도 도메인을 삭제할 수 없습니다.
- 새 도메인을 추가하려면 소유자 계정으로 비밀번호, 이메일 링크 또는 구글을 사용해 로그인하세요. 통합 로그인으로 만든 계정은 도메인을 추가할 수 없습니다.
연결 변경하기 #
도메인을 추가하거나 메타데이터 URL을 변경하려면 설정 → 통합 로그인에서 필드를 수정하고 저장을 선택하세요. 소유자만 변경할 수 있으며 Enterprise 요금제가 필요합니다.
하나의 인증 공급자는 하나의 조직에만 연결할 수 있습니다. 조직의 인증 공급자를 다른 공급자로 바꾸거나 다른 조직에 연결된 인증 공급자를 이전하려면 support@lingo.dev로 이메일을 보내세요.
인증 공급자가 서명 인증서를 교체하면 설정 → 통합 로그인을 열고 필드를 수정하지 않은 채 저장을 선택하세요. 그러면 URL에서 새 인증서가 포함된 메타데이터를 다시 불러옵니다. Lingo.dev가 새 인증서를 자동으로 가져온다고 가정하지 마세요. 저장을 선택하기 전까지는 "통합 로그인을 완료하지 못했습니다"라는 메시지와 함께 로그인이 실패할 수 있습니다.
구성원 로그인 방법 #
- Lingo.dev 로그인 페이지에서 통합 로그인으로 계속을 선택하세요.
- 업무용 이메일을 입력하고 로그인을 선택하세요.
- 회사 로그인 페이지에서 로그인하세요.
- 조직의 구성원으로 로그인된 상태로 Lingo.dev에 돌아옵니다.
입력한 이메일은 회사의 인증 공급자를 찾는 데만 사용됩니다. 로그인 허용 여부는 인증 공급자가 결정합니다. 브라우저에서 이미 해당 공급자에 로그인한 상태라면 대개 비밀번호를 다시 묻지 않고 그 계정으로 진행합니다. 이후 Lingo.dev는 인증 공급자가 보내는 이메일 주소를 사용합니다.
Lingo.dev에서 로그아웃해도 인증 공급자에서는 로그아웃되지 않습니다. 해당 세션이 유지되는 동안에는 통합 로그인으로 계속을 다시 선택하면 곧바로 로그인됩니다.
처음 통합 로그인할 때 해당 사용자가 조직에 추가됩니다. 초대는 필요하지 않습니다.
- 사용 중인 요금제에서 역할이 적용되는 경우 역할 없이 가입합니다. 설정 → 팀에서 역할을 부여하세요. 팀을 참고하세요.
- 역할이 적용되지 않는 경우 소유자로 가입합니다.
SCIM으로 추가된 사용자는 초대에 지정된 역할로 가입합니다. SCIM으로 구성원 프로비저닝하기를 참고하세요.
CLI(lingo login)와 MCP 클라이언트에서도 통합 로그인으로 계속 옵션이 있는 Lingo.dev 로그인 페이지가 열립니다.
통합 로그인은 별도 계정을 만듭니다
처음 통합 로그인하면 같은 이메일 주소로 비밀번호, 이메일 링크 또는 구글을 사용하는 계정이 이미 있어도 새 Lingo.dev 계정이 만들어집니다. 두 계정은 병합되지 않습니다. 기존 계정의 역할, 소속 조직, 개인 API 키는 통합 로그인 계정으로 이전되지 않습니다.
팀 목록에 같은 이메일 주소가 기존 계정과 통합 로그인 계정으로 두 번 표시될 수 있습니다. 통합 로그인 계정에 해당 사용자가 필요로 하는 역할을 부여하세요. 기존 계정은 더 이상 필요하지 않을 때 삭제하세요.
대시보드 타일에서 로그인하기 #
구성원은 옥타 대시보드나 마이크로소프트 내 앱의 Lingo.dev 타일에서도 로그인할 수 있습니다. 타일을 누르면 설정 → 통합 로그인의 대시보드 로그인 링크가 열리도록 설정해야 합니다. 이 링크는 처음 연결한 도메인을 사용하며 https://lingo.dev/auth/sso?domain=example.com 형식입니다.
이 링크를 사용하면 Lingo.dev에서 로그인이 시작되므로 구성원이 이메일을 입력할 필요가 없습니다. 통합 로그인으로 계속을 선택했을 때와 마찬가지로 인증 공급자로 이동한 뒤 로그인된 상태로 돌아옵니다.
- 옥타에서 해당 링크를 사용하는 북마크 앱을 추가하고 SAML 앱 자체의 아이콘은 숨기세요. 옥타 대시보드에서 로그인하기를 참고하세요.
- 마이크로소프트 엔트라 아이디의 SAML 앱에서 로그온 URL에 링크를 붙여 넣으세요. 마이크로소프트 내 앱에서 로그인하기를 참고하세요.
이 링크가 없으면 SAML 앱 자체의 타일로는 로그인할 수 없습니다. 로그인되지 않은 상태로 Lingo.dev 홈페이지에 도착합니다.
통합 로그인 필수 설정 #
통합 로그인 필수를 켜면 다음이 적용됩니다.
- 이 조직에 접근하려면 인증 공급자를 통해 로그인해야 합니다.
- 비밀번호, 이메일 링크 또는 구글로는 이 조직에 접근할 수 없게 됩니다. 이러한 방식으로 로그인하는 것 자체는 여전히 가능하며 다른 조직에는 영향을 주지 않습니다. 사용자의 조직 목록에서 이 조직에는 통합 로그인 필수가 표시되며, 조직을 열면 통합 로그인으로 계속 진행하라는 안내가 나옵니다.
- 통합 로그인으로 가입하지 않은 계정에서 만든 개인 API 키는 이 조직에서 작동하지 않습니다.
- 조직 서비스 키는 Lingo.dev API 전반에서 계속 작동합니다. 지속적 통합과 기타 자동화에는 조직 서비스 키를 사용하세요. API 키를 참고하세요.
- 통합 로그인으로 인증하지 않은 계정에 연결된 MCP 클라이언트는 이 조직을 사용할 수 없습니다. 통합 로그인한 뒤 다시 연결하세요. MCP 연결 설정을 참고하세요.
켜기 #
통합 로그인 필수를 켜려면 인증 공급자를 통해 로그인한 소유자여야 합니다. 통합 로그인 계정은 별도 계정이므로 기존 계정의 소유자 역할이 이전되지 않습니다. 시작하기 전에 통합 로그인 계정을 소유자로 지정하세요.
- 통합 로그인으로 계속을 선택해 Lingo.dev에 로그인하세요. 그러면 통합 로그인 계정이 조직에 추가됩니다.
- 사용 중인 요금제에서 역할이 적용되는 경우 통합 로그인 계정은 역할 없이 가입합니다. 기존 소유자 계정으로 설정 → 팀에서 통합 로그인 계정을 소유자로 지정하세요. 역할이 적용되지 않는 경우에는 이미 소유자로 가입된 상태입니다.
- 통합 로그인 계정으로 로그인한 상태에서 설정 → 통합 로그인을 열고 통합 로그인 필수를 켜세요.
인증 공급자를 통해 로그인하기 전까지는 스위치를 켤 수 없습니다. 비밀번호로 로그인한 상태에서 이 설정을 켰다가 본인도 조직에 접근하지 못하게 되는 일을 방지하기 위한 조치입니다.
끄기 #
소유자는 설정 → 통합 로그인에서 통합 로그인 필수를 끌 수 있습니다. 그러면 비밀번호, 이메일 링크 또는 구글로 다시 조직에 접근할 수 있습니다. 사용 중인 요금제가 더 이상 통합 로그인을 지원하지 않더라도 이 설정은 끌 수 있습니다.
접근 경로를 유지하세요
통합 로그인이 필수인 동안에는 통합 로그인 계정만 조직과 조직 설정에 접근할 수 있습니다. 인증 공급자를 통해 로그인하는 소유자를 한 명 이상 유지하세요. Lingo.dev는 이 조건을 충족하는 마지막 소유자가 탈퇴하거나 소유자 역할을 내려놓지 못하도록 합니다. 인증 공급자가 작동하지 않으면 support@lingo.dev로 이메일을 보내세요.
SCIM으로 구성원 프로비저닝하기 #
SCIM을 사용하면 인증 공급자에서 조직 구성원을 관리할 수 있습니다. Lingo.dev 앱에 사용자를 할당하면 초대가 생성되고, 할당을 해제하면 조직에서 제거됩니다. 역할은 그룹으로 설정하며, 로그인에는 계속 통합 로그인을 사용합니다.
설정 방법은 옥타 및 마이크로소프트 엔트라 아이디 안내를 참고하세요.
SCIM 설정 전 확인 사항 #
- 통합 로그인이 연결되어 있어야 하며, 연결하려면 Enterprise 요금제가 필요합니다.
- 소유자만 설정 → 통합 로그인에서 SCIM 키를 확인하고 생성, 교체 또는 폐기할 수 있습니다.
- SCIM 키는 선택한 역할의 권한으로 작업을 수행합니다. 해당 역할에는
org:manage_team권한이 포함되어야 하며 소유자 역할은 선택할 수 없습니다. 역할 및 권한을 참고하세요. - 키에 지정된 역할이 부여하려는 역할의 모든 권한을 가지고 있어야만 그룹을 통해 해당 역할을 설정할 수 있습니다.
SCIM 키 생성하기 #
- 설정 → 통합 로그인을 여세요. 통합 로그인 필수 아래에 SCIM 기본 URL과 SCIM 키가 있습니다.
- SCIM 키 옆에서 키가 사용할 역할을 선택하세요.
- 키 생성을 선택하세요.
- 키를 복사해 안전하게 보관하세요. Lingo.dev에서는 키가 한 번만 표시됩니다. 그런 다음 보관했습니다를 선택하세요.
- SCIM 기본 URL을 복사하세요:
https://api.lingo.dev/v2/scim.
인증 공급자는 키를 전달자 토큰으로 사용해 기본 URL로 전송합니다. 이 키는 SCIM에만 사용할 수 있으며 다른 API 키와 함께 목록에 표시되지 않습니다.
키에 지정할 수 있는 역할이 없으면 역할 선택기에 역할 없음이 표시되고 키 생성은 비활성화됩니다. 먼저 소유자가 아닌 역할에 org:manage_team 권한을 부여하세요.
사용자 할당하기 #
- Lingo.dev 앱에 사용자를 할당하면 설정 → 팀의 초대 탭에 대기 중인 초대가 생성됩니다. 이메일은 발송되지 않으며 초대는 100년 후에 만료됩니다.
- 사용자가 처음 통합 로그인하면 초대에 지정된 역할로 조직 구성원이 됩니다.
- 이미 구성원인 사용자는 초대를 새로 만들지 않고 SCIM을 통해 기존 구성원 정보에 연결됩니다.
- SCIM은 연결된 도메인의 이메일 주소만 허용합니다. 그 외의 이메일 주소를 사용하는 사용자는 인증 공급자에 오류가 표시됩니다.
- SCIM으로 전송되지 않은 사용자도 처음 통합 로그인할 때 가입할 수 있습니다. 구성원 로그인 방법을 참고하세요.
그룹으로 역할 설정하기 #
Translator처럼 Lingo.dev 역할과 이름이 같은 그룹을 푸시하세요. 대소문자는 구분하지 않습니다. 그룹 구성원에게 해당 역할이 부여되며, 그룹에서 사용자를 제거하면 역할이 해제됩니다.- 그룹으로는 사용자를 소유자로 지정하거나 소유자의 역할을 변경할 수 없습니다. 소유자는 설정 → 팀에서 관리하세요.
- 이름이 일치하는 역할이 없는 그룹은 거부되며 인증 공급자에 오류가 표시됩니다. 먼저 Lingo.dev에서 역할을 만드세요.
- 각 사용자는 하나의 역할만 가질 수 있습니다. 푸시된 여러 그룹에 속해 있다면 마지막으로 푸시된 그룹의 역할이 적용됩니다.
- Lingo.dev에서 역할 이름을 변경하면 이후에 푸시하는 그룹에는 새 이름을 사용해야 합니다. 이미 푸시된 그룹은 계속 해당 역할을 부여합니다.
- 인증 공급자가 Lingo.dev에 푸시한 그룹을 삭제하면 해당 그룹 구성원의 역할이 해제됩니다. 역할 자체는 유지됩니다.
사용자 제거하기 #
인증 공급자에서 사용자의 할당을 해제하거나 사용자를 비활성화하면 다음이 적용됩니다.
- 조직 구성원 자격이 제거됩니다.
- 조직 내 해당 사용자의 개인 API 키가 폐기됩니다.
- 해당 사용자에게 보낸 조직의 대기 중인 초대가 취소됩니다.
- 조직에 SCIM 키가 있는 동안에는 통합 로그인으로 다시 추가되지 않습니다.
이미 열려 있는 Lingo.dev 세션은 종료되지 않지만 더 이상 조직에 접근할 수 없습니다. 다시 통합 로그인하면 "인증 공급자가 조직 접근 권한을 제거했습니다. 잘못된 조치라면 전산 관리자에게 복구를 요청하세요."라는 메시지가 표시됩니다.
소유자도 이 방식으로 제거할 수 있습니다. 단, 마지막 소유자를 제거하려고 하면 인증 공급자에 오류가 표시됩니다.
사용자를 할당하거나 다시 활성화하면 역할이 없는 새 대기 중인 초대가 생성됩니다. 인증 공급자가 해당 사용자의 그룹을 푸시하면 역할이 다시 부여됩니다.
키 교체 또는 폐기하기 #
SCIM 키 설정에서 교체나 폐기를 선택하면 확인 메시지가 표시됩니다.
- 교체를 선택하면 지정한 역할로 새 키가 생성되고 기존 키는 즉시 폐기됩니다. 인증 공급자에 새 키를 붙여 넣기 전까지는 프로비저닝이 실패합니다. 창을 닫기 전에 새 키를 복사하세요.
- 폐기를 선택하면 인증 공급자를 통한 구성원 추가, 업데이트, 제거가 즉시 중단됩니다. 이미 조직에 있는 구성원은 그대로 유지됩니다. 인증 공급자가 제거했던 사용자도 통합 로그인으로 다시 가입할 수 있습니다.
교체 중 기존 키를 폐기하지 못하면 설정에 "이전 SCIM 키가 아직 작동합니다."라는 메시지가 표시됩니다. 폐기를 선택하면 이전 키만 폐기됩니다. 새 키는 계속 작동합니다.
감사 로그에는 SCIM을 통한 변경의 수행 주체가 SCIM 키로 표시됩니다.
인증 공급자에 표시되는 오류 #
| 오류 | 해결 방법 |
|---|---|
| /Groups에 (그룹)이라는 역할이 없습니다. Lingo.dev에서 해당 이름의 역할을 만들거나 역할과 이름이 같은 그룹만 푸시하세요. | 그룹과 같은 이름의 역할을 만들거나 해당 그룹의 푸시를 중단하세요. |
| /Groups에 소유자 역할이 지정되었습니다. 소유자는 Lingo.dev에서 관리합니다. 다른 역할과 이름이 같은 그룹을 푸시하세요. | 그룹으로는 소유자를 지정할 수 없습니다. 설정 → 팀에서 소유자를 지정하세요. |
| /Users의 이메일 (주소)이 통합 로그인 도메인에 속하지 않습니다. (도메인)에 속한 주소를 프로비저닝하세요. | 연결된 도메인의 이메일 주소를 사용하는 사용자만 할당하거나 설정 → 통합 로그인에서 도메인을 추가하세요. |
| 조직 (식별자)에 연결된 인증 공급자가 없습니다. SCIM 프로비저닝을 재개하려면 통합 로그인을 다시 연결하세요. | 통합 로그인 연결이 해제되었습니다. 다시 연결하세요. |
| 조직 (식별자)의 요금제는 통합 로그인을 지원하지 않습니다. SCIM 프로비저닝을 재개하려면 요금제를 업그레이드하세요. | 결제에서 요금제를 확인하세요. |
401 Unauthorized | 키가 교체되었거나 폐기되었습니다. 현재 SCIM 키를 ID 공급자에 붙여넣거나 새 키를 생성하세요. |
SCIM 제한 사항 #
- Lingo.dev에서는 SCIM 키의 마지막 사용 시점을 표시하지 않습니다.
- SSO 연결이 해제되어 있거나 요금제에 SSO가 포함되어 있지 않으면 SCIM이 작동하지 않습니다. 멤버는 그대로 유지됩니다.
- 구글 워크스페이스는 맞춤 SAML 앱에 SCIM을 제공하지 않습니다.
연결 해제 #
소유자만 연결을 해제할 수 있습니다.
- 설정 → SSO를 여세요.
- ID 공급자 연결 해제에서 연결 해제를 선택하세요.
- 연결 해제를 눌러 확인하세요.
조직의 SSO가 중단되고 SSO 필수 사용도 해제됩니다. 멤버는 다시 비밀번호, 이메일 링크 또는 구글로 로그인할 수 있습니다. 상태에는 연결 해제일과 날짜가 표시됩니다.
멤버십은 그대로 유지됩니다. 도메인도 해당 조직에 예약된 상태로 유지되므로 나중에 다시 연결할 수 있습니다. 같은 ID 공급자에서 연결을 선택하세요. 다른 ID 공급자를 사용하려면 support@lingo.dev로 도움을 요청해야 합니다.
SSO로 생성된 계정은 SSO 연결이 해제된 동안 조직에 액세스할 수 없으며, 이미 열려 있는 세션도 액세스할 수 없게 됩니다. SSO로 계속하기를 선택하면 해당 도메인에 통합 로그인이 설정되어 있지 않다는 메시지가 표시됩니다. 같은 이메일로 비밀번호, 이메일 링크 또는 구글을 통해 로그인하면 별도의 계정이 열립니다. SSO로 생성된 계정의 멤버십은 유지되며, 같은 ID 공급자를 다시 연결하면 액세스 권한이 복구됩니다. 다시 연결하기 전까지는 누구도 SSO로 조직에 가입할 수 없습니다. 그동안 계속 작업하려면 비밀번호, 이메일 링크 또는 구글로 로그인할 수 있고 자체 멤버십이 있는 별도의 본인 계정이 필요합니다. 본인도 SSO로 로그인한 상태라면 액세스 권한을 잃게 됩니다. 따라서 연결을 해제하기 전에 다른 소유자가 비밀번호, 이메일 링크 또는 구글로 로그인했는지 확인하세요.
요금제에 더 이상 SSO가 포함되지 않는 경우 #
설정 → SSO에는 연결 정보가 안내 메시지와 함께 계속 표시됩니다. 소유자는 여전히 SSO 필수 사용을 끄고 연결을 해제할 수 있습니다. 새로 연결하거나, 연결을 변경하거나, SSO 필수 사용을 켜려면 다시 Enterprise 요금제를 사용해야 합니다.
설정을 변경하기 전까지는 SSO 로그인과 SSO 필수 사용이 이전과 동일하게 작동합니다.
감사 로그 #
SSO 변경 사항은 변경한 사람과 함께 감사 로그에 표시됩니다:
| 작업 | 표시 내용 | 시점 |
|---|---|---|
sso.connected | 통합 로그인을 연결함 | 처음 연결하거나 연결 해제 후 다시 연결할 때 |
sso.updated | 통합 로그인을 업데이트함 | 연결된 ID 공급자 설정에서 새 메타데이터 URL 입력이나 도메인 추가 등의 변경 후 저장을 누를 때 |
sso.enforcement_enabled | 통합 로그인을 필수로 설정함 | SSO 필수 사용을 켤 때 |
sso.enforcement_disabled | 통합 로그인 필수 설정을 해제함 | SSO 필수 사용을 끌 때 |
sso.disconnected | 통합 로그인 연결을 해제함 | ID 공급자 연결을 해제할 때 |
사용자가 처음 SSO로 로그인하면서 조직에 추가되면 "조직에 가입함"으로 표시됩니다.
문제 해결 #
로그인 메시지 #
| 메시지 | 해결 방법 |
|---|---|
| 회사 이메일을 입력하세요. 이메일 도메인을 기준으로 통합 로그인이 시작됩니다. | you@example.com처럼 전체 이메일 주소를 입력하세요. |
| 이메일 도메인이 조직에서 통합 로그인에 사용하는 도메인이 아닙니다. 회사 도메인의 업무용 이메일로 로그인하세요. | ID 공급자에서 조직에 연결된 도메인에 속하지 않는 이메일로 로그인되었습니다. 개인 이메일 주소나 등록되지 않은 하위 도메인이 이에 해당할 수 있습니다. 회사 계정으로 ID 공급자에 로그인하거나 소유자에게 도메인 추가를 요청하세요. |
| example.com에 통합 로그인이 설정되어 있지 않습니다. 비밀번호, 링크 또는 구글로 로그인하세요. | 연결된 조직 중 해당 도메인을 사용하는 조직이 없습니다. 철자를 확인하거나 관리자에게 연결된 도메인을 문의하세요. |
| example.com의 통합 로그인을 확인할 수 없습니다. 잠시 후 다시 시도하세요. | Lingo.dev에서 도메인을 조회하지 못했습니다. 다시 시도하세요. |
| 통합 로그인 시간이 초과되었습니다. 다시 시도하세요. | ID 공급자가 다단계 인증 설정을 요청하는 등의 이유로 로그인에 약 5분 이상 걸렸습니다. 다시 시도하세요. 다음 시도에서는 정상적으로 진행됩니다. |
| ID 공급자가 이메일 주소를 보내지 않았습니다. 전산 관리자에게 Lingo.dev 앱에 이메일 속성이나 클레임을 추가해 달라고 요청하세요. | SAML 응답에 이메일이 없습니다. 옥타 또는 마이크로소프트 엔트라 아이디 가이드를 참고하세요. |
| 통합 로그인이 완료되지 않았습니다. 다시 시도하거나 전산 관리자에게 ID 공급자에 등록된 Lingo.dev 앱을 확인해 달라고 요청하세요. | 대개 ID 공급자 앱의 엔터티 ID 또는 ACS URL이 잘못되어 발생합니다. 위의 값과 비교하세요. |
| 로그인했지만 조직에 추가하지 못했습니다. 다시 시도하거나 관리자에게 문의하세요. | SSO 로그인은 성공했지만 조직 가입에 실패했습니다. SSO로 다시 로그인하세요. CLI 또는 MCP 클라이언트에서는 연결 화면에 이 메시지가 표시됩니다. 화면을 새로고침해 다시 시도하세요. 계속 실패하면 소유자에게 설정 → SSO에 연결 시작일이 표시되는지 확인해 달라고 요청하세요. |
| 이 조직은 통합 로그인이 필수입니다. ID 공급자를 통해 로그인한 후 다시 시도하세요. | SSO 필수 사용이 켜진 조직에 다른 방식으로 로그인한 상태에서 접속했습니다. SSO로 계속하기를 선택하세요. 현재 로그인한 이메일이 회사 이메일이 아니라면 다른 회사 이메일 사용을 선택하세요. |
마이크로소프트의 AADSTS 코드와 같은 ID 공급자의 오류는 해당 공급자의 로그인 페이지에 표시됩니다. 자주 발생하는 오류는 공급자별 가이드에서 확인할 수 있습니다.
설정 메시지 #
| 메시지 | 해결 방법 |
|---|---|
| 소유자만 통합 로그인을 변경할 수 있습니다. 이 조직의 소유자에게 변경을 요청하세요. | SSO 설정은 볼 수 있지만 변경은 소유자만 할 수 있습니다. 소유자에게 요청하세요. |
| example.com은 본인의 이메일 도메인이 아닙니다. | 본인의 이메일 도메인이나 그 하위 도메인만 추가하세요. 또는 해당 도메인의 이메일 주소를 사용하는 관리자에게 요청하세요. |
| gmail.com은 공용 이메일 서비스입니다. 회사에서 소유한 도메인을 사용하세요. | 무료 및 일회용 이메일 도메인은 SSO를 사용할 수 없습니다. 회사에서 소유한 도메인을 추가하세요. |
| lingo.dev는 예약된 도메인입니다. 회사에서 소유한 도메인을 사용하세요. | 회사에서 소유한 도메인을 추가하세요. |
| example.com은 이미 다른 조직의 ID 공급자를 통한 로그인에 사용되고 있습니다. | 이전하려면 support@lingo.dev로 이메일을 보내세요. |
| ID 공급자의 메타데이터가 거부되었습니다: (사유). 메타데이터 URL을 확인하세요. | ID 공급자 앱에서 메타데이터 URL을 다시 복사하세요. 외부에서 접근할 수 있는 https:// URL이어야 합니다. |
| 이 메타데이터는 현재 연결된 공급자가 아닌 다른 ID 공급자의 메타데이터입니다. | ID 공급자를 변경하려면 support@lingo.dev로 도움을 요청해야 합니다. |
| 이 ID 공급자는 이미 다른 조직에 연결되어 있습니다. | 이전하려면 support@lingo.dev로 이메일을 보내세요. |
| 이 기능을 켜려면 ID 공급자를 통해 로그인하세요. | SSO로 계속하기를 선택해 로그인한 다음 SSO 필수 사용을 켜세요. |
| SSO를 필수로 설정하려면 Enterprise 요금제가 필요합니다. | 결제에서 요금제를 확인하세요. |
알려진 제한 사항 #
- 연결된 도메인 중 하나에 속하는 이메일 계정만 조직에 가입할 수 있으며, 도메인은 정확히 일치해야 합니다. ID 공급자는 개인 이메일 주소를 사용하는 게스트나 추가하지 않은 하위 도메인의 사용자도 로그인하도록 허용할 수 있습니다. Lingo.dev에서는 이러한 사용자를 다시 로그아웃시키고 이유를 표시합니다. ID 공급자에서 해당하는 사용자만 앱에 할당하고, 멤버가 로그인할 때 사용하는 모든 하위 도메인을 추가하세요.
- 사용자가 이전에 비밀번호, 이메일 링크 또는 구글로 로그인하던 계정의 역할은 이전되지 않습니다.
- ID 공급자에서 사용자를 삭제해도 이미 열려 있는 Lingo.dev 세션은 종료되지 않습니다. Lingo.dev는 세션이 유지되는 동안 ID 공급자에 다시 확인하지 않습니다. SCIM을 사용하면 사용자를 삭제할 때 멤버십도 해제되므로 해당 세션에서 더 이상 조직에 액세스할 수 없습니다. SCIM을 사용하지 않으면 로그아웃할 때까지 세션을 계속 사용할 수 있으므로 설정 → 팀에서도 사용자를 삭제하세요.
- ID 공급자가 여전히 로그인을 허용하는 상태에서 Lingo.dev의 멤버를 삭제하면, SCIM 사용 여부와 관계없이 다음 SSO 로그인 시 조직에 다시 가입됩니다. SCIM을 사용한다면 ID 공급자에서 사용자를 삭제하세요. 그러면 멤버십도 해제되고 재가입도 차단됩니다. SCIM을 사용하지 않는다면 먼저 ID 공급자에서 삭제한 다음 설정 → 팀에서 삭제하세요.
- 대시보드 타일은 대시보드 로그인 링크를 여는 경우에만 로그인을 진행합니다. 옥타 대시보드나 마이크로소프트 내 앱에 있는 SAML 앱 자체 타일을 누르면 로그인되지 않은 상태로 Lingo.dev 홈페이지가 열립니다. 대시보드 타일에서 로그인을 참고하세요.
- 도메인을 삭제하거나 ID 공급자를 변경하는 작업은 직접 할 수 없습니다. support@lingo.dev로 이메일을 보내세요.