Confluence용 EasySSO와 Microsoft Entra SSO(싱글 사인 온) 통합

이 문서에서는 EasySSO for Confluence를 Microsoft Entra ID와 통합하는 방법에 대해 알아봅니다. EasySSO for Confluence를 Microsoft Entra ID와 통합하면 다음을 수행할 수 있습니다.

• Confluence에 대한 액세스 권한이 있는 사용자를 Microsoft Entra ID에서 제어합니다.
• 사용자가 해당 Microsoft Entra 계정으로 Confluence에 자동으로 로그인되도록 설정합니다.
• 하나의 중앙 위치에서 계정을 관리합니다.

필수 조건

이 문서에 설명된 시나리오에서는 다음과 같은 필수 구성 요소가 이미 있다고 가정합니다.

• 활성 구독이 있는 Microsoft Entra 사용자 계정입니다. 계정이 없다면 무료로 만들 수 있습니다.
• 다음 역할 중 하나입니다.
  • 애플리케이션 관리자
  • 클라우드 애플리케이션 관리자
  • 애플리케이션 소유자.

• EasySSO for Confluence SSO(Single Sign-On)가 활성화된 구독

시나리오 설명

이 문서에서는 테스트 환경에서 Microsoft Entra SSO를 구성하고 테스트합니다.

• EasySSO for Confluence는 SP 및 IDP에 의해 시작된 SSO를 지원합니다.
• EasySSO for Confluence는 Just-In-Time 사용자 프로비저닝을 지원합니다.

갤러리에서 EasySSO for Confluence 추가

EasySSO for Confluence가 Microsoft Entra ID에 통합되도록 구성하려면 갤러리의 EasySSO for Confluence를 관리형 SaaS 앱 목록에 추가해야 합니다.

1. 적어도 클라우드 애플리케이션 관리자로서 Microsoft Entra 관리 센터에 로그인하세요.
2. 아이덴티티>애플리케이션>엔터프라이즈 애플리케이션>새 애플리케이션으로 이동합니다.
3. 갤러리에서 추가 섹션에서, 검색 상자에 EasySSO for Confluence를 입력합니다.
4. 결과 패널에서 EasySSO for Confluence 선택한 다음, 앱을 추가합니다. 앱이 테넌트에 추가되는 동안 몇 초 정도 기다립니다.

또 다른 방법으로는 기업 앱 설정 마법사를 활용할 수도 있습니다. 이 마법사에서는 테넌트에 애플리케이션을 추가하고, 앱에 사용자/그룹을 추가하고, 역할을 할당하고, SSO 구성을 안내할 수 있습니다. Microsoft 365 마법사에 대해 자세히 알아보세요.

Microsoft Entra SSO for EasySSO for Confluence 구성 및 테스트

B.Simon이라는 테스트 사용자를 사용하여 EasySSO for Confluence에서 Microsoft Entra SSO를 구성하고 테스트합니다. SSO가 작동하려면 Microsoft Entra 사용자와 EasySSO for Confluence의 관련 사용자 간에 연결 관계를 설정해야 합니다.

EasySSO for Confluence에서 Microsoft Entra SSO를 구성하고 테스트하려면 다음 단계를 수행합니다.

1. Microsoft Entra SSO 구성 - 사용자가 이 기능을 사용할 수 있도록 합니다.
   1. Microsoft Entra 테스트 사용자 만들기 - B.Simon에서 Microsoft Entra Single Sign-On을 테스트합니다.
   2. Microsoft Entra 테스트 사용자 할당 - B.Simon이 Microsoft Entra Single Sign-On을 사용할 수 있도록 합니다.
2. EasySSO for Confluence SSO 구성 - 애플리케이션 쪽에서 Single Sign-On 설정을 구성합니다.
   1. EasySSO for Confluence 테스트 사용자 만들기 - B.Simon의 Microsoft Entra 표현과 연결된 대응 사용자를 EasySSO for Confluence에 생성합니다.
3. SSO 테스트 - 구성이 작동하는지 여부를 확인합니다.

Microsoft Entra SSO를 구성

다음 단계에 따라 Microsoft Entra SSO를 사용하도록 설정합니다.

1. 적어도 클라우드 애플리케이션 관리자로서 Microsoft Entra 관리 센터에 로그인하세요.

2. Identity>애플리케이션>엔터프라이즈 애플리케이션>EasySSO for Confluence>single sign-on브라우저에서 찾아보세요.

3. 단일 로그인 방법 페이지에서 SAML를 선택합니다.

