SAML SSO로 로그인하고 연동하기
회사 계정으로 SAML SSO에 로그인하고, 관리자가 인증 서버와 이메일 도메인을 연결하는 방법을 안내합니다.
SAML SSO를 사용하면 회사 인증 서버에서 본인 확인을 마친 뒤 심플리에 로그인할 수 있습니다. 구성원은 아래 로그인 절차를 따르고, 관리자는 연동 전에 준비하기부터 진행하세요.
SAML SSO로 로그인하기
섹션 제목: “SAML SSO로 로그인하기”- 심플리 로그인 화면에서 SAML SSO로 로그인을 누릅니다.
- 회사 이메일을 입력하고 다음을 누릅니다. 이메일 인증 코드는 보내지 않습니다.
- 연결된 회사 인증 서버가 하나면 해당 인증 화면으로 이동합니다. 여러 개면 회사 SSO 선택에서 로그인할 회사를 선택합니다.
- 회사 인증 화면에서 로그인을 완료합니다. 회사가 정한 다중 인증이 있다면 함께 진행합니다.
- 심플리로 돌아와 2단계 인증을 요청받으면 인증을 마칩니다. 이후 선택한 회사의 구성원으로 로그인됩니다.
SAML 로그인에도 심플리의 2단계 인증이 적용됩니다. 인증 앱 등록이나 복구가 필요하면 2단계 인증 가이드를 참고하세요.
회사 인증 서버에 이미 로그인돼 있다면 아이디와 비밀번호 입력 없이 돌아올 수 있습니다. 회사 인증 방식에 따라 실제로 표시되는 화면은 다릅니다.
SAML 로그인은 심플리에 등록된 구성원만 사용할 수 있습니다. 처음 사용하는 구성원은 회사 관리자에게 등록 상태와 이메일을 확인해 달라고 요청하세요. SAML 로그인만으로 구성원이 자동 생성되지는 않습니다.
연동 전에 준비하기
섹션 제목: “연동 전에 준비하기”| 준비사항 | 확인할 내용 |
|---|---|
| SAML 사용 허용 | 심플리 운영팀이 회사의 SAML 사용을 허용해야 설정 화면이 표시됩니다. 화면이 보이지 않으면 운영팀에 문의하세요. |
| 심플리 관리자 권한 | 설정 > 워크스페이스 설정 > 보안에서 SAML 설정에 접근할 수 있어야 합니다. |
| 회사 인증 서버 관리자 권한 | SAML 2.0 앱을 만들고 로그인할 구성원에게 접근 권한을 부여할 수 있어야 합니다. |
| 회사 이메일 도메인의 DNS 관리 권한 | 소유권 확인용 TXT 레코드를 추가할 수 있어야 합니다. DNS 관리 담당자가 다르면 아래 확인값을 전달합니다. |
| 로그인할 구성원 | 심플리에 구성원을 미리 등록합니다. 회사 인증 서버가 보내는 이메일과 심플리 구성원의 이메일이 같아야 합니다. 삭제되거나 비활성화된 구성원은 로그인할 수 없습니다. |
SAML 로그인 연동은 구성원 정보 수집이나 인사 정보 동기화와 별개입니다. Google Workspace·Microsoft 365 구성원 연동은 별도로 설정합니다.
회사 인증 서버에 심플리 등록하기
섹션 제목: “회사 인증 서버에 심플리 등록하기”- 심플리에서 설정 > 워크스페이스 설정 > 보안을 열고, 회사 SAML 로그인의 SAML 설정을 누릅니다.
- 회사 인증 서버에서 심플리용 SAML 2.0 앱을 만듭니다.
- 심플리의 서비스 제공자(SP) 정보에서 복사를 눌러 아래 값을 회사 인증 서버에 입력합니다.
| 심플리 화면의 값 | 회사 인증 서버에 입력할 위치 |
|---|---|
| SP Entity ID | 서비스 공급자 식별자 또는 Entity ID. Okta에서는 Audience URI (SP Entity ID) 항목에 입력합니다. 같은 주소에서 심플리 메타데이터 XML도 확인할 수 있습니다. |
| ACS URL (응답 수신 주소) | 인증 응답을 보낼 주소. Reply URL 또는 Assertion Consumer Service URL로 표시될 수 있습니다. Okta에서는 Single sign-on URL에 입력합니다. |
주소는 현재 회사의 설정 화면에서 복사하세요. 다른 회사나 테스트 환경의 주소를 사용하지 않습니다.
회사 인증 서버가 SAML Assertion에 서명하도록 설정하고, 로그인할 구성원에게 이 앱의 사용 권한을 부여합니다. 로그인 확인은 심플리 공통 로그인 화면에서 시작합니다. 인증 서버의 앱 실행 버튼에서 응답만 보내는 로그인 방식은 지원하지 않습니다.
Okta에 등록하는 경우
섹션 제목: “Okta에 등록하는 경우”- Okta 관리자 콘솔의 앱 목록에서 Create App Integration → SAML 2.0을 선택합니다. Classic experience가 보이면 선택합니다.
- 위 표대로 Single sign-on URL에 ACS URL을, Audience URI (SP Entity ID) 항목에 Entity ID를 입력합니다.
- Use this for Recipient URL and Destination URL을 선택하고 Default RelayState는 비워 둡니다.
- Name ID format은 EmailAddress, Application username은 Email로 설정합니다. 형식뿐 아니라 실제
NameID값이 구성원의 이메일이어야 합니다. - 내부용 앱으로 생성하고 Finish로 마칩니다. OIN 공개 심사용 테스트 계정은 필요하지 않습니다.
- Assignments에서 테스트할 사용자를 앱에 배정합니다. Attribute statements에 별도 이메일 속성을 추가할 필요는 없습니다.
Okta의 Sign On → Metadata details에서 Metadata URL을 복사합니다. 다음 단계에서 심플리에 입력할 주소입니다. 메타데이터 URL과 Identity Provider Issuer는 서로 다른 값입니다.
심플리에 회사 인증 서버 정보 입력하기
섹션 제목: “심플리에 회사 인증 서버 정보 입력하기”- 인증 제공자(IdP) 설정의 IdP 메타데이터 URL에 회사 인증 서버가 제공하는 HTTPS 주소를 입력합니다. Okta에서는 해당 SAML 앱의 Sign On → Metadata details → Metadata URL을 복사합니다.
- 나머지 항목은 회사 인증 서버에서 확인해 직접 입력합니다. Okta에서는 해당 앱의 Sign On → View SAML setup instructions에서 SSO URL과 공개 서명 인증서를 확인할 수 있습니다.
| 심플리 입력 항목 | 입력할 값 | Okta의 명칭 |
|---|---|---|
| IdP SSO URL | 심플리 인증 요청을 받을 회사 인증 서버의 HTTPS 주소 | Identity Provider Single Sign-On URL |
| X.509 서명 인증서 | 회사 인증 서버의 공개 서명 인증서. 여러 인증서는 빈 줄로 구분합니다. 개인 키는 입력하지 않습니다. | X.509 Certificate |
Okta의 Issuer는 http://www.okta.com/<앱 식별자> 형태일 수 있습니다. 접속 주소가 아닌 식별자이며 메타데이터에서 읽은 값을 그대로 사용합니다. Metadata URL 자체를 식별자로 사용하지 않습니다.
심플리는 SAML 표준 사용자 식별값인 NameID에서 이메일을 읽습니다. 회사 인증 서버가 NameID에 기존 구성원의 이메일을 보내도록 설정하세요. 별도 Email·mail 속성이나 사용자 정보 조회 API는 필요하지 않습니다. NameID는 Okta 전용 속성이 아니며 다른 SAML 인증 서버에도 같은 기준을 적용합니다.
이전 이메일 속성 설정이 있다면 저장하기를 누를 때 NameID 방식으로 전환됩니다. 저장 전에 회사 인증 서버의 NameID가 이메일인지 확인하세요.
- 저장하기를 누릅니다. 심플리가 메타데이터를 조회해
EntityDescriptor의entityID를 추출한 다음 설정을 저장합니다. SSO URL·인증서는 직접 입력한 값을 사용합니다. 저장 후 IdP Entity ID (Issuer) 값을 확인할 수 있습니다.
메타데이터 URL은 필수입니다. 확인에 실패하면 설정을 저장하지 않고 입력값을 유지합니다. URL이나 인증 서버 설정을 확인한 뒤 저장하기를 다시 누르세요. IdP 설정만 저장한 상태에서는 공통 로그인 화면이 회사를 찾을 수 없으므로 다음 단계에서 회사 이메일 도메인도 확인합니다.
메타데이터 조회에는 인증 서버의 브라우저 접근 허용(CORS)이 필요합니다. URL은 현재 화면에서만 유지하므로 설정 화면을 새로 열면 다시 입력합니다. URL을 주기적으로 조회해 자동 갱신하지는 않습니다.
회사 이메일 도메인 소유권 확인하기
섹션 제목: “회사 이메일 도메인 소유권 확인하기”- 회사 이메일 도메인에
example.com처럼 이메일의@뒤에 오는 도메인을 입력하고 등록하기를 누릅니다. - 화면에 표시된 TXT 레코드 이름과 TXT 레코드 값을 복사합니다.
- 해당 도메인을 관리하는 DNS 서비스에 TXT 레코드를 추가합니다. 심플리나 이메일 수신함이 아니라 회사 도메인의 DNS 관리 화면에서 설정합니다.
- 심플리로 돌아와 소유권 확인을 누릅니다. 버튼을 누를 때 심플리가 DNS 값을 조회합니다.
- 확인 완료로 바뀌었는지 확인합니다. 확인이 완료된 도메인과 활성화된 SAML 설정만 로그인 연결 탐색에 사용합니다.
다음은 example.com을 등록했을 때의 예시입니다. 실제 이름과 값은 심플리 화면에서 복사하세요.
| 구분 | 예시 |
|---|---|
| 레코드 유형 | TXT |
| 레코드 이름 | _smply-saml.example.com |
| 레코드 값 | smply-domain-verification=<화면에서 발급한 확인값> |
DNS 서비스가 도메인을 자동으로 붙이는 경우에는 이름 칸에 _smply-saml만 입력해야 할 수 있습니다. 최종 레코드 이름이 심플리에 표시된 이름과 일치하는지 확인하세요.
확인값은 발급 후 24시간 동안 유효합니다. 확인 전에 만료됐다면 같은 도메인을 다시 등록해 새 값을 발급받으세요. 24시간은 소유권 확인을 완료할 기한이며, 확인된 도메인이 24시간 뒤 해제된다는 뜻은 아닙니다.
example.com을 확인해도 team.example.com은 자동으로 확인되지 않습니다. 구성원이 사용하는 이메일 도메인을 각각 등록하세요.
로그인 확인하기
섹션 제목: “로그인 확인하기”관리자 설정 화면을 열어 둔 상태에서 별도의 시크릿 창을 엽니다. SAML SSO 로그인 절차에 따라 공통 로그인 화면에서 미리 등록한 구성원으로 로그인하세요. 올바른 회사 인증 화면으로 이동하고, 심플리로 돌아와 해당 회사에 로그인되는지 확인합니다.
설정을 바꿨다면 이전 인증 화면이나 오류 화면을 새로고침하지 말고, 심플리에서 로그인을 새로 시작하세요. /acs는 인증 서버가 응답을 보내는 주소이므로 브라우저 주소창에 직접 입력해 테스트하지 않습니다.
인증 요청 하나는 5분 동안 유효합니다. 웹 로그인 도중 Okta Verify 같은 인증 앱을 처음 등록하면서 요청이 만료되거나 로그인 연결이 끊기면, 심플리가 원래 브라우저를 확인하고 한 번 새 인증을 시작합니다. 새 인증을 마치면 원래 화면으로 돌아옵니다. 같은 오류가 반복되거나 브라우저를 바꿨다면 심플리 로그인 화면에서 새로 시작하세요. 인증 요청의 유효시간은 로그인 후의 웹 세션 유지 시간과 별개입니다.
SAML 연동 후에도 Google·Microsoft·이메일 로그인은 유지됩니다. SAML 로그인만 강제하는 설정은 제공하지 않습니다.
문제가 생겼을 때
섹션 제목: “문제가 생겼을 때”| 상황 | 확인할 내용 |
|---|---|
| 연결된 회사 SSO가 없습니다 | 입력한 이메일 도메인, 도메인의 확인 완료 상태, SAML 사용이 허용되어 있는지 관리자에게 확인합니다. |
| TXT 레코드가 확인되지 않음 | 최종 레코드 이름과 값이 일치하는지 확인합니다. DNS 반영 후 소유권 확인을 다시 누릅니다. 확인값이 만료됐다면 재등록합니다. |
| 회사 인증 화면에서 접근 거절 | 해당 구성원에게 SAML 앱 사용 권한을 부여했는지 회사 인증 서버 관리자에게 확인합니다. |
인증 후 /login 주소에서 404 | Okta의 Single sign-on URL에 ACS URL을 등록했는지 확인합니다. |
| 회사 인증 후 심플리 로그인 실패 | Entity ID·ACS URL·서명 인증서를 확인합니다. NameID가 이메일이며 기존 구성원 이메일과 일치하는지 확인합니다. |
/acs에서 invalid_request | 이 오류만으로 원인을 구분할 수 없습니다. 현재 회사의 올바른 SAML 앱에서 가져온 메타데이터 URL로 저장했는지, NameID에 구성원 이메일이 전달되는지 확인하고 심플리에서 새로 시작합니다. 계속 실패하면 발생 시각과 오류 주소를 문의에 포함합니다. |
| 인증 앱 최초 등록 후 로그인 연결이 끊김 | 웹 로그인은 원래 브라우저에서 한 번 새 인증을 시작합니다. 다시 실패하면 심플리 로그인 화면에서 새로 시작합니다. |
| 인증 중 SAML 설정이 변경됨 | 심플리 로그인 화면에서 새 인증 요청으로 다시 시작합니다. |
NameID에 이메일이 전달되지 않는 경우
섹션 제목: “NameID에 이메일이 전달되지 않는 경우”Okta에서는 Name ID format을 EmailAddress, Application username을 Email로 설정합니다. Name ID format만 바꾸면 실제 값이 사번이나 다른 아이디인 상태로 남을 수 있습니다. 테스트 사용자의 앱 사용자 이름과 회사 이메일이 일치하는지도 확인하세요.
Google Workspace·Microsoft Entra ID 등 다른 인증 서버에서도 기본 사용자 식별값(NameID)의 실제 값이 구성원 이메일이 되도록 설정합니다. 별도 이메일 속성 표현식을 추가할 필요는 없습니다.
해결되지 않으면 로그인 화면의 문의하기로 문의하세요. 회사 이름, 발생 시각, 표시된 오류를 전달하면 확인에 도움이 됩니다. 인증 응답 원문이나 개인 키는 문의 내용에 넣지 마세요.
연동 완료 확인
섹션 제목: “연동 완료 확인”- 회사 인증 서버에 현재 회사의 Entity ID와 ACS URL을 등록했습니다.
- NameID에 이메일을 보내도록 설정하고 메타데이터 URL·SSO URL·서명 인증서를 입력·저장해 SAML 로그인을 활성화했습니다.
- 회사 이메일 도메인이 확인 완료로 표시됩니다.
- 등록된 구성원으로 로그인해 회사 인증 화면에서 심플리까지 돌아왔습니다.
인증 서비스별 공식 설정 안내
섹션 제목: “인증 서비스별 공식 설정 안내”Okta 참고: SAML 입력 항목, 내부 앱 생성.