> ## 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로 Passport 웹 로그인 구성
> Iru Endpoint에서 Microsoft Entra ID 웹 로그인을 사용하여 Passport를 구성합니다. macOS 암호 동기화를 위한 브라우저 기반 Microsoft Entra ID 인증을 설정합니다.
이 가이드는 Mac 컴퓨터에 적용됩니다
### Microsoft Entra ID 웹 로그인을 사용한 Passport 정보
Microsoft Entra ID 웹 로그인을 사용한 Passport는 조직의 Microsoft Entra ID 로그인 페이지 웹 보기를 통해 사용자를 로그인시키므로 로그인 시 조건부 액세스와 MFA를 실행할 수 있습니다. Mac 로그인(웹 보기 없이 Mac 로그인 창에서 사용자 이름과 암호 입력)의 경우 [Microsoft Entra ID로 Passport 구성 - Mac 로그인](/ko/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-mac-login)을 사용하세요.
**2026년 6월 15일**부터 Microsoft Entra ID는 Passport 로그인에 대한 조건부 액세스를 다르게 처리합니다. 기존 Passport **웹 로그인** 배포는 일부 경우에만 업데이트가 필요합니다. [2026년 6월 15일 이전 필수 변경 사항](#june-2026-conditional-access-change)을 참조하세요. Microsoft는 [이 문서](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions)에서 변경 사항을 설명합니다.
Passport를 처음 설정하는 경우 이 문서의 처음부터 계속 진행하세요. 설정 지침에는 해당되는 경우 이미 이러한 업데이트가 포함되어 있습니다.
### 작동 방식
Passport는 macOS 로그인 화면에서 Microsoft Entra ID 테넌트와 통합됩니다. 웹 로그인 모드에서 사용자는 로컬 Mac 세션이 생성되거나 업데이트되기 전에 해당 웹 보기에서 Entra ID 로그인(필요한 경우 MFA 포함)을 완료합니다.
### 사전 요구 사항
* Passport 앱에 올바른 권한을 부여할 수 있는 Microsoft Entra ID 관리자 계정에 대한 액세스 권한.
* Microsoft Entra ID의 MFA 설정은 [Microsoft의 MFA 구성 가이드](https://learn.microsoft.com/en-us/entra/identity/authentication/howto-mfa-mfasettings)를 참조하세요.
### 앱 등록 생성
전역 관리자 계정을 사용하여 [Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인합니다.
사이드바의 Entra ID 범주에서 **App registrations**를 선택합니다.
App registrations의 메뉴에서 **+ New registration**을 선택합니다.
새 애플리케이션의 이름(예: *Iru Passport 웹 로그인*)을 입력합니다.
**지원되는 계정 유형**에서 드롭다운을 열고 **Single tenant only**를 선택합니다(이 옵션에는 테넌트 이름도 표시됨, 예: **Single tenant only - *Accuhive***). Passport는 조직 내에서만 단일 테넌트여야 합니다. [Microsoft Entra ID에 애플리케이션 등록](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)을 참조하세요.
Redirect URI 섹션에서 **Select a platform** 드롭다운을 열고 \*\*Public client/native (mobile & desktop)\*\*을 선택합니다.
URI 필드에 `https://localhost`를 입력합니다. 이 리디렉션 URI는 [Passport Library Item을 구성](/ko/endpoint/library/passport/configure-the-passport-library-item)할 때 사용합니다.
```
https://localhost
```
리디렉션 URI 제한, 플랫폼 유형 및 모범 사례에 대한 자세한 내용은 [Microsoft의 리디렉션 URI 문서](https://learn.microsoft.com/en-us/entra/identity-platform/reply-url)를 참조하세요.
**등록**을 선택합니다.
### 구성 세부 정보 수집
이 OIDC 앱의 값을 임시로 저장할 수 있는 보안 텍스트 문서를 엽니다. [Passport Library Item을 구성](/ko/endpoint/library/passport/configure-the-passport-library-item)할 때 이 세부 정보가 필요합니다.
#### Overview 창
앱 개요에서 애플리케이션(클라이언트) ID를 복사합니다. Passport Library Item에 필요합니다.
왼쪽 메뉴에서 **개요**를 선택하여 해당 창을 엽니다.
**Application (client) ID**를 보안 문서에 복사합니다.
#### Endpoints 창
Endpoints에서 OpenID Connect 메타데이터 URL을 복사합니다. 이는 Passport가 로그인 및 토큰 엔드포인트를 검색하는 데 사용하는 ID 공급자 URL입니다.
상단 메뉴에서 **Endpoints**를 선택하여 해당 창을 엽니다.
**OpenID Connect metadata document**(ID 공급자 URL)를 보안 문서에 복사합니다.
오른쪽 상단의 **X**를 선택하여 Endpoints 창을 닫습니다.
#### Authentication (Preview) 창
Mac 앱이 클라이언트 암호 없이 로그인 흐름을 완료할 수 있도록 공용 클라이언트 흐름을 활성화합니다.
왼쪽 메뉴에서 \*\*Authentication (Preview)\*\*를 선택하여 해당 창을 엽니다.
**설정** 탭을 선택합니다.
**Allow public client flows**를 **Enabled**로 설정합니다.
**저장**을 선택합니다.
#### Token Configuration 창
토큰에 Passport에 필요한 사용자 이름과 그룹 멤버십이 포함되도록 필요한 클레임을 추가합니다.
왼쪽 메뉴에서 **Token configuration**을 선택하여 해당 창을 엽니다.
**Add optional claim**을 선택합니다.
Token type으로 **ID**를 선택합니다.
Claim으로 **preferred\_username**을 선택합니다.
**추가**를 선택합니다.
**Add groups claim**을 선택합니다.
**모든 그룹**을 선택합니다.
Entra ID SAML은 최대 150개의 보안 그룹만 지원합니다. 보안 그룹이 150개를 초과하는 경우 **모든 그룹**을 사용하지 말고 특정 그룹을 선택해야 합니다. 자세한 내용은 Microsoft의 [Microsoft Entra ID를 사용하여 애플리케이션에 대한 그룹 클레임 구성](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/how-to-connect-fed-group-claims) 문서를 참조하세요.
**추가**를 선택합니다.
토큰 구성을 완료하면 두 개의 선택적 클레임이 모두 표시됩니다.
### API 권한
Passport에 필요한 Microsoft Graph 권한(email, profile, User.Read)을 추가하고 사용자가 로그인할 수 있도록 관리자 동의를 부여합니다.
왼쪽 메뉴에서 **API permissions**를 선택하여 해당 창을 엽니다.
**Add a permission**을 선택합니다.
**Microsoft Graph**를 선택합니다.
**Delegated permissions**를 선택합니다.
**OpenID permissions** 섹션이 펼쳐져 있는지 확인합니다. 펼쳐져 있지 않으면 옆의 아이콘을 선택하여 펼칩니다.
**email**과 **profile**을 선택합니다.
**Select permissions** 검색 필드에 **User.Read**를 입력합니다.
User 섹션에서 **User.Read**가 이미 선택되어 있는지 확인합니다. 선택되어 있지 않으면 선택합니다.
**Add permissions**를 선택합니다.
\*\*Grant admin consent for \[your tenant]\*\*를 선택합니다.
**예**를 선택합니다.
각 권한의 **상태** 열에 ** Granted for \[your tenant]** 메시지가 있는지 확인합니다.
### 사용자 및 그룹 할당
Passport 앱을 사용할 수 있는 사람과 사용자 포털에 앱이 표시되는지 여부를 구성합니다. 기본적으로 Entra ID의 모든 사용자가 앱을 사용할 수 있으며, 아래 단계에서는 Properties 설정과 필요한 경우 사용자 또는 사용자 및 그룹 할당을 다룹니다.
왼쪽의 Entra ID 탐색 메뉴에서 **Enterprise Apps**를 선택합니다.
All applications 목록에서 **Iru Passport 웹 로그인** 또는 이전 섹션에서 App registration에 지정한 이름을 선택합니다.
왼쪽 메뉴의 **관리** 범주에서 **Properties**를 선택하여 해당 창을 엽니다.
선택적으로 엔터프라이즈 앱에 로고를 추가합니다.
**Assignment required?** 설정을 확인합니다.
* **아니요**: 사용자 또는 사용자 및 그룹을 할당할 필요가 없습니다.
* **예**: 사용자 또는 사용자 및 그룹을 할당해야 합니다.
\*\*Visible to users?\*\*를 **아니요**로 설정합니다.
**예**인 경우 사용자의 포털에 앱이 표시됩니다. Passport 앱은 macOS 로그인 창을 대체하는 용도로만 유용합니다.
**저장**을 선택합니다.
\*\*Assignment required?\*\*가 **아니요**로 설정되어 있으면 [Passport를 사용한 사용자 계정 프로비저닝](#user-account-provisioning-via-passport)으로 바로 이동할 수 있습니다. **예**로 설정되어 있으면 아래 단계를 계속 진행하세요.
#### 할당 필요
Passport 엔터프라이즈 애플리케이션의 \*\*Assignment required?\*\*가 **예**로 설정된 경우 아래 단계에 따라 사용자 또는 사용자 및 그룹을 할당하세요.
왼쪽 메뉴의 **관리** 범주에서 **Users and groups**를 선택하여 해당 창을 엽니다.
메뉴에서 **+ Add user/group**을 선택합니다.
**Add Assignment** 페이지의 **사용자** 또는 **Users and groups** 제목 아래에서 **None selected** 링크를 선택하여 앱을 사용할 수 있는 사람을 선택합니다.
Microsoft Entra ID 플랜에 따라 그룹이 아닌 사용자만 할당할 수 있습니다. 이 경우 제목에 **사용자**가 표시되며 그룹 할당을 사용할 수 없습니다.
사용자 또는 사용자 및 보안 그룹 목록이 표시됩니다. 특정 사용자나 그룹을 검색하거나 목록에 표시된 여러 사용자 또는 사용자 및 그룹을 선택할 수 있습니다.
사용자 또는 사용자 및 그룹을 선택한 후 **선택**을 선택합니다.
**할당**을 선택하여 앱에 대한 사용자 또는 사용자 및 그룹 할당을 완료합니다.
추가한 사용자 또는 사용자 및 그룹이 **Users and groups** 목록에 표시되는지 확인합니다.
Entra ID 구성의 이 부분이 완료되면 Microsoft Entra ID 환경에 대한 이 문서의 나머지 섹션을 검토하세요.
### Microsoft Entra ID 조건부 액세스 고려 사항
[Microsoft Entra ID 조건부 액세스](https://learn.microsoft.com/en-us/entra/identity/conditional-access/)는 Microsoft Entra ID Premium 이상에 포함되어 있습니다. Microsoft Entra ID 조건부 액세스 정책을 켜기 전에 사용자별 MFA와 보안 기본값을 모두 끄세요.
아래 단계를 완료하여 **Passport - CA Policy API**를 등록하고, 해당 범위를 Passport 앱에 추가하며, 해당 앱을 적용 가능한 정책에서 제외합니다. 조건부 액세스를 사용하지 않는 경우 이 섹션을 건너뛰세요. 완료되면 [Iru Endpoint](#iru-endpoint) 탭의 [인증 모드](#authentication-mode)에서 \*\*Additional scopes (optional)\*\*에 범위를 추가합니다.
Passport **웹 로그인**은 로그인 시 Passport 웹 보기에서 MFA와 같은 조건부 액세스 요청을 완료합니다.
#### Passport - CA Policy API 애플리케이션 생성
Passport가 기본 범위 이외의 범위를 요청할 수 있도록 이 애플리케이션 등록을 생성합니다.
[Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인하고 **Entra ID** > **App registrations**를 엽니다.
**+ New registration**을 선택합니다. 이름으로 **Passport - CA Policy API**를 입력하고, **지원되는 계정 유형**에서 **Single tenant only**를 선택한 다음, **Redirect URI**는 비워 둡니다. **등록**을 선택합니다.
**API permissions**를 엽니다. 관리자 동의가 아직 부여되지 않은 경우 \*\*Grant admin consent for \[your tenant]\*\*를 선택합니다.
왼쪽 탐색에서 **Expose an API**를 엽니다.
**+ Add a scope**를 선택합니다.
**Application ID URI**를 검토합니다. Entra ID는 기본값(예: `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a`)을 제안합니다. 기본값을 사용해도 됩니다. **저장 후 계속**을 선택합니다. 이 URI는 복사할 필요가 없으며, 아래 **범위 URI 복사**에서 범위 URI를 복사합니다.
**Scope name**에 공백이나 특수 문자 없이 `Passport`를 입력합니다. **Who can consent**는 기본값으로 둡니다. **Admin consent** 필드에 표시 이름과 설명을 입력한 다음 **Add scope**를 선택합니다.
**Scopes** 목록의 범위 URI(예: `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a/Passport`) 옆에서 **복사**를 선택합니다. [Iru Endpoint](#iru-endpoint) 탭의 [인증 모드](#authentication-mode)에서 **Add Additional scopes**에 사용할 수 있도록 저장해 둡니다.
#### Passport 앱 등록에 사용자 지정 범위 추가
아직 로그인하지 않았다면 [Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인하고 **Entra ID** > **App registrations**를 엽니다. Passport **웹 로그인**에 사용하는 애플리케이션을 엽니다.
**API permissions**를 열고 **+ Add a permission**을 선택합니다.
**APIs my organization uses** 탭을 열고 **Passport - CA Policy API**를 선택합니다.
**Delegated permissions**를 선택하고 **Passport** 권한을 선택한 다음 **Add permissions**를 선택합니다.
\*\*Grant admin consent for \[your tenant]\*\*를 선택합니다.
#### All resources 정책에서 Passport - CA Policy API 제외
암호 확인 및 동기화가 계속 작동하도록 **All resources**로 범위가 지정된 각 정책에서 **Passport - CA Policy API**를 제외하세요.
[Microsoft Entra 관리 센터](https://entra.microsoft.com)에서 **Protection** > **Conditional Access** > **Policies**를 엽니다.
**All resources**로 범위가 지정된 각 정책을 선택한 다음 **Target resources**를 엽니다.
**Exclude** 탭을 열고 **Select resources**를 선택한 다음 **Passport - CA Policy API**를 선택합니다. **선택**을 선택한 다음 **저장**을 선택합니다.
**All resources**로 범위가 지정된 모든 조건부 액세스 정책에 대해 이 단계를 반복합니다.
**저장**이 실패하면 **Passport - CA Policy API**가 공용 클라이언트 흐름을 허용하지 않는지 확인하세요. 앱에 리디렉션 URI가 구성되어 있으면 제거하고 다시 시도하세요.
### Passport를 사용한 사용자 계정 프로비저닝
Passport가 Entra ID 보안 그룹 멤버십을 기반으로 각 사용자의 Mac 계정 유형을 설정하도록 하려면 이 섹션의 단계에 따라 Microsoft Entra 관리 센터에서 각 그룹의 **Object ID**를 수집하세요. 이 값은 Passport Library Item [**Iru Endpoint** 탭](#iru-endpoint)의 **사용자 프로비저닝**에서 사용합니다. 이 모드에 대한 자세한 내용은 **Passport Library Item 구성**의 [사용자 프로비저닝](/ko/endpoint/library/passport/configure-the-passport-library-item#user-provisioning)을 참조하세요.
[Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인합니다. 왼쪽의 Identity 탐색 메뉴에서 **그룹**을 열고 **모든 그룹**을 선택합니다.
사용할 그룹을 선택합니다.
해당 그룹의 **Object ID**를 복사합니다.
사용할 각 추가 Entra ID 그룹에 대해 **그룹 선택** 및 **Object ID 복사**를 반복합니다. [**Iru Endpoint** 탭](#iru-endpoint)에 입력할 때까지 **Object ID** 값을 보안 문서에 보관하세요.
[**Iru Endpoint** 탭](#iru-endpoint)의 Passport Library Item에서 **인증 모드** 및 **사용자 프로비저닝**을 구성하세요.
아직 수행하지 않았다면 [Passport Library Item 구성](/ko/endpoint/library/passport/configure-the-passport-library-item)을 사용하여 Passport Library Item과 기본 설정을 추가하세요. 아래 단계는 Passport Library Item의 Microsoft Entra ID **웹 로그인** 필드입니다. [Microsoft Entra ID](#microsoft-entra-id) 탭에서 얻은 **Application (client) ID** 및 OpenID Connect 메타데이터 URL을 사용하세요.
### 인증 모드
사용자가 Passport 웹 보기에서 Microsoft Entra ID 로그인(MFA 포함)을 완료해야 하는 경우 **인증 모드**를 **웹 로그인**으로 설정합니다.
Passport Library Item에서 **ID 공급자**를 **Microsoft Entra ID**로 설정합니다.
**ID 공급자 URL** 필드에 [Microsoft Entra ID](#microsoft-entra-id) 탭의 앱 등록에서 얻은 **OpenID Connect metadata document** URL을 붙여넣습니다.
**Client ID (Password Sync)** 필드에 [Microsoft Entra ID](#microsoft-entra-id) 탭의 앱 등록에서 얻은 **Application (client) ID**를 붙여넣습니다.
[Microsoft Entra ID 조건부 액세스 고려 사항](#microsoft-entra-id-conditional-access-considerations)을 완료한 경우에만 이 단계를 완료하세요. 해당 섹션을 건너뛴 경우 **웹 로그인 선택**으로 진행하세요.
**Passport - CA Policy API 애플리케이션 생성**에서 복사한 범위 URI를 \*\*Additional scopes (optional)\*\*에 붙여넣습니다. 이 필드는 **Client ID (Password Sync)** 아래에 표시됩니다.
**인증 모드**에서 **웹 로그인**을 선택합니다.
**Redirect URI** 필드에 다음을 입력합니다. [Microsoft Entra ID](#microsoft-entra-id) 탭의 앱 등록에 있는 리디렉션 URI와 일치해야 합니다.
```
https://localhost
```
Passport Library Item에서 **저장**을 선택합니다.
### 사용자 프로비저닝
Passport가 Entra ID 보안 그룹 멤버십을 기반으로 각 사용자의 Mac 계정 유형을 설정하도록 하려면 Passport Library Item [**Iru Endpoint** 탭](#iru-endpoint)의 **사용자 프로비저닝**에서 아래 단계를 사용하세요. 먼저 Entra ID에서 각 그룹의 **Object ID**를 수집하세요. [Microsoft Entra ID](#microsoft-entra-id) 탭의 [Passport를 사용한 사용자 계정 프로비저닝](#user-account-provisioning-via-passport)을 참조하세요.
**사용자 프로비저닝** 섹션에서 **사용자 계정 유형**을 열고 **ID 공급자 그룹별로 지정**을 선택합니다.
**사용자 계정 유형**을 **ID 공급자 그룹별로 지정**으로 설정한 상태에서 그 아래의 계정 유형 드롭다운을 열고 Administrator 또는 Standard 사용자를 선택합니다. 사용자의 IdP 그룹 멤버십이 Administrator 및 Standard 계정 유형을 모두 반환하는 경우 사용자는 Administrator로 지정됩니다.
각 **ID 공급자 그룹** 필드에 그룹 표시 이름이 아니라 Entra ID 그룹 **Object ID**를 GUID 형식으로 입력합니다.
각 **ID 공급자 그룹** 행에 대해 **Account type**을 적절하게 설정합니다.
**저장**을 선택합니다.
Passport Library Item을 저장한 후 앱 등록, **Passport - CA Policy API** 제외 또는 그룹 **Object ID**를 변경해야 하는 경우 [Microsoft Entra ID](#microsoft-entra-id) 탭으로 돌아가세요.
## 2026년 6월 15일 이전 필수 변경 사항
**2026년 6월 15일**에 Microsoft Entra ID는 **All resources**(이전 **All cloud apps**)를 대상으로 하고 **리소스 제외**를 포함하는 정책에 대해 조건부 액세스를 더 광범위하게 적용하기 시작합니다. `openid`, `profile`, `email`, `User.Read`를 포함한 **기본 범위**만 요청하는 로그인도 해당 정책의 적용을 받게 됩니다.
Passport **웹 로그인**은 공용 클라이언트로서 이러한 범위를 요청합니다. 이미 Passport **웹 로그인**을 사용하고 있다면, **All resources**로 범위가 지정된 정책에서 조건부 액세스를 통해 MFA가 적용되지 않고 암호 확인 및 동기화가 작동하도록 하려는 경우(사용자가 웹 로그인 중 MFA를 완료하는 대신 Passport를 MFA에서 제외하는 경우)에만 아래 단계가 필요합니다. 사용자가 Entra ID 웹 보기에서 MFA를 완료하는 경우 일반적으로 사용자 지정 범위, [All resources 정책에서 Passport - CA Policy API 제외](#exclude-passport-ca-policy-api) 또는 **Additional scopes** Library Item 업데이트가 필요하지 않습니다. 다만 테넌트에는 [조건부 액세스 정책을 사용하지 않는 경우](#if-you-do-not-use-conditional-access-policies)의 절차가 여전히 필요할 수 있습니다. 필수 업데이트를 건너뛰면 변경 사항이 테넌트에 적용된 후 로그인 및 암호 동기화가 중단될 수 있습니다.
이 문서를 사용하여 Passport **웹 로그인**을 처음 구성하는 경우 위의 **Microsoft Entra ID** 및 **Iru Endpoint** 탭에 해당되는 경우 이미 이러한 업데이트가 포함되어 있습니다.
자세한 내용은 [조건부 액세스의 기본 범위 적용](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions)을 참조하세요.
### 이러한 업데이트를 건너뛰는 경우
**2026년 6월 15일** 이전에 준비하지 않으면:
* 새 사용자가 Passport로 로그인하지 못할 수 있습니다.
* 기존 사용자는 재시동 또는 로그아웃 후 로컬 로그인으로 전환해야 할 수 있습니다.
* 암호 동기화 및 상태 관리가 작동하지 않을 수 있습니다.
* Microsoft Entra ID에 추가 로그인 실패 이벤트가 기록될 수 있습니다.
### 조건부 액세스 정책을 사용하지 않는 경우
조건부 액세스를 사용하지 않거나 테스트하는 동안 테넌트 전체에서 이전 동작을 유지하려는 경우:
기본 범위에 대한 사용자 지정 대상 리소스 역할을 할 단일 테넌트 애플리케이션을 Microsoft Entra ID에 등록합니다. 등록 중에 추가 구성은 필요하지 않습니다. [동작 사용자 지정](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions#customize-behavior)의 **Create an application**을 참조하세요.
이전 동작을 유지해야 하는 각 조건부 액세스 정책에서 **Target resources**에서 자리 표시자 애플리케이션을 제외합니다. [Microsoft 문서](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions#customize-behavior)의 **Exclude the application from the relevant policy**를 참조하세요.
[Baseline scopes settings](https://aka.ms/BaselineScopesSettingsUX)를 열고 **Customize behavior**를 선택한 다음 자리 표시자 애플리케이션을 선택하고 **저장**을 선택합니다. [Microsoft 문서](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions#customize-behavior)의 **Select the application in the Baseline scopes settings UX**를 참조하세요.
Iru Endpoint에서 Passport Library Item을 변경할 필요가 없습니다.
이 Entra ID 설정은 Passport뿐만 아니라 기본 범위를 요청하는 모든 애플리케이션에 영향을 줍니다.
### 조건부 액세스 정책을 사용하는 경우
Passport **웹 로그인**과 함께 조건부 액세스를 사용하고 위에 설명된 대로 Passport를 MFA에서 제외하려는 경우 **2026년 6월 15일** 이전에 아래 단계를 완료하세요.
#### Passport - CA Policy API 애플리케이션 생성
[Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인하고 **Entra ID** > **App registrations**를 엽니다.
**+ New registration**을 선택합니다. 이름으로 **Passport - CA Policy API**를 입력하고, **지원되는 계정 유형**에서 **Single tenant only**를 선택한 다음, **Redirect URI**는 비워 둡니다. **등록**을 선택합니다.
**API permissions**를 엽니다. 관리자 동의가 아직 부여되지 않은 경우 \*\*Grant admin consent for \[your tenant]\*\*를 선택합니다.
왼쪽 탐색에서 **Expose an API**를 엽니다.
**+ Add a scope**를 선택합니다.
**Application ID URI**를 검토합니다. Entra ID는 기본값(예: `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a`)을 제안합니다. 기본값을 사용해도 됩니다. **저장 후 계속**을 선택합니다. 이 URI는 복사할 필요가 없으며, 아래 **범위 URI 복사**에서 범위 URI를 복사합니다.
**Scope name**에 공백이나 특수 문자 없이 `Passport`를 입력합니다. **Who can consent**는 기본값으로 둡니다. **Admin consent** 필드에 표시 이름과 설명을 입력한 다음 **Add scope**를 선택합니다.
**Scopes** 목록의 범위 URI(예: `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a/Passport`) 옆에서 **복사**를 선택합니다. [Passport Library Item 업데이트](#update-passport-library-item)에 사용할 수 있도록 저장해 둡니다.
#### Passport 앱 등록에 사용자 지정 범위 추가
아직 로그인하지 않았다면 [Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인하고 **Entra ID** > **App registrations**를 엽니다. Passport **웹 로그인**에 사용하는 애플리케이션을 엽니다.
**API permissions**를 열고 **+ Add a permission**을 선택합니다.
**APIs my organization uses** 탭을 열고 **Passport - CA Policy API**를 선택합니다.
**Delegated permissions**를 선택하고 **Passport** 권한을 선택한 다음 **Add permissions**를 선택합니다.
\*\*Grant admin consent for \[your tenant]\*\*를 선택합니다.
#### All resources 정책에서 Passport - CA Policy API 제외
**웹 로그인**을 사용하고 조건부 액세스를 통해 Passport를 MFA에서 제외하려는 경우에만 이 단계를 완료하세요. 사용자가 로그인 시 Entra ID 웹 보기에서 MFA를 완료하는 경우 건너뛰세요.
**All resources**로 범위가 지정된 정책에는 Passport가 로그인 시 요청하는 기본 범위를 사용하는 로그인이 포함됩니다. 해당 정책에서 MFA 요구 사항 없이 암호 확인 및 동기화가 계속 작동하도록 **Passport - CA Policy API**를 제외하세요.
[Microsoft Entra 관리 센터](https://entra.microsoft.com)에서 **Protection** > **Conditional Access** > **Policies**를 엽니다.
**All resources**로 범위가 지정된 각 정책을 선택한 다음 **Target resources**를 엽니다.
**Exclude** 탭을 열고 **Select resources**를 선택한 다음 **Passport - CA Policy API**를 선택합니다. **선택**을 선택한 다음 **저장**을 선택합니다.
**All resources**로 범위가 지정된 모든 조건부 액세스 정책에 대해 이 단계를 반복합니다.
**저장**이 실패하면 **Passport - CA Policy API**가 공용 클라이언트 흐름을 허용하지 않는지 확인하세요. 앱에 리디렉션 URI가 구성되어 있으면 제거하고 다시 시도하세요.
#### Passport Library Item 업데이트
위에 설명된 대로 **웹 로그인**을 MFA에서 제외하기 때문에 **조건부 액세스 정책을 사용하는 경우**를 따르는 경우 이 단계를 완료하세요.
Iru Endpoint에서 **Library**를 열고 Microsoft Entra ID **웹 로그인**용으로 구성된 Passport Library Item을 편집합니다.
[**Iru Endpoint** 탭](#iru-endpoint)에서 [Passport - CA Policy API 애플리케이션 생성](#create-passport-ca-policy-api-app)에서 얻은 범위 URI를 \*\*Additional scopes (optional)\*\*에 붙여넣은 다음 **저장**을 선택합니다.
Microsoft Entra ID **웹 로그인**용으로 구성된 모든 Passport Library Item에 대해 **범위 URI 추가**를 반복합니다.
이러한 업데이트를 완료한 후 등록된 Mac에서 Passport 로그인을 테스트하세요. 로그인에 실패하면 [Microsoft Entra ID(이전 Azure AD)를 사용한 Passport 문제 해결](/ko/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad)을 참조하세요.
## Microsoft Entra ID 문제 해결
Entra ID로 Passport 로그인에 실패하면 [Microsoft Entra ID(이전 Azure AD)를 사용한 Passport 문제 해결](/ko/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad)을 참조하세요.