마이크로소프트 엔트라 ID로 싱글 사인온 설정하기
마이크로소프트 엔트라 ID에서 Lingo.dev용 엔터프라이즈 애플리케이션을 만들고, 사용자를 할당하고, 조직에 연결한 뒤 SCIM으로 구성원을 프로비저닝하세요.
이 가이드에서는 SAML 2.0을 통해 마이크로소프트 엔트라 ID와 Lingo.dev를 연결합니다. 엔트라에서 클라우드 애플리케이션 관리자 이상의 역할이 있어야 하며, Enterprise 요금제를 사용하는 Lingo.dev 조직의 소유자여야 합니다. Lingo.dev에서 싱글 사인온이 작동하는 방식은 싱글 사인온을 참고하세요.
Lingo.dev에서 설정 → 싱글 사인온을 열어 두세요. 이 화면에서 두 값을 복사해 엔트라에 입력합니다.
엔터프라이즈 애플리케이션 만들기 #
- 마이크로소프트 엔트라 관리 센터에 로그인하세요.
- 엔트라 ID → 엔터프라이즈 앱 → 모든 애플리케이션으로 이동해 새 애플리케이션을 선택하세요.
- 나만의 애플리케이션 만들기를 선택하세요.
- 이름에
Lingo.dev을 입력하고 갤러리에서 찾을 수 없는 다른 애플리케이션 통합(비갤러리) 을 선택한 뒤 만들기를 선택하세요.
SAML 구성하기 #
- 새 애플리케이션에서 싱글 사인온을 열고 SAML을 선택하세요.
- 기본 SAML 구성에서 편집을 선택하세요.
- 식별자(엔터티 ID) 에서 식별자 추가를 선택하고 Lingo.dev의 엔터티 ID 값인
https://auth.lingo.dev/auth/v1/sso/saml/metadata을 붙여 넣으세요. - 회신 URL(어설션 소비자 서비스 URL) 에서 회신 URL 추가를 선택하고 Lingo.dev의 ACS URL 값인
https://auth.lingo.dev/auth/v1/sso/saml/acs을 붙여 넣으세요. - 지금은 로그온 URL, 릴레이 상태, 로그아웃 URL을 비워 두고 저장을 선택하세요. 로그온 URL은 연결을 마친 뒤 마이크로소프트 내 앱에서 로그인하기 단계에서 설정합니다.
특성 및 클레임은 기본값으로 유지하세요. 엔트라 관리 센터에서 만든 앱은 user.mail에서 가져온 사용자 이메일을 emailaddress 클레임으로 보내고, 이메일 형식의 이름 ID도 보냅니다. 로그인할 모든 사용자의 이메일 주소가 엔트라에 등록되어 있는지 확인하세요.
마이크로소프트 그래프 API를 통해 만든 경우처럼 기본 클레임 없이 생성된 앱은 이메일을 보내지 않습니다. 이 경우 "ID 공급자가 이메일 주소를 보내지 않았습니다."라는 메시지와 함께 로그인에 실패합니다. 특성 및 클레임에서 원본 특성을 user.mail으로 지정해 이메일 클레임을 추가하세요.
메타데이터 URL 복사하기 #
SAML 인증서에서 앱 페더레이션 메타데이터 URL을 복사하세요.
사용자 및 그룹 할당하기 #
- 애플리케이션에서 사용자 및 그룹을 열고 사용자/그룹 추가를 선택하세요.
- 사용자 및 그룹에서 선택한 항목 없음을 선택하고 사용자 또는 그룹을 고른 뒤 선택을 누르세요.
- 할당을 선택하세요.
- 속성을 열고 할당 필요?를 예로 설정한 뒤 저장을 선택하세요.
할당 필요?를 예로 설정하면 할당된 사용자만 엔트라를 통해 Lingo.dev에 로그인할 수 있습니다. 아니요로 설정하면 게스트 계정을 포함해 테넌트의 모든 사용자가 앱에 접근할 수 있습니다. 다만 Lingo.dev는 연결된 도메인의 계정만 조직에 가입할 수 있도록 허용하며, 나머지 계정은 다시 로그아웃시킵니다. 마이크로소프트 그래프 API로 만든 앱의 기본 설정은 아니요입니다. 그룹을 할당하려면 마이크로소프트 엔트라 ID P1 또는 P2가 필요합니다. 무료 요금제에서는 사용자를 한 명씩 할당하세요.
Lingo.dev에서 연결하기 #
- 설정 → 싱글 사인온을 여세요.
- 앱 페더레이션 메타데이터 URL을 ID 공급자 메타데이터 URL에 붙여 넣으세요.
- 이메일 도메인에 회사 이메일 도메인을 쉼표로 구분해 입력하세요.
- 연결을 선택하세요.
도메인이 거부되면 도메인 규칙을 참고하세요.
로그인 테스트하기 #
- 브라우저에서 비공개 창을 열고 Lingo.dev 로그인 페이지로 이동하세요.
- 싱글 사인온으로 계속을 선택하고 할당된 사용자의 이메일을 입력한 뒤 로그인을 선택하세요.
- 마이크로소프트 계정으로 로그인하세요.
로그인이 완료되면 조직 구성원으로 Lingo.dev에 돌아옵니다. 조직 페이지에 표시된 이메일을 확인하세요. 이 이메일은 마이크로소프트에서 로그인한 계정의 이메일로, 앞서 입력한 이메일과 다를 수 있습니다. 브라우저에 이미 마이크로소프트 계정으로 로그인되어 있으면 비밀번호를 묻지 않고 해당 계정으로 계속 진행합니다. 예를 들어 앱을 설정한 관리자 계정으로 로그인되어 있다면 그 계정이 사용됩니다. 따라서 비공개 창에서 테스트해야 합니다.
엔트라의 테스트 버튼 대신 Lingo.dev에서 테스트를 시작하세요. 로그온 URL을 설정하기 전에는 마이크로소프트 내 앱의 Lingo.dev 타일을 눌러도 로그인되지 않습니다. 로그아웃 상태로 Lingo.dev 홈페이지가 열립니다.
테넌트에서 보안 기본값을 사용하면 마이크로소프트는 각 사용자에게 처음 로그인할 때 인증 앱을 등록하도록 요청합니다. 이 과정이 Lingo.dev의 대기 시간인 약 5분을 넘기면 첫 로그인 시도가 "싱글 사인온을 완료하는 데 시간이 너무 오래 걸렸습니다. 다시 시도하세요."라는 메시지와 함께 실패합니다. 다시 시도하면 정상적으로 로그인됩니다.
테스트에 성공하면 싱글 사인온을 필수로 설정할 수 있습니다. 먼저 활성화하기의 안내에 따라 본인의 싱글 사인온 계정을 소유자로 지정하세요.
마이크로소프트 내 앱에서 로그인하기 #
내 앱의 Lingo.dev 타일로 로그인할 수 있도록 로그온 URL을 설정하세요.
- Lingo.dev에서 설정 → 싱글 사인온을 열고 대시보드 로그인 링크를 복사하세요. 링크는
https://lingo.dev/auth/sso?domain=example.com과 같은 형식입니다. - 엔트라에서 Lingo.dev 애플리케이션을 열고 싱글 사인온을 선택하세요.
- 기본 SAML 구성에서 편집을 선택하세요.
- 로그온 URL에 링크를 붙여 넣고 저장을 선택하세요.
이제 내 앱의 Lingo.dev 타일을 누르면 해당 링크가 열립니다. Lingo.dev는 이메일을 묻지 않고 사용자를 마이크로소프트로 안내한 뒤, 로그인이 완료되면 다시 Lingo.dev로 돌아오게 합니다.
SCIM으로 구성원 프로비저닝하기 #
엔트라에서는 SCIM으로 Lingo.dev 구성원을 관리하고 그룹을 통해 역할을 설정할 수 있습니다. 먼저 이 가이드에 따라 싱글 사인온을 설정하세요. Lingo.dev에서 SCIM이 작동하는 방식은 SCIM으로 구성원 프로비저닝하기를 참고하세요.
- Lingo.dev에서 SCIM 키를 생성하세요.
- 엔트라에서 Lingo.dev 엔터프라이즈 애플리케이션을 열고 프로비저닝을 선택하세요.
- 프로비저닝 모드를 자동으로 설정하세요.
- 관리자 자격 증명에서 Lingo.dev의 SCIM 기본 URL인
https://api.lingo.dev/v2/scim을 테넌트 URL에 붙여 넣으세요. SCIM 키는 비밀 토큰에 붙여 넣으세요. - 연결 테스트를 선택한 뒤 저장을 선택하세요.
- 특성 매핑은 기본값으로 유지하세요. Lingo.dev는
userPrincipalName에서userName값을 가져오고,mail에서 업무용 이메일을 가져옵니다. - 설정에서 범위를 할당된 사용자 및 그룹만 동기화로 설정하세요.
- 프로비저닝 시작을 선택하세요.
초대는 사용자의 mail 주소로 전송되므로 할당하는 모든 사용자에게 연결된 도메인의 해당 주소가 있어야 합니다. userPrincipalName 값이 mail 값과 달라도 괜찮습니다.
할당한 사용자마다 Lingo.dev에 대기 중인 초대가 생성되며, 해당 사용자가 처음 싱글 사인온으로 로그인하면 구성원이 됩니다.
엔트라는 약 40분 간격으로 프로비저닝하므로 변경 및 제거 사항은 다음 주기에 Lingo.dev에 반영됩니다. 사용자 한 명을 즉시 전송하려면 주문형 프로비저닝을 사용하세요.
사용자 할당을 해제하면 엔트라는 삭제가 아닌 비활성화 요청을 보내고, Lingo.dev는 해당 사용자를 조직에서 제거합니다. 사용자 제거하기를 참고하세요.
엔트라 그룹으로 역할 설정하기 #
- 엔트라 그룹 이름이
Translator과 같은 Lingo.dev 역할 이름과 일치하는지 확인하세요. - 사용자 및 그룹에서 그룹을 애플리케이션에 할당하세요.
엔트라는 그룹을 같은 이름의 역할과 연결하고 그룹 구성원을 프로비저닝해 해당 역할을 부여합니다. 그룹에서 제거한 사용자는 해당 역할을 잃습니다. 해당 그룹이 사용자를 앱에 할당한 유일한 경로였다면, 그룹에서 제거할 때 Lingo.dev에서도 제거됩니다.
문제 해결 #
| 문제 | 해결 방법 |
|---|---|
마이크로소프트에서 AADSTS700016 표시: "디렉터리에서 식별자가 '…'인 애플리케이션을 찾을 수 없습니다." | 식별자(엔터티 ID) 가 https://auth.lingo.dev/auth/v1/sso/saml/metadata과 정확히 일치하지 않습니다. 기본 SAML 구성에서 수정하세요. |
마이크로소프트에서 AADSTS50011 표시: "회신 URL이 애플리케이션에 구성된 회신 URL과 일치하지 않습니다." | 회신 URL(어설션 소비자 서비스 URL) 을 https://auth.lingo.dev/auth/v1/sso/saml/acs과 정확히 일치하도록 설정하세요. |
마이크로소프트에서 AADSTS50105 표시: 사용자가 애플리케이션에 할당되어 있지 않음. | 사용자 및 그룹에서 해당 사용자 또는 사용자가 속한 그룹을 할당하세요. |
| 할당되지 않은 사용자가 로그인했거나 Lingo.dev에 입력한 것과 다른 이메일이 표시됨. | 할당 필요?가 아니요로 설정되어 있거나 브라우저에 이미 다른 마이크로소프트 계정으로 로그인되어 있었습니다. 속성에서 할당 필요?를 예로 설정하고 비공개 창에서 테스트하세요. |
| 이메일 도메인이 조직에서 싱글 사인온에 사용하는 도메인이 아니라는 메시지가 Lingo.dev에 표시됨. | 마이크로소프트에서 연결된 도메인에 속하지 않는 계정으로 로그인했습니다. 게스트 계정이나 테넌트를 만든 관리자 계정인 경우가 많습니다. 업무용 계정으로 로그인하거나 설정 → 싱글 사인온에서 해당 도메인을 추가하세요. |
| Lingo.dev에 "ID 공급자가 이메일 주소를 보내지 않았습니다."라는 메시지가 표시됨. | 앱이 이메일 클레임을 보내지 않거나 엔트라에 사용자의 이메일 주소가 등록되어 있지 않습니다. 특성 및 클레임에서 이메일 클레임(user.mail)을 추가하고 사용자의 이메일 주소를 설정하세요. |
| Lingo.dev에 "싱글 사인온을 완료하는 데 시간이 너무 오래 걸렸습니다. 다시 시도하세요."라는 메시지가 표시됨. | 마이크로소프트 로그인에 약 5분 넘게 걸렸습니다. 인증 앱을 등록하는 동안 자주 발생합니다. Lingo.dev에서 다시 시도하세요. 다음 시도에서는 정상적으로 로그인됩니다. |
| Lingo.dev에 "로그인했지만 조직에 추가하지 못했습니다."라는 메시지가 표시됨. | 싱글 사인온으로 다시 로그인하세요. 계속 실패하면 소유자에게 설정 → 싱글 사인온에 연결 시작일이 표시되는지 확인해 달라고 요청하세요. |
| Lingo.dev에 "싱글 사인온이 완료되지 않았습니다."라는 메시지가 표시됨. | 식별자(엔터티 ID) 와 회신 URL을 Lingo.dev에 표시된 값과 비교한 뒤 다시 시도하세요. |
연결 테스트 또는 프로비저닝이 401 Unauthorized 오류로 실패함. | SCIM 키가 교체되었거나 폐기되었습니다. 비밀 토큰에 현재 키를 붙여 넣거나 Lingo.dev에서 새 키를 생성하세요. |
| 할당된 사용자가 설정 → 팀의 초대 탭에 표시되지 않음. | 다음 프로비저닝 주기까지 기다리거나 주문형 프로비저닝을 사용하세요. 사용자의 mail 주소가 연결된 도메인에 속하는지 확인하세요. |
그 밖의 메시지는 문제 해결을 참고하세요.