싱글 사인온(SSO) 구성하기

서비스 관리자는 ProtoPie Enterprise 환경에 대해 SSO를 구성할 수 있습니다.

SSO를 통해 멤버들은 Okta, Auth0, OneLogin 등 원하는 인증 소스를 통해 ProtoPie에 액세스할 수 있습니다. 이를 ID 제공업체(IdP)라고도 합니다. 이 방법을 통해 기업은 ProtoPie Enterprise에 대한 액세스 권한 제공을 중앙 집중화할 수 있습니다.

SSO는 사용자가 여러 개의 사용자 이름과 비밀번호를 관리할 필요 없이 단일 자격 증명 세트로 애플리케이션 및 웹사이트에 로그인할 수 있도록 하는 인증 체계입니다. 이미 많은 조직과 기업이 보안과 편리성을 보장하기 위해 내부 정책에 SSO를 포함하고 있습니다.

ProtoPie Enterprise는 두 가지 SSO 프로토콜을 지원합니다.

• SAML 2.0

• OpenID Connect (OIDC) – OAuth 2.0 기반

SAML SSO 설정하기

SAML 용어로 ProtoPie는 인증을 위해 ID 제공업체(IdP)와 통신해야 하는 서비스 제공업체(SP)입니다.

이를 설정하려면 IdP에 ProtoPie를 추가하십시오. 이는 결과적으로 ProtoPie의 어서션 소비자 서비스 URL(spAcsUrl)을 IdP에 입력하고, IdP의 IdP 메타데이터 URL을 ProtoPie에 입력하는 것을 의미합니다.

1. 서비스 관리자 설정에서 인증(Authentication)으로 이동합니다.

2. SAML을 활성화합니다.

3. 어서션 소비자 URL을 복사합니다.

IdP에 애플리케이션을 추가하는 방법은 IdP마다 다릅니다. 아래에는 Okta를 사용하기 위한 단계를 설명해 두었습니다.

Okta를 사용한 SAML SSO

Okta로 싱글 사인온(SSO)을 설정하려면 ProtoPie School의 이 간단한 단계별 비디오 자습서를 따르십시오.

• Okta를 사용한 SAML SSO 설정하기.

또는 아래 안내를 따르셔도 됩니다.

1. Okta에 로그인하고 애플리케이션(Applications) 페이지로 이동합니다.

2. 왼쪽 상단 모서리에 있는 애플리케이션 추가(Add Application)를 클릭합니다.

3. 오른쪽 상단 모서리에 있는 새 앱 만들기(Create New App)를 클릭합니다.

   

4. 로그인 방식(Sign on method)으로 SAML 2.0을 선택하고 만들기(Create)를 클릭합니다.

   

5. 일반 설정(General Settings) 아래의 앱 이름으로 ProtoPie를 입력합니다. 편의상  ProtoPie 로고를 업로드합니다. 그런 다음 다음(Next)을 클릭합니다.

   

6. SAML 설정과 관련하여 다음을 수행합니다.

   1. 복사한 어서션 소비자 URL을 싱글 사인온 URL(Single sign on URL) 및 대상 URI(Audience URI, SP 엔터티 ID) 필드에 모두 붙여넣습니다.

   2. 이름 ID 형식(Name ID format)으로 EmailAddress를 선택합니다.

   3. 이름(Name)에 firstName을 입력하고, 값(Value)에 user.firstName을 입력합니다. 그런 다음 값 추가(Add Another)를 클릭합니다.

   4. 이름(Name)에 lastName을 입력하고, 값(Value)에 user.lastName을 입력합니다.

   5. 다음(Next)을 클릭합니다.

      

7. 소프트웨어 공급업체입니다. Okta와 앱을 통합하고 싶습니다(I'm a software vendor. I'd like to integrate my app with Okta)를 선택하고 완료(Finish)를 클릭합니다.

   

