Single Sign-on 인증 구성하기

Enterprise Server 관리자는 서버의 싱글 사인온(SSO) 기능을 구성하고 활성화할 수 있습니다. 백엔드 구성 시스템을 통해 관리자는 서버 사용자를 위한 SSO 기능을 설정, 테스트, 활성화 및 비활성화할 수 있습니다. SSO 옵션은 Enterprise Server 브라우저 인터페이스에 로그인할 때 사용할 수 있습니다. 서버 사용자를 위해 SSO를 설정하면 회사 전체 시스템에서 사용하는 것과 동일한 자격 증명으로 서버에 편리하게 액세스할 수 있습니다.

  • SSO 사용이 강제되는 경우(브라우저 인터페이스의 Admin – Settings – Authentication 페이지에서 Enforce SSO (not applied to access from localhost) 옵션이 활성화된 경우), 사용자가 Enterprise Server 주소에 접속하면 곧바로 SSO 로그인 페이지가 표시됩니다.

  • Altium Designer에서 Enterprise Server 워크스페이스에 연결할 때도 SSO 액세스를 사용할 수 있습니다. 자세한 내용은 워크스페이스에 액세스하기 페이지를 참조하세요.

     
     

    EDMS.UnifiedLogin이(가) 정식 공개 상태가 되면 아래 단락을 'Open Beta Feature Moves to Public' 스니펫의 소스 코드로 업데이트하세요.

    Altium Designer 내에서 SSO 액세스 기능을 이용하려면 외부 브라우저를 통해 Enterprise Server 워크스페이스에 연결하는 ‘통합 로그인’ 방식을 사용해야 합니다. 이 기능은 오픈 베타 버전이며, Altium Designer의 고급 설정 대화 상자에서 EDMS.UnifiedLogin 옵션을 활성화하면 사용할 수 있습니다.

Enterprise Server 브라우저 인터페이스에 액세스하는 방법에 대한 자세한 내용은 브라우저 기반 인터페이스 살펴보기 페이지를 참조하세요.

내부 ID 공급자를 사용하는 경우 Enterprise Server는 해당 ID 공급자가 사용하는 HTTPS 인증서를 신뢰해야 합니다. 그렇지 않으면 Enterprise Server에서 해당 공급자에 연결하려고 할 때 오류가 발생합니다. 주요 공급업체(Okta, Entra ID 등)의 ID 공급자는 기본적으로 신뢰할 수 있는 적절한 인증서를 갖추고 있습니다.

SAML 싱글 사인온

Enterprise Server에서 SSO 시스템을 구성하고 활성화하면, 회사에서 지정한 ID 공급자(IdP)(예: Okta, OneLogin 등)를 통해 인증된 ID를 설정합니다. 이때 ID 어설션 통신은 표준화된 보안 어설션 마크업 언어(SAML 2.0)를 기반으로 합니다. 회사의 SSO 로그인 인터페이스가 아직 마련되어 있지 않다면 일반적으로 IdP가 제공하는 템플릿이나 예제를 기반으로 구축합니다. 이 인터페이스는 SAML 기반 인증 어설션 교환을 시작하고 회사 서비스에 대한 액세스를 제공합니다.

브라우저 인터페이스의 관리 – 설정 – 인증 페이지에 있는 SSO 드롭다운에서 SAML 옵션을 선택하면, 페이지에 Enterprise Server SSO 서비스용으로 사전 구성된 URL(Altium Metadata Configuration)과 IdP의 인증 연결 데이터(SAML Identity Provider Configuration)를 업로드하거나 수동으로 입력하는 옵션이 표시됩니다.

회사 서비스와 통합하도록 ID 공급자를 설정하면 해당 공급자로부터 IdP 구성 메타데이터를 받을 수 있습니다. 아래의 IdP 통합 예제를 참조하세요. Enterprise Server에서 SAML SSO 시스템을 구성하려면(아직 완료하지 않은 경우), 버튼을 사용하여 회사의 IdP가 생성한 SAML IdP 구성 XML 파일을 찾아 업로드하세요. 업로드된 IdP XML 파일은 시스템에서 구문 분석하여 주요 구성 필드(X509 Certificate, Identity Provider Issuer URL 및 IdP Single Sign-On URL)를 추출합니다. 또는 구성의 개별 요소(보안 인증서 및 URL)를 해당 필드에 수동으로 추가할 수도 있습니다.