4. SAML 사용하여 Single Sign-On 설정 페이지에서 기본 SAML 구성 연필 아이콘을 클릭하여 설정을 편집합니다.

   

5. 기본 SAML 구성 섹션에서, 애플리케이션을 IDP 시작 모드로 구성하려면 다음 필드의 값을 입력하세요.

   a. 식별자 텍스트 상자에서 https://<server-base-url>/plugins/servlet/easysso/saml 패턴을 사용하여 URL을 입력합니다.

   b. 회신 URL 텍스트 상자에서 https://<server-base-url>/plugins/servlet/easysso/saml 패턴을 사용하여 URL을 입력합니다.

6. SP 시작 모드에서 애플리케이션을 구성하려면 추가 URL 설정을 클릭하고 다음 단계를 수행합니다.

   로그인 URL 텍스트 상자에서 https://<server-base-url>/login.jsp 패턴을 사용하여 URL을 입력합니다.

   비고

   이러한 값은 실제 값이 아닙니다. 실제 식별자, 회신 URL 및 로그온 URL을 사용하여 이러한 값을 업데이트합니다. 의심스러운 경우 EasySSO 지원 팀 문의하여 이러한 값을 가져옵니다. 기본 SAML 구성 섹션에 표시된 패턴을 참조할 수도 있습니다.

7. EasySSO for Confluence 애플리케이션에는 특정 형식의 SAML 어설션이 필요하므로 SAML 토큰 특성 구성에 사용자 지정 특성 매핑을 추가해야 합니다. 다음 스크린샷은 기본 특성 목록을 보여줍니다.

   

8. 위에서 언급한 특성 외에도 EasySSO for Confluence 애플리케이션에는 아래에 표시된 SAML 응답에서 다시 전달되어야 하는 몇 가지 특성이 추가로 필요합니다. 이러한 특성도 미리 채워져 있지만 요구 사항에 따라 검토할 수 있습니다.

   이름	원본 특성
   urn:oid:0.9.2342.19200300.100.1.1	user.userprincipalname (사용자 기본 이름)
   urn:oid:0.9.2342.19200300.100.1.3	사용자메일
   urn:oid:2.16.840.1.113730.3.1.241	사용자 표시 이름
   urn:oid:2.5.4.4	사용자의 성
   urn:oid:2.5.4.42	user.givenname (사용자.이름)

   Microsoft Entra 사용자가 sAMAccountName로 구성되어 있으면, urn:oid:0.9.2342.19200300.100.1.1을(를) sAMAccountName 특성에 매핑해야 합니다.

9. SAML 사용하여 Single Sign-On 설정 페이지의 SAML 서명 인증서 섹션에서 인증서(Base64) 또는 페더레이션 메타데이터 XML 옵션에 대한 링크 다운로드 클릭하고 컴퓨터에 모두 저장합니다. 나중에 Confluence EasySSO를 구성하려면 필요합니다.

   

   인증서를 사용하여 EasySSO for Confluence 구성을 수동으로 수행하려는 경우, 아래 섹션에서 로그인 URL과 Microsoft Entra 식별자 를 복사하여 컴퓨터에 저장해야 합니다.

Microsoft Entra 테스트 사용자 만들기 및 할당

지침을 따라서 사용자 계정 빠른 시작을 생성하고 할당하여 B.Simon이라는 테스트 사용자 계정을 만드세요.

EasySSO for Confluence SSO 구성

1. 다른 웹 브라우저 창에서 EasySSO for Confluence 회사 사이트에 관리자로 로그인하고 앱 관리 섹션으로 이동합니다.

   앱 관리Manage Apps

2. 왼쪽에서 EasySSO 찾아 클릭합니다. 그런 다음 구성 단추를 클릭합니다.

   

3. SAML 옵션을 선택합니다. 그러면 SAML 구성 섹션으로 이동됩니다.

   

4. 위쪽에서 인증서 탭을 선택하면 다음 화면이 표시됩니다.

   

