Integration Atlassian Guard with Entra ID(fka Azure AD)

This explains how to use SAML and SSO by integrating Guard and Entra ID.

Requirements

Entra ID

1. Log in to the Microsoft Entra admin center as a Cloud Application Administrator.

2. Move to ID → Application → Enterprise Application → New Application.

엔터프라이즈 애플리케이션 설정 화면

3. Type "Atlassian Cloud" in the search box of the additional section in the Gallery.

Atlassian App 검색

4. Click Create to add an Atlassian cloud app.

App 추가

SAML 설정

1. After logging into admin.atlassian.com, select Security → Identity Provider → Azure AD.

IdP 선택

2. After setting the directory name, select “Manually configure user provisioning settings” in the Azure options.

Entra ID 설정

3. Click on SAML Single Sign-On Settings.

등록

4. Click Next.

안내 화면

5. Open a new browser window to Add SAML Details and log in to the Microsoft Entra admin center as a Cloud Application Administrator.

6. Move to ID → Application → Enterprise Application and click Atlassian Cloud. Then select Single Sign-On settings below.

SSO 설정

7. Click on SAML in the SSO method selection.

SAML 선택

8. On the Single Sign-On setup page with SAML, scroll down to configure Atlassian Cloud. Copy the “Login URL” and Microsoft Entra identifier.

9. Paste it into the Atlassian Guard setting.

Guard SAML 설정

10. In the SAML Signature Certificate section, after finding the Certificate (Base64), click Download to download the certificate to your computer, then open the file with an editor.

BASE64 인증서 저장

11. Copy the certificate and paste it into the "Public x509 certificate" field of Atlassian Guard, then click Next.

X509 인증서 복사

12. The Entity URL and ACS (Assertion Consumer Service) will be displayed. After copying this value, switch to "Set up Single Sign-On with SAML" in Microsoft Entra ID.

IdP 에 설정할 URL

13. Click “Basic SAML Configuration" and click Edit.

기본 SAML 구성

14. With the copied values from 12, paste the “Service Provider Entity URL” into the Identifier (Entity ID) field, and paste the “Service Provider ACS URL” into the Reply URL. Then, add the address of the Atlassian Cloud you are using to the “Login URL”. (like hkmc-cci.atlassian.net)

Entra ID 에 Guard URL 설정

15. Edit attributes & claims

특성 및 클레임 설정

16. 고유한 사용자 id를 클릭합니다.

15. Atlassian Cloud에는 nameidentifier(고유한 사용자 식별자)가 사용자의 이메일(user.email)에 매핑되야 합니다.
M365 가 있을 경우 원본 특성을 편집하고 user.mail로 변경한후 저장합니다.

M365가 있을 경우 매핑

최종적으로 아래와 같이 매핑되야 합니다.

특성 및 클레임
givenname       user.givenname
surname         user.surname
emailaddress    user.mail
name            user.userprincipalname
고유한 사용자 ID   user.mail

M365가 없을 경우 해당 사용자에 대한 이메일을 userprincipalname 특성에 저장하므로 user.userprincipalname으로 변경후 저장합니다.

M365가 없을 경우 매핑

최종적으로 아래와 같이 매핑되야 합니다.

특성 및 클레임
givenname       user.givenname
surname         user.surname
emailaddress    user.mail
name            user.userprincipalname
고유한 사용자 ID   user.userprincipalname

16. 설정이 끝났으면 SSO 테스트 버튼을 눌러서 정상 동작 여부를 확인합니다.

SSO 테스트

17. 이제 Guard 로 돌아와서 다음을 클릭한 후 IdP 와 연결할 도메인을 선택해 줍니다.

도메인 연결

18. SAML 구성이 끝났습니다. “중지 및 SAML 저장" 을 클릭합니다.

SAML 구성 완료

Set up provisioning

1. On the Security → Identity Providers → “Microsoft Entra ID” screen, click User Provisioning.

사용자 프로비저닝 시작

2. Read the prompts and click Next.

안내 화면

2. Copy the generated SCIM base URL (1) and API key (2).

SCIM URL 과 API Key

3. Log in to the Microsoft Entra Admin Center and click on “User Account Prospecting”.

사용자 계정 프로 비전 선택

4. On the “Identity Lifecycle Automation” screen, click the Start button.

프로비저닝 시작

5. On the Credentials screen, copy the directory base URL(1 ) created by Guard in step 1 to “Tenant URL”, paste the API key(2 ) into Secret Token, click Test Connection, and then click Save.

SCIM 기본 URL 연결 설정

6. Once provisioning starts, check the “Provisioning log” to make sure it's working properly.