버튼으로 통합 테스트를 실행하기 전까지는 SSO가 활성화되지 않습니다. 이 테스트는 SSO ID 확인 프로세스와 회사의 SSO 로그인을 검증합니다. 구성 테스트가 성공적으로 완료되면  버튼()을 클릭하여 설정을 저장하고 Enterprise Server에 적용할 수 있습니다.

  • 이후 수동으로 또는 구성 변경에 따라 SSO가 비활성화되면  클릭한 채 드래그하여 이동​ 버튼을 사용할 수 있게 되어 테스트 프로세스를 다시 실행할 수 있습니다.

  • 필요한 경우 Altium Metadata Configuration 설정의 Entity ID 필드를 변경할 수 있습니다(예: 두 서버 인스턴스 간의 혼동을 해소하기 위해).

  • SSO를 구성할 때는 ID 공급자가 제공하는 사용자 이름이 Enterprise Server에 있는 해당 기존 사용자의 Username과 정확히 일치하는지 확인하세요(사용자가 Built-in 인증을 사용하도록 구성되었는지, Windows 인증을 사용하도록 구성되었는지와 무관). 사용자 이름은 대소문자를 구분합니다.

ID 공급자 통합 예제

아래의 접이식 섹션을 펼치면 OneLogin을 ID 공급자로 통합하는 과정의 단계별 예제를 확인할 수 있습니다.

아래의 접이식 섹션을 펼치면 Okta를 ID 공급자로 통합하는 과정의 단계별 예제를 확인할 수 있습니다.

아래의 접을 수 있는 섹션을 펼치면 Microsoft Entra ID를 ID 공급자로 사용하는 통합 과정의 단계별 예제를 볼 수 있습니다.

아래의 접을 수 있는 섹션을 펼치면 JumpCloud를 ID 공급자로 사용하는 통합 과정의 단계별 예제를 볼 수 있습니다.

아래의 접을 수 있는 섹션을 펼치면 Microsoft Administrative Domain Federated Services(AD FS)를 ID 공급자로 사용하는 통합 과정의 단계별 예제를 볼 수 있습니다.

아래 접이식 섹션을 펼치면 AWS IAM Identity Center를 ID 공급자로 사용하는 통합 프로세스의 단계별 예제를 볼 수 있습니다.

OAuth / OIDC 싱글 사인온

Enterprise Server의 SSO 기능은 OAuth / OIDC 표준을 사용하여 구성할 수도 있습니다. 브라우저 인터페이스의 관리 – 설정 – 인증 페이지에 있는 SSO 드롭다운에서 OAuth / OIDC 옵션을 선택하면, 해당 페이지에서 선택한 IdP가 제공하는 데이터를 입력할 수 있습니다.

  • Application Credentials:

    • Client ID – IdP의 애플리케이션 ID입니다.

    • Client Secret – IdP의 애플리케이션 시크릿입니다.

  • Configuration:

    • Scopes to Request – 범위는 애플리케이션이 사용자에게 요청하는 액세스 수준을 정의합니다.

    • Authentication Endpoint – 이 엔드포인트는 사용자 인증 및 동의를 처리합니다. 애플리케이션은 사용자가 로그인하고 권한을 부여할 수 있도록 사용자를 이 엔드포인트로 리디렉션합니다.

    • Token Endpoint – 이 엔드포인트는 인증 코드 또는 새로 고침 토큰을 액세스 토큰으로 교환하는 데 사용됩니다. 애플리케이션과 인증 서버 간의 안전한 백채널 통신입니다.

    • User Profile Endpoint – 이 엔드포인트는 액세스 토큰을 사용하여 사용자 프로필 정보(예: 이름, 이메일)를 검색합니다. 반환되는 데이터는 인증 중에 부여된 범위에 따라 달라집니다.

  • Mappings – 표의 Mapped Attribute 필드에 Enterprise Server 측 사용자의 사용자 이름에 매핑할 특성을 입력합니다.

버튼을 눌러 통합 테스트를 실행하기 전까지는 SSO가 활성화되지 않습니다. 이 테스트는 SSO ID 확인 프로세스와 회사의 SSO 로그인을 검증합니다. 구성 테스트가 성공적으로 완료되면  버튼()을 클릭하여 설정을 저장하고 Enterprise Server에 적용할 수 있습니다.

이후 수동으로 또는 구성 변경으로 인해 SSO가 비활성화되면,  버튼이 활성화되어 테스트 프로세스를 다시 실행할 수 있습니다.

Entra ID를 사용하는 경우 OAuth 엔드포인트에 대해 두 가지 API 버전이 제공된다는 점에 유의하세요.

  • https://login.microsoftonline.com/{tenantId}/.well-known/openid-configuration

  • https://login.microsoftonline.com/{tenantId}/v2.0/.well-known/openid-configuration

이 중 한 버전에서 올바른 엔드포인트 세트(token/authorize/userinfo)를 가져와야 합니다. 서로 다른 버전을 혼용하면 Enterprise Server에서 Entra ID로 연결을 설정하려고 할 때 오류가 발생합니다.

AI-LocalizedAI로 번역됨
만약 문제가 있으시다면, 텍스트/이미지를 선택하신 상태에서 Ctrl + Enter를 누르셔서 저희에게 피드백을 보내주세요.
Contents
Contents