> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/ko/security/identity-providers/microsoft-entra-id.md). # Microsoft Entra ID 사용 사례에 따라, [Verkada Command](/command/ko/getting-started/get-started-with-verkada-command.md) 는 아래의 여러 역할에서 Microsoft Entra ID 및 기타 ID 공급자 \[IdP]와 통합할 수 있습니다: * OpenID Connect(OIDC) * Security Assertion Markup Language(SAML) * System for Cross-Domain Identity Management(SCIM) **OIDC** 및 **SAML** 둘 다 인증을 처리하여 Microsoft Entra ID가 환경의 다른 SaaS 애플리케이션에 대한 액세스를 관리하는 방식과 동일하게 Command에 대한 액세스를 관리할 수 있게 합니다. 두 프로토콜 모두 기존 ID 프레임워크에 Command를 통합하고 현재 정책에 따라 사용자를 승인할 수 있게 해줍니다. **SCIM** 를 사용하면 Microsoft Entra ID의 기존 사용자와 그룹을 활용하여 Command와 동기화할 수 있습니다. 이를 통해 현재의 중앙 IdP를 유지하고 기존 사용자와 그룹을 사용해 Command에서 권한을 구성할 수 있습니다. {% hint style="info" %} Verkada는 보안 강화와 더 쉬운 구성을 위해 SAML보다 OIDC를 권장합니다. OIDC는 또한 [엔터프라이즈 제어 암호화](/command/ko/security/enterprise-controlled-encryption.md). {% endhint %} | 기능 | 지원됨 | | -------------- | :-: | | OIDC SSO | 예 | | SAML SSO | 예 | | SCIM 사용자 프로비저닝 | 예 | | ECE 지원 | 예 | *** {% tabs %} {% tab title="OIDC(권장)" %} #### Microsoft Entra ID용 OIDC 기반 SSO Verkada Command는 Microsoft Entra ID와 OpenID Connect(OIDC)를 통해 단일 로그인(SSO)을 지원합니다. 이 통합을 통해 사용자는 기존 Microsoft Entra ID 자격 증명을 사용하여 원활하고 안전하게 인증할 수 있으며, Command에 대한 액세스를 간소화하고 전반적인 보안을 강화할 수 있습니다. {% hint style="info" %} 사용 [Enterprise Controlled Encryption(ECE)](/command/ko/security/enterprise-controlled-encryption.md) 을 사용하면 보안이 강화됩니다. {% endhint %} *** **Microsoft Entra ID 구성** {% stepper %} {% step %} **다음에 로그인하세요:** [**Microsoft Entra ID 포털**](https://portal.azure.com)**.** {% endstep %} {% step %} **앱 등록을 검색하여 선택합니다.** {% endstep %} {% step %} **새 등록을 클릭합니다.** a. 애플리케이션 이름을 **Verkada SSO OIDC로 지정합니다.**\ b. 아래에서 **지원되는 계정 유형,** 을 선택합니다. **이 조직 디렉터리의 계정만(단일 테넌트 전용).**\ c. 아래에서 **리디렉션 URI**를 선택하고 **단일 페이지 애플리케이션** (SPA)을 플랫폼으로 선택한 다음 다음 콜백 URL을 추가합니다: 1. 2. [https://org-short-name.command.verkada.com/oidc/aad/callback](http://org-short-name.command.verkada.com/oidc/aad/callback) (URI의 org-short-name을 Command 조직의 짧은 이름으로 바꾸세요.) {% hint style="warning" %} 콜백 URI 끝에 슬래시가 없는지 확인합니다. {% endhint %} {% endstep %} {% step %} **등록을 클릭합니다.** {% endstep %} {% step %} **Application(Client) ID와 Directory(Tenant) ID를 안전한 곳에 복사해 저장하세요. Verkada Command에서 설정을 완료하는 데 필요합니다.** {% endstep %} {% step %} **왼쪽에서 관리 > API 노출을 클릭합니다.** a. 다음을 클릭합니다 **스코프를 추가합니다.**\ b. **저장하고 계속하기**.\ c. 다음을 입력합니다. *verkada\_ece* 를 다음 필드에 입력합니다: * 스코프 이름 * 관리자 동의 표시 이름 * 관리자 동의 설명 * 사용자 동의 표시 이름 * 사용자 동의 설명 d. 다음을 설정합니다. **동의할 수 있는 대상?** 을 **관리자 및 사용자로.**\ e. **스코프를 추가합니다.**
{% endstep %} {% endstepper %} *** **Verkada Command 구성** {% stepper %} {% step %} **Verkada Command에서 All Products > Admin으로 이동합니다.** {% endstep %} {% step %} **왼쪽 탐색에서 로그인 및 액세스를 선택합니다.** {% endstep %} {% step %} **단일 로그인 구성 을 선택합니다.** {% endstep %} {% step %} **OIDC 구성 아래에서 새로 추가를 클릭합니다.** a. 다음을 켭니다. **사용.**\ b. (선택 사항) 다음을 켭니다. **OIDC SSO 필요.**\ c. 아래에서 **공급자 선택,** 을 선택합니다. **Microsoft Entra ID.**\ d. 아래에서 **클라이언트 및 테넌트 추가,** 에서 :plus:를 클릭합니다. 1. 다음 **클라이언트 ID** 필드에 Microsoft Entra ID에서 복사한 클라이언트 ID를 붙여넣습니다. 2. 다음 **테넌트 ID** 필드에 Microsoft Entra ID에서 복사한 테넌트 ID를 붙여넣습니다. 3. 클릭 **완료**. e. 아래에서 **이메일 도메인,** 에서 :plus:를 클릭합니다.**.** 1. 사용 중인 도메인 이름을 입력합니다(예: @verkada.com). 2. 클릭 **완료**.
{% endstep %} {% step %} **로그인 테스트 실행을 클릭합니다.** {% endstep %} {% step %} **로그인 테스트가 성공하면 OIDC 구성 페이지로 리디렉션됩니다. 로그인한 후에는 허용 목록에 추가해야 하는 도메인을 추가하세요.** {% endstep %} {% step %} **도메인을 추가한 후 로그인 테스트를 다시 실행합니다. 이 두 번째 로그인 테스트가 성공적으로 완료될 때까지 SSO는 활성화되지 않습니다.** {% endstep %} {% step %} **도메인이 확인되면 성공적으로 검증되었음을 확인할 수 있습니다.** {% endstep %} {% endstepper %} *** #### 모바일 애플리케이션을 통해 로그인 {% hint style="info" %} Android 및 iOS Command 앱은 OIDC 기반 로그인을 지원합니다. {% endhint %} {% stepper %} {% step %} **Command 앱을 엽니다.** {% endstep %} {% step %} **이메일 주소 필드에 이메일을 입력하고 다음을 클릭합니다.** {% endstep %} {% step %} **로그인 과정을 완료하기 위해 IdP(Microsoft Entra ID)로 리디렉션됩니다.** {% endstep %} {% endstepper %} {% endtab %} {% tab title="SAML" %} ### Microsoft Entra ID SAML 통합 *** #### Microsoft Entra ID에서 SAML 설정 Verkada Command는 갤러리 애플리케이션으로 등록되어 있으며 Microsoft Entra ID 마켓플레이스에서 찾을 수 있습니다. 즉, Microsoft Entra ID Free, Microsoft Entra ID P1, Microsoft Entra ID P2 라이선스와 함께 활용할 수 있습니다. {% hint style="danger" %} 시작하려면 다음이 필요합니다. `클라이언트 ID`. 방법을 알아보려면 [생성하고 이메일 도메인을 구성한 다음](/command/ko/security/identity-providers.md#generate-client-id)이 문서로 돌아와 이 과정의 나머지를 완료하세요. {% endhint %} {% stepper %} {% step %} **Microsoft Entra ID 디렉터리에 Verkada Command를 엔터프라이즈 애플리케이션으로 추가합니다: Microsoft Entra ID 개요 페이지로 이동하여 엔터프라이즈 애플리케이션을 선택합니다.**
{% endstep %} {% step %} **페이지 상단에서 새 애플리케이션을 선택하고 Verkada Command를 검색합니다.** {% endstep %} {% step %} **Verkada Command를 선택하고 만들기를 클릭합니다. *****애플리케이션을 추가하는 데 몇 분이 걸릴 수 있으니 기다려 주세요.***** Microsoft Entra ID *****테넌트*****.**
페이지가 새로 고쳐지면 아래와 유사한 메뉴가 표시됩니다. {% endstep %} {% step %} **단일 로그인 설정에서 시작하기를 클릭합니다.**
{% endstep %} {% step %} **단일 로그인 방법으로 SAML을 선택합니다.**
{% endstep %} {% step %} **필요한 경우 편집을 클릭하여 SAML 연결을 추가로 구성합니다.** {% endstep %} {% step %} **다음 필드를 구성합니다. Microsoft Entra ID에 추가하기 전에 각 URL 끝에 클라이언트 ID를 추가해야 합니다. 참고 아래의 예를 참조하세요.** a. **식별자**:\ 미국 조직의 경우: \ EU 조직의 경우: AUS 조직의 경우: b. **회신 URL**:\ 미국 조직의 경우: \ EU 조직의 경우: \ AUS 조직의 경우: c. **로그인 URL**:\ 미국 조직의 경우: \ EU 조직의 경우: [https://saml.prod2.verkada.com/saml/login](https://saml.prod2.verkada.com/saml/login/)\ AUS 조직의 경우: {% hint style="warning" %} 어느 지역에 해당하는지 확인하려면 다음을 참조하세요. [귀하의 조직이 Verkada용으로 생성된 위치를 참조하세요](/command/ko/getting-started/get-started-with-verkada-command.md). {% endhint %}
{% endstep %} {% step %} **저장을 클릭합니다.** {% endstep %} {% step %} **특성 및 클레임에서 편집을 클릭하여 다음 특성과 일치시키세요:**
{% hint style="warning" %} 이메일에 다른 소스 특성을 사용하는 경우, 사용하려는 소스 특성에 따라 특성을 구성하세요. {% endhint %} {% endstep %} {% step %} **SAML 서명 인증서에서 이 Federation Metadata XML을 Command로 가져옵니다.** {% endstep %} {% step %} **나중에 사용할 수 있도록 다운로드를 클릭하여 저장합니다.**
{% hint style="info" %} 나타나는 다음 대화상자에는 통합이 완료된 후 사용할 수 있는 도구가 포함됩니다. {% endhint %} {% endstep %} {% step %} **계속해서 Verkada Command에서** [**구성을 완료합니다**](/command/ko/security/identity-providers.md#command-sso-configuration)**.** {% endstep %} {% endstepper %} *** #### Microsoft Entra ID에서 SAML 연결 테스트 {% stepper %} {% step %} **파일이 업로드되면 Microsoft Entra ID에서 테스트를 클릭하여 통합을 테스트합니다. Command 계정이 있는 모든 사용자(조직 초대)에 알림이 전송됩니다.**
{% endstep %} {% step %} **현재 사용자로 로그인(Sign in as current user)으로 로그인합니다. 모든 설정이 올바르면 Command 플랫폼으로 리디렉션되어야 합니다.** {% endstep %} {% step %} **Command에 대한 액세스를 확인하려면 단일 로그인으로 로그인합니다.** {% endstep %} {% endstepper %} {% hint style="warning" %} Microsoft Entra ID는 현재 앱 액세스에 대해 중첩 그룹을 지원하지 않습니다. 할당하려면 모든 사용자가 그룹의 직접 구성원이어야 합니다. {% endhint %} *** #### 모바일 애플리케이션을 통해 로그인 {% hint style="info" %} Android 및 iOS Command 앱은 SAML 기반 로그인을 지원합니다. {% endhint %} {% stepper %} {% step %} **Command 앱을 엽니다.** {% endstep %} {% step %} **이메일 주소 필드에 이메일을 입력하고 다음을 클릭합니다.** {% endstep %} {% step %} **로그인 과정을 완료하기 위해 IdP(Microsoft Entra ID)로 리디렉션됩니다.** {% endstep %} {% endstepper %} {% endtab %} {% tab title="사용자 프로비저닝(SCIM)" %} #### Microsoft Entra ID SCIM 통합 Verkada Command는 자동 사용자 및 그룹 프로비저닝을 위해 System for Cross-Domain Identity Management(SCIM)를 사용하여 Microsoft Entra ID와 통합됩니다. SCIM은 Microsoft Entra ID의 사용자와 그룹을 Command로 직접 동기화합니다. 이를 통해 다음이 가능합니다: * Microsoft Entra ID를 중앙 IdP로 유지합니다. * Entra ID에서 변경이 발생할 때 Command의 사용자와 그룹을 자동으로 업데이트합니다. * 기존 ID 구조를 사용하여 Command에서 권한을 할당하고 관리합니다. {% hint style="info" %} 조직에서 SCIM을 사용하는 경우, 전화번호는 SCIM을 통해서만 프로비저닝할 수 있습니다. Command에서 전화번호를 직접 편집할 수는 없습니다. {% endhint %} *** **Microsoft Entra ID 구성의 SCIM** Microsoft Entra ID에서 SCIM을 구성하기 전에 Command에서 비밀 토큰을 생성해야 합니다. {% stepper %} {% step %} **Verkada Command에서 All Products > Admin으로 이동합니다.** {% endstep %} {% step %} **조직 설정에서 로그인 및 액세스 및 로그 > SCIM 사용자 프로비저닝을 선택합니다.** {% endstep %} {% step %} **도메인 추가를 클릭하고 SCIM과 함께 사용할 모든 관련 이메일 도메인을 입력합니다.** 이렇게 하면 SCIM 토큰이 생성되며, **한 번만 볼 수 있습니다.** a. 다음을 클릭합니다 **복사** 하여 나중에 구성에 사용할 수 있도록 안전한 곳에 저장합니다.\ b. [**새로 고침**](/command/ko/security/identity-providers/scim-token-management.md) 토큰을 복사하지 않았거나 표시되지 않는 경우 새 토큰을 생성합니다. {% endstep %} {% step %} **Microsoft Entra ID 홈 페이지에서 엔터프라이즈 애플리케이션 > 새 애플리케이션 > 내 애플리케이션 만들기를 선택합니다.** {% endstep %} {% step %} **내 애플리케이션 만들기 사이드 패널에서 애플리케이션 이름을 입력하고, "갤러리에서 찾을 수 없는 다른 애플리케이션 통합(비갤러리)"을 선택한 다음 만들기를 클릭합니다.** {% hint style="warning" %} Verkada Command 애플리케이션을 선택하지 마세요. 이는 사전 구성된 SAML 전용 애플리케이션입니다. {% endhint %}
{% endstep %} {% step %} **사용자 계정 프로비저닝 아래에서 시작하기를 클릭합니다.**
{% endstep %} {% step %} **관리 > 프로비저닝을 선택합니다.** {% endstep %} {% step %} **프로비저닝 페이지에서:** a. 프로비저닝 모드를 자동으로 설정합니다.\ b. 테넌트 URL을 다음으로 설정합니다: * 미국 조직의 경우: * EU 조직의 경우: * AUS 조직의 경우: {% hint style="warning" %} 어느 지역에 있는지 확인하려면 [Verkada용 조직이 생성된 위치를 참조하세요](/command/ko/getting-started/get-started-with-verkada-command.md). {% endhint %} f. SCIM *토큰을 입력합니다.* Verkada Command(2단계)에서 생성된 토큰을 비밀 토큰으로 사용합니다.
{% endstep %} {% step %} **연결 테스트를 클릭합니다. SCIM 연결이 성공했다는 확인 메시지가 표시되어야 합니다.**
{% endstep %} {% step %} **저장을 클릭합니다.** {% endstep %} {% endstepper %} *** **Microsoft Entra ID 그룹에 대한 특성 구성** {% stepper %} {% step %} **Entra ID 포털에서 매핑 드롭다운을 확장하고 Microsoft Entra ID 그룹 프로비저닝을 선택합니다.**
{% endstep %} {% step %} **데이터 테이블 스크린샷과 일치하도록 매핑을 구성합니다:**
{% hint style="warning" %} 해당 **externalId** 특성은 기본적으로 추가됩니다. 구성 문제를 방지하려면 이 특성을 제거하세요. {% endhint %} {% endstep %} {% step %} **(선택 사항) 매핑을 추가해야 하는 경우:** a. 다음을 클릭합니다 **새 매핑 추가** > 다음을 선택합니다. **원본 특성** 를 위의 Microsoft Entra ID 특성과 일치시키세요.\ b. **대상 특성** 를 다음과 일치시키세요. **customappsso** 위의 특성.\ c. **확인**. {% endstep %} {% step %} **필요한 경우 저장을 클릭하고 변경 사항을 확인합니다.** {% endstep %} {% step %} **페이지 상단에서 프로비저닝을 선택하여 프로비저닝 페이지로 돌아갑니다.** {% endstep %} {% endstepper %} *** **Microsoft Entra ID 사용자에 대한 특성 구성** {% stepper %} {% step %} **Entra ID 포털에서 매핑 드롭다운을 확장한 다음 Microsoft Entra ID 사용자 프로비저닝을 선택하여 사용자 매핑을 변경합니다.** {% endstep %} {% step %} **아래 특성 표와 일치하도록 매핑을 업데이트합니다.** | customappsso 특성 | Microsoft Entra ID 특성 | | --------------------------------------------------------------------------- | ------------------------------------------------------------ | | `userName` | mail | | `active` | Switch(\[IsSoftDeleted], , "False", "True", "True", "False") | | `title` | jobTitle | | `name.givenName` | givenName | | `name.familyName` | surname | | `phoneNumbers[type eq "work"].value` | telephoneNumber | | `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber` | employeeId | | `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization` | companyName | | `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | department | | `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter` | costCenter | {% hint style="warning" %} 해당 **Switch** Microsoft Entra ID 특성 아래의 특성이 **식** 매핑 유형으로 추가됩니다. {% endhint %} {% hint style="warning" %} Source Attribute는 Microsoft Entra ID 특성이며 Target Attribute는 customappsso 특성입니다. 다음 중 일부 **customappsso** 특성이 대상 특성으로 제공되지 않는 경우, Microsoft Entra ID 플랫폼에 옵션으로 추가해야 할 수 있습니다. 그렇게 하려면 **고급 옵션 표시** 확인란을 선택하고 **customappsso의 특성 목록 편집을 클릭합니다.**. {% endhint %} {% endstep %} {% step %} **변경 사항을 확인하려면 저장을 클릭합니다.** {% endstep %} {% step %} **상단에서 프로비저닝을 선택하고 프로비저닝 상태를 켭니다.**
{% endstep %} {% step %} **요구 사항에 따라 범위를 다음 필수 옵션 중 하나로 조정합니다:** * 모든 사용자와 그룹을 동기화합니다. * 할당된 사용자와 그룹만 동기화합니다. {% hint style="warning" %} 사용자 및 그룹에서 사용자와 그룹이 엔터프라이즈 애플리케이션에 할당되었는지 확인합니다. 할당된 항목이 프로비저닝되어 Command에 표시됩니다. {% endhint %} {% endstep %} {% step %} **사용자가 애플리케이션에 할당되었는지 확인합니다. 초기 프로비저닝 주기가 경과한 후:** a. 아래에서 성공적으로 프로비저닝된 총 사용자 및 그룹 수를 확인할 수 있어야 합니다. **개요**.\ b. Command에서는 다음 사용자와 그룹이 관련 **SCIM 관리됨** 태그와 함께 채워진 것을 볼 수 있어야 합니다. 이제 이 동기화된 사용자와 그룹을 Command에서 사용할 수 있으며 Command 플랫폼에 대한 액세스를 제어하기 위해 권한을 할당할 수 있습니다.
{% endstep %} {% endstepper %} **Command에서 SCIM 관리 사용자 삭제** SCIM 관리 사용자가 ID 공급자에서 비활성화되면 다음 두 가지 방법으로 Command에서 해당 사용자를 제거할 수 있습니다: * **사용자 삭제** – 계정은 삭제된 사용자 페이지로 이동하지만 기록, 역할, 권한은 유지됩니다. * **사용자를 영구적으로 제거** – 모든 역할, 자격 증명, 액세스 로그 및 관련 데이터가 삭제됩니다. 사용자가 SCIM을 통해 다시 프로비저닝되면 Command는 새 사용자 레코드를 생성합니다. {% hint style="warning" %} Command에서 삭제 옵션을 사용할 수 있으려면 먼저 ID 공급자(IdP)에서 사용자를 비활성화해야 합니다. {% endhint %} *** **(선택 사항) SCIM 사용자에 액세스 자격 증명 추가** {% stepper %} {% step %} **다음에 로그인하세요:** [**Azure 포털**](https://portal.azure.com)**.** {% endstep %} {% step %} **검색창에 Enterprise Applications를 입력하여 선택합니다.** {% endstep %} {% step %} **Verkada SCIM 애플리케이션을 선택합니다.** {% endstep %} {% step %} **왼쪽 패널에서 관리 > 프로비저닝을 클릭합니다.** {% endstep %} {% step %} **매핑 하위 메뉴를 확장하고 Microsoft Entra ID 사용자 프로비저닝을 선택합니다.** {% endstep %} {% step %} **하단에서 고급 옵션 표시 > customappsso의 특성 목록 편집을 클릭합니다.** a. 아래 표의 특성을 추가합니다.\ b. **저장**. {% endstep %} {% step %} **Microsoft Entra ID 사용자 프로비저닝으로 돌아가 새 매핑 추가를 선택합니다.** a. extensionAttributes 1-5를 **원본 특성으로 사용하고** 새로 생성된 특성에 매핑합니다. **카드 형식, 카드 번호, 카드 번호 16진수, 자격 증명 상태,** 및 **시설 코드** 를 대상 특성으로 사용합니다. 1. 참조 [허용되는 카드 형식](/access-control/ko/installation/badge-reader-support/supported-card-formats.md) 허용되는 카드 형식과 해당 시설 코드, 카드 번호 및/또는 카드 번호 16진수 길이에 대한 내용을 참조하세요. 2. **자격 증명 상태** 는 "활성", "비활성화됨" 또는 "삭제됨"일 수 있습니다. 3. 클릭 **저장**. b. 부서 식별자를 동기화하려면 원하는 원본 특성(예: department 또는 사용자 지정 확장 특성)으로 새 매핑을 추가하고 대상 특성을 costCenter(`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter`)로 설정합니다. 이렇게 하면 부서 ID 값이 Command로 동기화됩니다. {% endstep %} {% endstepper %} **특성 표** | 이름 | 유형 | | --------------------------------------------------------------------------------- | --- | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardFormat` | 문자열 | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumber` | 문자열 | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumberHex` | 문자열 | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:credentialStatus` | 문자열 | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:facilityCode` | 문자열 | | `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter` | 문자열 | **앱 등록 편집** Entra AD에서 생성된 SCIM 활성화 엔터프라이즈 애플리케이션은 일반적으로 각각 별도의 앱 등록이 필요합니다. {% stepper %} {% step %} **검색창에 App registrations를 입력하여 선택합니다.** {% endstep %} {% step %} **All Applications 탭으로 전환하고 Verkada SCIM 애플리케이션 이름을 검색합니다.** {% endstep %} {% step %} **개요에서 앱 등록의 Application(client) ID와 Directory(tenant) ID를 확인해 둡니다. 나중에 앱 등록에서 Command 애플리케이션의 자격 증명을 구성할 때 필요합니다.** {% endstep %} {% step %} **왼쪽 탐색에서 관리를 클릭합니다.** a. 아래에서 **인증서 및 비밀:** 1. 클릭 **새 클라이언트 비밀**. 2. 다음을 **설명** "*Verkada SCIM Credentials"* 로 설정하고 원하는 인증서 만료 날짜를 설정합니다. 3. 새로 생성된 클라이언트 비밀의 **값** 에 표시된 값을 복사하여 저장합니다. **이 값은 한 번만 표시됩니다.** e. 아래에서 **API 권한**: 1. 클릭 **권한 추가 > Microsoft Graph.** 2. 선택 **애플리케이션 권한** 을 선택하고 "*User.ReadWrite.All*". 1. 권한을 할당하려면 확인란을 선택합니다. 2. 클릭 **권한 추가**.
3. Microsoft Entra ID와 Command 애플리케이션 사이에 전달되는 모든 단계 변경 사항을 수동으로 검토하고 승인해야 하는 상황을 피하려면 다음을 선택합니다. **기본 디렉터리에 대한 관리자 동의 부여**.
{% endstep %} {% endstepper %} {% hint style="warning" %} 다음 자격 증명 목록을 참조하세요: [허용되는 카드 형식](/access-control/ko/installation/badge-reader-support/supported-card-formats.md). {% endhint %} **자격 증명에 액세스하고 업데이트** 특정 사용자에 대한 확장 특성과 자격 증명 정보를 설정하려면 다음 Graph API 안내를 사용하세요: . {% hint style="warning" %} 다음을 설정하는 것은 **credentialStatus** 속성을 **active** 사용자를 위한 자격 증명을 설정할 때 자격 증명 상태(credentialStatus)를 설정하는 것은 Command와 자격 증명을 성공적으로 동기화하는 데 필요합니다. 여기서 자격 증명 상태(credentialStatus)는 extensionAttribute4입니다. {% endhint %} 예: ``` curl --location --request PATCH 'https://graph.microsoft.com/v1.0/users/' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "onPremisesExtensionAttributes": { "extensionAttribute1": "Standard 26-bit Wiegand", "extensionAttribute2": "7777", "extensionAttribute3": "7", "extensionAttribute4": "active", "extensionAttribute5": "111" } }' ``` *** **External ID를 Verkada에 동기화** 해당 `externalId` 이 필드를 사용하면 Microsoft Entra를 통해 사용자에게 지속적이고 전역적으로 고유한 식별자를 할당할 수 있으며, Verkada는 이를 통합 전반에서 참조할 수 있습니다. 이는 사용자를 여러 시스템에서 구분해야 하는 대규모 엔터프라이즈 환경이나, 자격 증명(예: 액세스 카드) 동기화가 고유한 ID 키에 연결되어야 하는 경우 특히 유용합니다. Verkada는 SCIM 사용자 스키마의 일부로 이 값을 수신하고 저장하는 것을 지원합니다. 이 필드는 대소문자를 구분하며, 일반적으로 Microsoft Entra 인스턴스의 지정된 특성에서 문자열 값을 수락하도록 구성됩니다. 이 기능은 사용자 지정 자격 증명 관리, 직원 수명 주기 자동화, 그리고 조직 간 일관된 사용자 매핑과 같은 고급 워크플로를 지원합니다. **Azure의 externalId를 Verkada에 매핑** Microsoft Entra ID(Azure)에서 Verkada로 사용자 지정 externalId 값을 동기화하려면 다음 단계를 따르세요: {% stepper %} {% step %} 다음에 로그인하세요: **Azure 포털.** {% endstep %} {% step %} 검색창에 입력하고 선택하세요 **엔터프라이즈 애플리케이션.** {% endstep %} {% step %} 다음을 선택하세요 **Verkada SCIM 애플리케이션.** {% endstep %} {% step %} 왼쪽 패널에서 클릭하세요 **관리 > 프로비저닝.** {% endstep %} {% step %} 다음을 확장하세요 **매핑** 하위 메뉴를 선택한 다음 **Microsoft Entra ID 사용자 프로비저닝.** {% endstep %} {% step %} 아래로 스크롤한 다음 클릭하세요 **고급 옵션 표시 > customappsso의 특성 목록 편집.** {% endstep %} {% step %} **다음 새 특성을 추가하세요:** `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId` * 유형: 문자열 * 대소문자 구분: 예 {% endstep %} {% step %} **저장을 클릭합니다.** {% endstep %} {% step %} 다시 다음으로 돌아가세요 **Microsoft Entra ID 사용자 프로비저닝** 그런 다음 클릭하세요 **새 매핑 추가.** {% endstep %} {% step %} 다음에 대해 **원본 특성**, 외부 ID가 저장된 Azure AD의 필드를 선택하세요(예: `extensionAttribute1`, `employeeId`, 등). {% endstep %} {% step %} 다음에 대해 **대상 특성**, 다음을 사용하세요: `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId` {% endstep %} {% step %} **확인을 클릭한 다음 저장하세요.** {% endstep %} {% endstepper %} 프로비저닝이 완료되면 external\_id 값은 Verkada 내 사용자 SCIM 레코드에 저장됩니다. 이를 통해 사용자는 조직 내에서 고유하며 완전히 사용자가 제어하는, Verkada의 내부 식별자에 연결되지 않고 사용자 인터페이스에 노출되지 않는 유연한 API 조회 가능 ID를 사용할 수 있습니다. ![](/files/a5f5d8cf9f81035dd3592439a580ca0a90ed7b1c) {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.verkada.com/command/ko/security/identity-providers/microsoft-entra-id.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.