> 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 Microsoft Entra ID(Azure AD)로 SSO 및 사용자 프로비저닝을 구성하세요 사용 사례에 따라, [Verkada Command](/command/ko/getting-started/get-started-with-verkada-command.md) Verkada Command는 다음과 같은 방식으로 Microsoft Entra ID 및 기타 ID 공급자 \[IdP]와 통합할 수 있습니다: * OpenID Connect(OIDC) * 보안 어설션 마크업 언어(SAML) * 크로스 도메인 ID 관리 시스템(SCIM) **OIDC** 및 **SAML** 둘 다 인증을 처리하므로 Microsoft Entra ID가 환경의 다른 SaaS 애플리케이션에 대한 액세스를 관리하는 것과 동일한 방식으로 Command에 대한 액세스를 관리할 수 있습니다. 두 프로토콜을 사용하면 Command를 기존 ID 프레임워크에 통합하고 현재 정책에 따라 사용자를 승인할 수 있습니다. **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" %} 활성화 [엔터프라이즈 제어 암호화(ECE)](/command/ko/security/enterprise-controlled-encryption.md) 를 사용하여 보안을 강화하세요. {% endhint %} *** **Microsoft Entra ID 구성** {% stepper %} {% step %} **로그인하세요** [**Microsoft Entra ID 포털**](https://portal.azure.com)**.** {% endstep %} {% step %} **App registrations를 검색하여 선택합니다.** {% 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 %} **애플리케이션(클라이언트) ID와 디렉터리(테넌트) ID를 복사하여 안전한 곳에 저장하세요. Verkada Command의 설정을 완료하려면 이 값이 필요합니다.** {% endstep %} {% step %} **왼쪽에서 관리 > API 노출을 클릭합니다.** a. 클릭 **범위 추가.**\ b. 클릭 **저장하고 계속**을 클릭합니다.\nc. 다음을 입력합니다. *verkada\_ece* 를 다음 필드에 대해: * 범위 이름 * 관리자 동의 표시 이름 * 관리자 동의 설명 * 사용자 동의 표시 이름 * 사용자 동의 설명 d. 다음으로 설정합니다. **동의할 수 있는 사용자?** 을 **관리자와 사용자.**\ e. 클릭 **범위 추가.**
{% endstep %} {% endstepper %} *** **Verkada Command 구성** {% stepper %} {% step %} **Verkada Command에서 모든 제품 > 관리자로 이동합니다.** {% 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. 다음의 경우 **식별자**:\n미국 조직의 경우: \ EU 조직의 경우: 호주 조직의 경우: b. 다음의 경우 **회신 URL**:\n미국 조직의 경우: \ EU 조직의 경우: \ 호주 조직의 경우: c. 다음의 경우 **로그인 URL**:\n미국 조직의 경우: \ EU 조직의 경우: [https://saml.prod2.verkada.com/saml/login](https://saml.prod2.verkada.com/saml/login/)\ 호주 조직의 경우: {% 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 %} **현재 사용자로 로그인하여 로그인합니다. 모든 것이 올바르게 설정되었다면 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는 자동 사용자 및 그룹 프로비저닝을 위해 크로스 도메인 ID 관리 시스템(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에서 모든 제품 > 관리자로 이동합니다.** {% endstep %} {% step %} **조직 설정에서 로그인 및 액세스 및 로그 > SCIM 사용자 프로비저닝을 선택합니다.** {% endstep %} {% step %} **도메인 추가를 클릭하고 SCIM과 함께 사용할 모든 관련 이메일 도메인을 입력합니다.** 이렇게 하면 SCIM 토큰이 생성되며, **한 번만 볼 수 있습니다.** a. 클릭 **복사** 하고 나중에 구성에 사용할 수 있도록 토큰을 안전한 곳에 저장합니다.\nb. 클릭 [**새로 고침**](/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. Verkada Command에서 다음으로 돌아갑니다. **관리자 > 로그인 및 액세스 및 로그 > SCIM 사용자 프로비저닝**. SCIM 구성에 표시된 테넌트 URL을 복사합니다. c. 이 값을 Microsoft Entra ID의 테넌트 URL 필드에 붙여넣습니다. d. Verkada Command에서 생성된 SCIM 토큰(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 위의 속성과 일치시키세요.\nb. 다음을 설정합니다. **대상 속성** 을 다음과 일치하도록 **customappsso** 위 속성과 일치시킵니다.\nc. 클릭 **확인**. {% 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 속성 아래의 속성이 **Expression** 매핑 유형으로 추가됩니다. {% endhint %} {% hint style="warning" %} Source Attribute는 Microsoft Entra ID 속성이며 Target Attribute는 customappsso 속성입니다. Target Attribute로 사용할 수 없는 속성이 있으면 Microsoft Entra ID 플랫폼에 옵션으로 추가해야 할 수 있습니다. 이렇게 하려면 **customappsso** 고급 옵션 표시 **확인란을 선택하고** 를 클릭합니다. **customappsso에 대한 속성 목록 편집**. {% endhint %} {% endstep %} {% step %} **변경 사항을 확인하려면 저장을 클릭합니다.** {% endstep %} {% step %} **상단에서 프로비저닝을 선택하고 프로비저닝 상태를 켭니다.**
{% endstep %} {% step %} **요구 사항에 따라 범위를 다음 필수 옵션 중 하나로 조정합니다:** * 모든 사용자와 그룹을 동기화합니다. * 할당된 사용자와 그룹만 동기화합니다. {% hint style="warning" %} 사용자 및 그룹 아래의 엔터프라이즈 애플리케이션에 사용자와 그룹이 할당되었는지 확인합니다. 할당된 항목이 프로비저닝되어 Command에 표시됩니다. {% endhint %} {% endstep %} {% step %} **사용자들이 애플리케이션에 할당되었는지 확인하세요. 초기 프로비저닝 주기가 지나면:** a. 아래에서 프로비저닝이 성공한 총 사용자 및 그룹 수를 볼 수 있어야 합니다 **개요**.\nb. 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 %} **검색창에 엔터프라이즈 애플리케이션을 입력하고 선택합니다.** {% endstep %} {% step %} **Verkada SCIM 애플리케이션을 선택합니다.** {% endstep %} {% step %} **왼쪽 패널에서 관리 > 프로비저닝을 클릭합니다.** {% endstep %} {% step %} **매핑 하위 메뉴를 확장하고 Microsoft Entra ID 사용자 프로비저닝을 선택합니다.** {% endstep %} {% step %} **하단에서 고급 옵션 표시 > customappsso에 대한 속성 목록 편집을 클릭합니다.** a. 아래 표의 속성을 추가합니다.\nb. 클릭 **저장**. {% endstep %} {% step %} **Microsoft Entra ID 사용자 프로비저닝으로 돌아가서 새 매핑 추가를 선택합니다.** a. extensionAttributes 1-5를 **소스 속성** 으로 사용하고 이를 다음에 대해 생성한 새 속성에 매핑합니다. **카드 형식, 카드 번호, 카드 번호 Hex, 자격 증명 상태,** 및 **시설 코드** 를 대상 속성으로 사용합니다. 1. 참조 [허용되는 카드 형식](/access-control/ko/installation/badge-reader-support/supported-card-formats.md) 에서 허용되는 카드 형식과 해당 시설 코드, 카드 번호 및/또는 카드 번호 Hex 길이를 확인하세요. 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 %} **모든 애플리케이션 탭으로 전환하고 Verkada SCIM 애플리케이션 이름을 검색합니다.** {% endstep %} {% step %} **개요에서 앱 등록의 애플리케이션(클라이언트) ID와 디렉터리(테넌트) ID를 기록해 두세요. 나중에 앱 등록에서 Command 애플리케이션의 자격 증명을 구성하는 데 필요합니다.** {% endstep %} {% step %} **왼쪽 탐색에서 관리를 클릭합니다.** a. 아래에서 **인증서 및 비밀:** 1. 클릭 **새 클라이언트 비밀**. 2. 다음으로 설정합니다. **설명** 을 "*Verkada SCIM 자격 증명"* 으로 설정하고 원하는 인증서 만료 날짜를 설정합니다. 3. 표시된 값을 복사하여 저장하세요 **값** 새로 생성된 Client Secret의 값. **이것은 한 번만 표시됩니다.** e. 아래에서 **API 권한**: 1. 클릭 **권한 추가 > Microsoft Graph.** 2. 선택 **애플리케이션 권한** 그리고 "*User.ReadWrite.All*". 1. 권한을 할당하려면 확인란을 선택하세요. 2. 클릭 **권한 추가**.
3. Microsoft Entra ID와 Command 애플리케이션 간에 전달되는 모든 단계 변경 사항을 수동으로 검토하고 승인해야 하는 것을 피하려면, **Default Directory에 대한 관리자 동의 부여**.
{% endstep %} {% endstepper %} {% hint style="warning" %} 다음 자격 증명 목록을 참조하세요 [허용되는 카드 형식](/access-control/ko/installation/badge-reader-support/supported-card-formats.md). {% endhint %} **자격 증명에 액세스하고 업데이트하기** 특정 사용자의 확장 특성 및 자격 증명 정보를 설정하려면 다음 Graph API 지침을 사용하세요: . {% hint style="warning" %} 다음을 설정하는 것 **credentialStatus** 특성을 **active** 사용자의 자격 증명을 설정할 때 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" } }' ``` *** **Verkada에 External ID 동기화** 해당 `externalId` 이 필드를 사용하면 Microsoft Entra를 통해 사용자의 지속적이고 전 세계적으로 고유한 식별자를 할당할 수 있으며, Verkada는 이를 통합 전반에서 참조할 수 있습니다. 이는 사용자를 시스템 간에 구분해야 하거나, 자격 증명(예: 출입 카드) 동기화가 고유한 식별 키에 연결되어야 하는 대규모 엔터프라이즈 환경에서 특히 유용합니다. Verkada는 SCIM 사용자 스키마의 일부로 이 값을 수신하고 저장하는 것을 지원합니다. 이 필드는 대소문자를 구분하며, 일반적으로 Microsoft Entra 인스턴스의 지정된 특성에서 문자열 값을 받도록 구성됩니다. 이 기능은 사용자 지정 자격 증명 관리, 직원 수명 주기 자동화, 조직 전반의 일관된 사용자 매핑과 같은 고급 워크플로를 지원합니다. **Azure의 externalId를 Verkada에 매핑** Microsoft Entra ID(Azure)의 사용자 지정 externalId 값을 Verkada로 동기화하려면 다음 단계를 따르세요: {% 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 %} 에 대해 **원본 특성**, external 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 레코드에 저장됩니다. 이를 통해 사용자는 조직 내에서 고유하게 유지되고 완전히 사용자가 제어할 수 있는, API로 조회 가능한 유연한 ID를 확보할 수 있으며, Verkada의 내부 식별자에 묶이거나 사용자 인터페이스에 노출되지 않습니다. ![](https://1764840814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-ad87e0166a1792938d4c35d10f1172332fbfa36e%2Fa1cab99d0a59e02d8322c174969b568cb1519438.png?alt=media) {% 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.