5. 이제 Microsoft Entra SSO 구성의 이전 단계에서 저장한 인증서(Base64) 또는 메타데이터 파일을 찾으십시오. 진행 방법에 대한 옵션은 다음과 같습니다.

   a. 컴퓨터의 로컬 파일에 다운로드한 앱 페더레이션 메타데이터 파일 사용합니다. 업로드 라디오 단추를 선택하고 운영 체제와 관련된 파일 업로드 대화 상자를 따릅니다.

   OR

   b. 앱 페더레이션 메타데이터 파일 열어 파일의 콘텐츠(일반 텍스트 편집기)를 보고 클립보드에 복사합니다. 입력 옵션을 선택하고 클립보드 콘텐츠를 텍스트 필드에 붙여넣습니다.

   OR

   다. 완전 수동 구성. 앱 페더레이션 인증서(Base64) 열어 파일의 콘텐츠(일반 텍스트 편집기)를 보고 클립보드에 복사합니다. IdP 토큰 서명 인증서 텍스트 필드에 붙여넣습니다. 그런 다음 일반 탭으로 이동하여 POST 바인딩 URL 및 엔터티 ID 필드를 이전에 저장한 로그인 URL 및 Microsoft Entra Identifier 대한 해당 값으로 채웁니다.

6. 페이지 아래쪽에서 저장 단추를 클릭합니다. 메타데이터 파일 또는 인증서 파일의 콘텐츠가 구성 필드로 구문 분석되는 것을 볼 수 있습니다. EasySSO for Confluence 구성이 완료되었습니다.

7. 최상의 테스트 환경을 위해 보기 & 느낌 탭으로 이동하고 SAML 로그인 단추 옵션을 선택합니다. 이렇게 하면 특히 Confluence 로그인 화면에서 별도의 단추를 사용하여 Microsoft Entra SAML 통합을 엔드투엔드 테스트할 수 있습니다. 이 단추를 켜두고 프로덕션 모드에 대한 배치, 색 및 번역도 구성할 수 있습니다.

   

   비고

   문제가 있는 경우 EasySSO 지원 팀문의하세요.

EasySSO for Confluence 테스트 사용자 만들기

이 섹션에서는 Confluence에서 Britta Simon이라는 사용자를 만듭니다. EasySSO for Confluence는 Just-In-Time 사용자 프로비저닝을 지원하며, 기본적으로 사용하지 않도록. 사용자 프로비저닝을 활성화하려면 EasySSO 플러그인 구성의 일반 섹션에서 성공적인 로그인 시 사용자 만들기 옵션을 명시적으로 선택해야 합니다. Confluence에 사용자가 아직 없는 경우 인증 후에 새 사용자가 만들어집니다.

그러나 사용자 첫 번째 로그인에서 자동 사용자 프로비저닝을 사용하도록 설정하지 않으려면 Confluence 인스턴스가 사용하는 백 엔드 사용자 디렉터리(예: LDAP 또는 Atlassian Crowd)에 사용자가 있어야 합니다.

SSO 테스트

IdP가 개시한 워크플로우

이 섹션에서는 내 앱을 사용하여 Microsoft Entra Single Sign-On 구성을 테스트합니다.

내 앱에서 EasySSO for Confluence 타일을 클릭하면 SSO를 설정한 Confluence 인스턴스에 자동으로 로그인됩니다. 내 앱에 대한 자세한 내용은 내 앱 소개를 참조하세요.

SP 주도 워크플로

이 섹션에서는 Confluence SAML 로그인 단추를 사용하여 Microsoft Entra Single Sign-On 구성을 테스트합니다.

이 시나리오에서는 Confluence EasySSO 구성 페이지의 Look & Feel 탭에서 SAML 로그인 단추 사용하도록 설정한 것으로 가정합니다(위 참조). 기존 세션과의 간섭을 방지하려면 브라우저 시크릿 모드에서 Confluence 로그인 URL을 엽니다. SAML 로그인 단추를 클릭하면 Microsoft Entra 사용자 인증 흐름으로 리디렉션됩니다. 성공적으로 완료되면 SAML을 통해 인증된 사용자로 Confluence 인스턴스로 다시 리디렉션됩니다.

Microsoft Entra ID에서 다시 리디렉션된 후 다음 화면이 표시될 수 있습니다.

이 경우 이 페이지 지침에 따라 atlassian-confluence.log 파일에 액세스해야 합니다. 오류에 대한 자세한 내용은 EasySSO 오류 페이지에 있는 참조 ID를 통해 확인할 수 있습니다.

로그 메시지를 소화하는 데 문제가 있는 경우 EasySSO 지원 팀문의하세요.

관련 콘텐츠

EasySSO for Confluence가 구성되면 세션 제어를 적용하여 조직의 중요한 데이터의 반출 및 반입을 실시간으로 보호할 수 있습니다. 세션 제어는 조건부 액세스에서 확장됩니다. Microsoft Defender for Cloud Apps를 사용하여 세션 제어를 적용하는 방법을 알아봅니다.