이벤트
자습서: Confluence용 Microsoft Entra SAML SSO에 대한 애플리케이션 프록시 구성
이 문서는 애플리케이션 프록시를 사용하여 온-프레미스 Confluence 애플리케이션에 대해 Microsoft Entra SAML SSO를 구성하는 데 도움이 됩니다.
Confluence SAML SSO by Microsoft와 Microsoft Entra 통합을 구성하려면 다음 항목이 필요합니다.
- Microsoft Entra 구독.
- Confluence 서버 애플리케이션이 Windows 64비트 서버(온-프레미스 또는 클라우드 IaaS 인프라)에 설치되어 있어야 합니다.
- Confluence 서버에서 HTTPS를 사용해야 합니다.
- 지원되는 Confluence 플러그 인 버전은 아래 섹션에 설명되어 있습니다.
- Confluence 서버는 인증을 위해 인터넷에서 특히 Microsoft Entra 로그인 페이지에 연결할 수 있으며 Microsoft Entra ID로부터 토큰을 받을 수 있어야 합니다.
- Confluence에 관리자 자격 증명이 설정되어 있어야 합니다.
- Confluence에서 WebSudo를 사용하지 않아야 합니다.
- Confluence 서버 애플리케이션에서 테스트 사용자를 생성해야 합니다.
시작하려면 다음 항목이 필요합니다.
- 꼭 필요한 경우가 아니면 프로덕션 환경을 사용하지 마세요.
- Microsoft Entra 구독. 구독이 없는 경우 무료 계정을 얻을 수 있습니다.
- Confluence SAML SSO by Microsoft SSO(Single Sign-On) 사용 구독
현재 기준으로 다음 버전의 Confluence가 지원됩니다.
- Confluence: 5.0 ~ 5.10
- Confluence: 6.0.1 ~ 6.15.9
- Confluence: 7.0.1 ~ 7.17.0
참고
Confluence 플러그 인도 Ubuntu 버전 16.04에서 작동한다는 점에 유의하세요.
이 자습서에서는 애플리케이션 프록시 모드를 사용하여 온-프레미스 Confluence 설정에 대해 Microsoft Entra SSO를 구성하고 테스트합니다.
- Microsoft Entra 프라이빗 네트워크 커넥터를 다운로드하여 설치합니다.
- Microsoft Entra ID에 애플리케이션 프록시를 추가합니다.
- Microsoft Entra ID에 Confluence SAML SSO 앱을 추가합니다.
- Microsoft Entra ID에서 SAML SSO Confluence 애플리케이션에 대한 SSO를 구성합니다.
- Microsoft Entra 테스트 사용자를 만듭니다.
- Confluence Microsoft Entra 앱에 대한 테스트 사용자를 할당합니다.
- Confluence 서버에서 Confluence SAML SSO by Microsoft Confluence 플러그 인에 대해 SSO를 구성합니다.
- Confluence 서버에서 Microsoft Confluence 플러그 인에 대한 테스트 사용자 할당.
- SSO를 테스트합니다.
최소한 애플리케이션 관리자 자격으로 Microsoft Entra 관리 센터에 로그인합니다.
ID>애플리케이션>엔터프라이즈 애플리케이션>애플리케이션 프록시로 이동합니다.
커넥터 서비스 다운로드를 선택합니다.
사용 약관에 동의하여 커넥터를 다운로드합니다. 다운로드되면 Confluence 애플리케이션을 호스트하는 시스템에 설치합니다.
애플리케이션 프록시를 추가하려면 엔터프라이즈 애플리케이션을 만들어야 합니다.
최소한 애플리케이션 관리자 자격으로 Microsoft Entra 관리 센터에 로그인합니다.
ID>애플리케이션>엔터프라이즈 애플리케이션>새 애플리케이션으로 이동합니다.
온-프레미스 애플리케이션 추가를 선택합니다.
애플리케이션의 이름을 입력하고 왼쪽 아래 열에서 만들기 단추를 클릭합니다.
사용자 고유의 온-프레미스 애플리케이션 추가에서 다음 설정을 입력합니다.
- 내부 URL은 Confluence 애플리케이션 URL입니다.
- 외부 URL은 선택한 이름에 따라 자동으로 생성됩니다.
- 사전 인증은 기본값으로 Microsoft Entra ID에 맡길 수 있습니다.
- 커넥터 에이전트가 아래에 활성으로 표시되는 커넥터 그룹을 선택합니다.
- 추가 설정을 기본값으로 둡니다.
상단 옵션에서 저장을 클릭하여 애플리케이션 프록시를 구성합니다.
이제 환경을 준비하고 커넥터를 설치했으므로 Microsoft Entra ID에 Confluence 애플리케이션을 추가할 준비가 되었습니다.
- 최소한 애플리케이션 관리자 자격으로 Microsoft Entra 관리 센터에 로그인합니다.
- ID>애플리케이션>엔터프라이즈 애플리케이션>새 애플리케이션으로 이동합니다.
- Microsoft Entra 갤러리에서 Confluence SAML SSO by Microsoft 위젯을 선택합니다.
최소한 응용 프로그램 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
ID>애플리케이션>엔터프라이즈 애플리케이션으로 이동합니다.
Confluence SAML SSO by Microsoft>Single sign-on을 엽니다.
Single Sign-On 방법 선택 페이지에서 SAML을 선택합니다.
SAML로 Single Sign-On 설정 페이지에서 기본 SAML 구성에 대한 연필 아이콘을 클릭하여 설정을 편집합니다.
기본 SAML 구성 섹션에서 식별자, 회신 URL, 로그온 URL 필드에 대한 외부 URL 값을 입력합니다.
이 섹션에서는 B.Simon이라는 사용자를 만듭니다.
- 최소한 사용자 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
- ID>사용자>모든 사용자로 이동합니다.
- 화면 위쪽에서 새 사용자>새 사용자 만들기를 선택합니다.
- 사용자 속성에서 다음 단계를 수행합니다.
- 표시 이름 필드에서
B.Simon을 입력합니다. - 사용자 계정 이름 필드에서 username@companydomain.extension을 입력합니다. 예:
B.Simon@contoso.com. - 암호 표시 확인란을 선택한 다음, 암호 상자에 표시된 값을 적어둡니다.
- 검토 + 만들기를 선택합니다.
- 표시 이름 필드에서
- 만들기를 선택합니다.
이 섹션에서는 Azure Single Sign-On을 사용할 수 있도록 Confluence Microsoft Entra 앱에 Confirmit Horizons에 대한 액세스 권한을 부여합니다.
최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
ID>애플리케이션>엔터프라이즈 애플리케이션>Confluence SAML SSO by Microsoft로 이동합니다.
앱의 개요 페이지에서 관리 섹션을 찾고 사용자 및 그룹을 선택합니다.
사용자/그룹 추가를 선택한 다음, 할당 추가 대화 상자에서 사용자 및 그룹을 선택합니다.
사용자 및 그룹 대화 상자의 사용자 목록에서 B.Simon을 선택한 다음, 화면 아래쪽에서 선택 단추를 클릭합니다.
할당 추가 대화 상자에서 할당 단추를 클릭합니다.
구성된 테스트 사용자가 온-프레미스 애플리케이션에 언급된 외부 URL을 사용하여 SSO를 수행할 수 있는지 확인하여 애플리케이션 프록시 설정을 확인합니다.
참고
이 자습서에 따라 JIRA SAML SSO by Microsoft 애플리케이션의 설정을 완료합니다.