> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Microsoft Entra ID를 사용한 Single Sign-On(SAML)
> Microsoft Entra ID와 Iru Endpoint 간 SAML 기반 SSO를 구성합니다. Microsoft Entra ID에서 엔터프라이즈 애플리케이션을 설정하고 로그인을 위한 사용자 속성을 매핑합니다.
### Microsoft Entra ID SAML 통합 정보
Iru Endpoint의 Microsoft Entra ID SAML 통합을 사용하면 Microsoft Entra ID 자격 증명으로 Iru Endpoint에 접근하는 사용자를 위해 Microsoft Entra ID와의 SAML 기반 SSO 통합을 설정할 수 있습니다.
#### 작동 방식
사용자가 Iru Endpoint에 접근하려고 하면 인증을 위해 Microsoft Entra ID로 리디렉션됩니다. 인증에 성공하면 Microsoft Entra ID는 SAML 어설션을 Iru Endpoint로 다시 보내고, Iru Endpoint는 사용자의 신원을 검증하여 접근 권한을 부여합니다. SSO는 [Iru Endpoint 웹 앱](/ko/endpoint/getting-started/foundation/admins-and-access) 로그인 및 [Automated Device Enrollment 시 인증 요구](/ko/endpoint/enrollment/configure-require-authentication-for-enrollment)에 사용할 수 있습니다.
Microsoft Entra ID는 Azure AD(Azure Active Directory)의 [새 이름](https://learn.microsoft.com/en-us/entra/fundamentals/new-name)입니다.
### SAML 연결 설정
Microsoft Entra ID에 필요한 구성 정보를 얻으려면 먼저 Iru Endpoint에서 초기 설정을 완료해야 합니다. Entity ID와 ACS URL을 복사한 후 [**Microsoft Entra ID 구성**](#microsoft-entra-id-configuration) 탭으로 전환하여 [**Microsoft Entra ID 애플리케이션 구성**](#configuring-microsoft-entra-id-application)을 계속 진행하세요.
Iru Endpoint의 사이드바에서 [**계정 메뉴 버튼**](/ko/iru/platform-overview/account-menu)을 선택합니다.
메뉴에서 **액세스** 옵션을 선택합니다.
**관리자 및 인증** 탭(기본적으로 선택됨)을 선택하고 **인증 방법**까지 아래로 스크롤합니다.
**+ 인증 방법**를 선택합니다.
SSO 연결의 표시 이름을 입력합니다.
인증 방법으로 **SAML**을 선택합니다.
**만들기**를 선택합니다.
**구성 정보** 섹션이 아직 펼쳐져 있지 않으면 선택합니다.
나중에 사용할 수 있도록 **Service provider entity ID**를 텍스트 문서에 복사합니다. Entra ID 구성에 필요합니다.
나중에 사용할 수 있도록 **Assertion consumer service (ACS) URL**을 텍스트 문서에 복사합니다. Entra ID 구성에 필요합니다.
Iru Endpoint 구성 모달을 열어 둔 상태에서 [**Microsoft Entra ID 구성**](#microsoft-entra-id-configuration) 탭으로 전환하여 [**Microsoft Entra ID 애플리케이션 구성**](#configuring-microsoft-entra-id-application)을 계속 진행합니다.
### Iru Endpoint SAML 연결 구성
Microsoft Entra ID 구성을 완료한 후 여기로 돌아와 Iru Endpoint에서 [**Iru Endpoint SAML 연결 구성**](#configuring-iru-endpoint-saml-connection)을 마무리하세요. Microsoft Entra ID의 Single Sign-on URL, IdP Entity ID 및 인증서가 필요합니다.
Iru Endpoint의 Custom SAML 모달로 돌아갑니다.
**IdP attribute**를 **제목**으로 설정합니다.
**Attribute name**은 비워 둡니다.
**User attribute**를 \*\*User Principal Name (UPN)\*\*으로 설정합니다.
앞서 복사한 **Microsoft Entra Identifier**를 **IdP Entity ID** 필드에 붙여 넣습니다.
Entra ID에서 복사한 **Sign In URL**을 붙여 넣습니다.
Entra ID에서 다운로드한 **인증서**를 업로드합니다.
**Protocol Binding**을 **HTTP-POST**로 설정합니다.
**Request Algorithm**이 **RSA-SHA256**으로 설정되어 있는지 확인합니다.
**Sign Request Algorithm Digest**가 **SHA256**으로 설정되어 있는지 확인합니다.
**Sign Request**가 활성화되어 있는지 확인합니다.
**Response Signature Verification**을 **Assertion**으로 설정합니다.
**Destination** 필드는 비워 둡니다.
**Allowed Signature Algorithm**을 **RSA-SHA256**으로 설정합니다.
**Allowed Digest Algorithm**을 **SHA256**으로 설정합니다.
**저장**을 선택합니다.
### 테넌트 인증 허용
Iru Endpoint와 ID 공급자에서 SAML 연결을 구성한 후에는 테넌트 인증에 사용하도록 허용할 수 있습니다. 단계별 지침은 [Single Sign-on 지원 문서](/ko/endpoint/integrations/single-sign-on-integrations/single-sign-on)의 **테넌트 인증 허용 및 연결 관리** 섹션을 참조하세요.
### 도메인으로 인증 제한
SAML 연결을 구성할 때 선택적으로 인증을 하나 이상의 도메인으로 제한할 수 있습니다. 이는 SSO 연결이 여러 도메인에 인증할 수 있는 경우에 유용합니다. Iru 테넌트에 대한 인증을 사용 가능한 도메인의 일부로 제한할 수 있습니다.
### Single Sign-On 강제 적용
하나 이상의 Single Sign-on 연결을 구성한 후에는 Passkey, Google Social, Microsoft Social 연결을 비활성화할 수 있습니다. 이러한 연결을 비활성화하면 테넌트의 Iru Endpoint 관리자가 해당 방법으로 인증할 수 없게 됩니다. 단계별 지침은 [Single Sign-on 지원 문서](/ko/endpoint/integrations/single-sign-on-integrations/single-sign-on)를 참조하세요.
## 고려 사항
**보안**: Microsoft Entra ID 테넌트에 SSO 인증을 위한 적절한 보안 정책이 구성되어 있는지 확인하세요.
**사용자 관리**: SSO를 통해 성공적으로 인증하려면 사용자가 Microsoft Entra ID와 Iru Endpoint 모두에 존재해야 합니다.
**테스트**: 조직 전체에 배포하기 전에 항상 소규모 사용자 그룹으로 SSO 통합을 테스트하세요.
### 통합 테스트
**New User**를 선택하여 Iru Endpoint의 **Admin Team**에 사용자를 추가합니다.
해당하는 사용자 정보를 모두 입력합니다. 이 사용자는 Microsoft Entra ID에 존재해야 하며 Microsoft Entra ID 테넌트의 Iru Endpoint SSO 앱에 할당되어 있어야 합니다.
**제출**을 선택합니다.
초대가 제출되면 Invite User 창을 닫습니다.
Iru Endpoint의 Access 페이지를 새로 고칩니다. 방금 추가한 사용자가 표시되어야 합니다.
사용자의 이메일을 확인하고 초대를 수락한 다음 새 SAML SSO 연결로 Iru Endpoint에 로그인합니다.
Microsoft Entra ID 구성을 시작하기 전에 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭에서 [**SAML 연결 설정**](#setting-up-the-saml-connection)을 완료하여 Service Provider Entity ID와 ACS URL을 가져오세요. Microsoft Entra ID 애플리케이션을 구성하려면 이 값들이 필요합니다.
### Microsoft Entra ID 애플리케이션 구성
[Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인합니다.
왼쪽 탐색 모음에서 **Entra ID** 섹션이 펼쳐져 있는지 확인합니다.
왼쪽 탐색 모음에서 **Enterprise apps**를 선택합니다.
**+ New application**을 선택합니다.
**Create your own application**을 선택합니다.
애플리케이션에 **이름**을 지정합니다.
\*\*Integrate any other application you don't find in the gallery (Non-gallery)\*\*를 선택합니다.
**만들기**를 선택합니다.
**관리**에서 **Single sign-on**을 선택합니다.
**SAML** 타일을 선택합니다.
Basic SAML configuration 상자에서 **편집** 연필 아이콘을 선택합니다.
Identifier (Entity ID) 섹션에서 Add Identifier 링크를 선택합니다. 앞서 복사한 Entity ID를 Identifier (Entity ID) 필드에 붙여 넣습니다.
Reply URL (Assertion Consumer Service URL) 섹션에 앞서 복사한 Assertion Consumer Services URL을 붙여 넣습니다.
**저장**을 선택합니다.
창 오른쪽 상단의 **X**를 선택하여 닫습니다.
**Attributes & Claims section**의 설정은 기본값으로 둡니다.
SAML Certificates 섹션에서 **다운로드**를 선택하여 Base 64 인증서를 다운로드합니다. 이 인증서는 Iru Endpoint의 Custom SAML 구성에 사용됩니다.
**Set up \[App Name]** 섹션에서 Login URL을 복사하여 나중에 사용할 수 있도록 안전한 텍스트 문서에 붙여 넣습니다.
**Microsoft Entra Identifier**를 복사하여 텍스트 문서에 저장합니다. 이 값을 Iru Endpoint의 **IdP Entity ID** 필드에 붙여 넣게 됩니다. 애플리케이션의 **개요** 섹션에서 찾을 수 있습니다.
**App registrations**로 이동합니다.
새로 생성한 앱을 선택합니다.
**관리** 아래의 **Token configuration** 섹션으로 이동합니다.
**+ Add optional claims**를 선택합니다.
**ID** 라디오 버튼을 선택합니다.
**acct** 상자를 선택합니다.
**email** 상자를 선택합니다.
**upn** 상자를 선택합니다.
**추가**를 선택합니다.
**Turn on the Microsoft Graph email, profile permission (required for claims to appear in token)** 상자를 선택합니다.
**추가**를 선택합니다.
Microsoft Entra Identifier는 Iru 구성에서 IdP Entity ID로 사용됩니다.
### 사용자 및 그룹 할당
**Enterprise apps**에서 새로 생성한 앱으로 이동합니다.
**관리**에서 **Users and Groups**를 선택합니다.
메뉴에서 **Add user/group**을 선택합니다.
**Add Assignment** 대화 상자에서 **Users and groups** 아래의 링크를 선택합니다.
사용자 및 보안 그룹 목록이 표시됩니다. 특정 사용자 또는 그룹을 검색할 수 있으며, 목록에 표시되는 여러 사용자와 그룹을 선택할 수도 있습니다.
사용자와 그룹을 선택한 후 **선택**을 선택합니다.
**할당**을 선택하여 앱에 사용자와 그룹 할당을 완료합니다.
추가한 사용자와 그룹이 **Users and groups** 목록에 표시되는지 확인합니다.
또는 사용자와 그룹을 할당하지 않으려면 앱이 할당을 요구하지 않도록 설정할 수 있습니다.
**Enterprise apps**에서 새로 생성한 앱으로 이동합니다.
Manage에서 **Properties**를 선택합니다.
\*\*Assignment required?\*\*를 **아니요**로 설정합니다.
**저장**을 선택합니다.
무료 등급 제한에 대한 메시지가 표시되면 무료 등급을 사용하고 있다는 의미입니다. Single Sign-On Enterprise App에서는 사용자만 추가할 수 있습니다(그룹은 추가할 수 없음).
Microsoft Entra ID 구성을 완료한 후 **Iru 웹 앱 구성** 탭으로 돌아가 Microsoft Entra ID에서 복사한 SSO URL, Entity ID 및 인증서를 사용하여 SAML 연결 설정을 마무리하세요.