8. Okta의 ProtoPie 앱에 사용자를 할당합니다. ProtoPie 애플리케이션으로 이동하여 할당(Assignments) 탭을 클릭합니다. 할당(Assign) 버튼을 클릭하여 사용자를 할당합니다.

   

9. 로그인(Sign On) 탭을 클릭한 다음 설정 지침 보기(View Setup Instructions)를 클릭합니다.

   

10. ID 제공업체 싱글 사인온 URL(Identity Provider Single Sign-On URL)은 기본적으로 필요한 IdP 메타데이터 URL입니다. 이를 복사합니다.

    

11. 서비스 관리자 설정의 인증(Authentication)으로 돌아갑니다.

12. 아직 활성화하지 않았다면 SAML을 활성화합니다.

13. 복사한 IdP 메타데이터 URL을 IdP 필드에 붙여넣습니다.

14. 업데이트(Update)를 클릭합니다.

다른 IdP를 사용한 SAML SSO

다른 IdP로 SAML SSO를 설정하려면 Okta와 마찬가지로 ProtoPie의 어서션 소비자 서비스 URL(spAcsUrl) 및 IdP의 IdP 메타데이터 URL을 사용합니다. 새 애플리케이션을 추가하는 방법은 선호하는 IdP의 설명서를 참조하십시오.

Azure AD를 사용한 SAML SSO

1. Azure에 로그인하여 Azure Active Directory에 액세스합니다.

2. 왼쪽에서 엔터프라이즈 애플리케이션(Enterprise applications)을 선택합니다.

3. 모든 애플리케이션(All applications) → 새 애플리케이션(New application)을 선택합니다.

4. Azure AD 갤러리(Azure AD Gallery)에서 Azure AD SAML Toolkit을 검색하여 선택한 후 추가합니다.

• 이름 필드에 ProtoPie를 입력합니다. 또한 원할 경우 ProtoPie 로고를 업로드할 수도 있습니다.

5. 애플리케이션이 추가되면 다음과 같이 추가된 애플리케이션의 개요를 확인할 수 있습니다. 그런 다음 시작하기(Getting Started) 메뉴에서 설정을 완료할 수 있습니다.

6. 사용자 또는 사용자 그룹을 설정하려면 사용자 및 그룹 할당(Assign users and groups) 메뉴를 선택합니다.

7. SSO 구성을 시작하려면 싱글 사인온 설정(Set up single sign-on) 메뉴를 선택합니다. SAML 방식을 선택합니다.

8. 값을 입력하려면 기본 SAML 구성 편집(Basic SAML Configuration Edit)을 선택합니다. 다음 값을 입력하십시오.

• 식별자 (엔터티 ID): https://PROTOPIE_DOMAIN/sp

• 회신 URL (어서션 소비자 서비스 URL): https://PROTOPIE_DOMAIN/api/auth/callback/sso/saml

• 이 값은 ProtoPie Admin Dashboard → Authentication → SAML → Assertion Consumer URL의 값과 동일합니다.

• 로그온 URL: https://PROTOPIE_DOMAIN/api/auth/login/sso/saml

9. SAML 서명 인증서(SAML Signing Certificate)에서 찾을 수 있는 앱 페더레이션 메타데이터 URL(App Federation Metadata URL)을 복사합니다.

10. ProtoPie 서비스 관리자 대시보드의 인증(Authentication) → SAML 메뉴로 이동하여 SAML을 활성화하고 다음 값을 입력합니다.

• 상태 컨텍스트(Authn Context): urn:oasis:names:tc:SAML:2.0:ac:classes:unspecified

• IdP URL (IdP 메타데이터 URL): 위에서 복사한 App Federation Metadata URL을 입력합니다.

OIDC SSO 설정하기

OpenID Connect(OIDC)는 OAuth 2.0 프레임워크 상단에 구축된 인증 프로토콜입니다.

OIDC SSO를 설정하려면 ProtoPie School의 이 간단한 단계별 비디오 자습서를 따르십시오.

• OIDC SSO 설정하기

또는 아래 안내를 따르셔도 됩니다.

이를 설정하려면 IdP에 ProtoPie를 추가하십시오. 이는 결과적으로 ProtoPie의 콜백 URL(loginUrl)을 IdP에 입력하고, IdP의 인증 URL, 토큰 URL, 클라이언트 ID, 클라이언트 보안 비밀번호를 ProtoPie에 입력하는 것을 의미합니다.

1. 서비스 관리자 설정에서 인증(Authentication)으로 이동합니다.

2. OIDC를 활성화합니다.

3. 콜백 URL을 복사합니다.

   

IdP에 애플리케이션을 추가하는 방법은 IdP마다 다릅니다. 아래에는 Okta를 사용하기 위한 단계를 설명해 두었습니다.

Okta를 사용한 OIDC SSO

1. Okta에 로그인하고 애플리케이션(Applications) 페이지로 이동합니다.

2. 왼쪽 상단 모서리에 있는 애플리케이션 추가(Add Application)를 클릭합니다.

   

3. 오른쪽 상단 모서리에 있는 새 앱 만들기(Create New App)를 클릭합니다.

   

4. 로그인 방식(Sign on method)으로 OpenID Connect를 선택하고 만들기(Create)를 클릭합니다.

   

5. 일반 설정(General Settings) 아래의 앱 이름으로 ProtoPie를 입력합니다. 편의상 ProtoPie 로고를 업로드합니다. 또한, 복사한 콜백 URL을 로그인 리디렉션 URI(Login redirect URIs) 필드에 붙여넣습니다. 그런 다음 저장(Save)을 클릭합니다.

   

6. Okta의 ProtoPie 앱에 사용자를 할당합니다. ProtoPie 애플리케이션으로 이동하여 할당(Assignments) 탭을 클릭합니다. 할당(Assign) 버튼을 클릭하여 사용자를 할당합니다.

   

7. 일반(General) 탭을 클릭합니다. 클라이언트 ID(client ID)와 클라이언트 보안 비밀번호(client secret)를 모두 복사합니다.

8. 로그인(Sign On) 탭을 클릭합니다. 인증 URL과 토큰 URL이 모두 필요합니다. 이 두 URL은 IdP마다 다릅니다. Okta의 경우, 인증 URL은 ${baseUrl}/oauth2/v1/authorize 구조를 가지며 토큰 URL은 ${baseUrl}/oauth2/v1/token 구조를 가집니다. 기본 URL로 OpenID Connect ID Token 아래의 발행자(Issuer)를 사용하십시오. 기본 URL을 구성하는 방법에 대해 더 알아보기.

   

9. 서비스 관리자 설정의 인증(Authentication)으로 돌아갑니다.

10. 아직 활성화하지 않았다면 OIDC를 활성화합니다.

11. 인증 URL, 토큰 URL, 클라이언트 ID, 클라이언트 보안 비밀번호를 입력합니다.

12. 업데이트(Update)를 클릭합니다.

다른 IdP를 사용한 OIDC SSO

다른 IdP로 OIDC SSO를 설정하려면 Okta와 마찬가지로 ProtoPie의 콜백 URL과 IdP의 인증 URL, 토큰 URL, 클라이언트 ID, 클라이언트 보안 비밀번호가 필요합니다. 새 애플리케이션을 추가하는 방법은 선호하는 IdP의 설명서를 참조하십시오.

멤버 관리하기

SSO가 활성화된 경우에도 ProtoPie Enterprise 자체에서 멤버를 관리해야 합니다. IdP에서 사용자를 추가하거나 제거하더라도 ProtoPie Enterprise에는 변경 사항이 자동으로 반영되지 않습니다.

IdP에서 사용자의 이메일 주소를 변경하는 경우, ProtoPie Enterprise에서도 동일하게 변경해야 합니다.

자주 묻는 질문(FAQ)