> 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/ad-fs.md).

# AD FS

Verkada Command는 Active Directory Federation Services(AD FS)와 통합하여 사용자가 기존 AD 자격 증명으로 로그인할 수 있도록 지원합니다.

Security Assertion Markup Language(SAML)는 AD FS가 Command와 통신하여 사용자에게 조직에 대한 안전한 액세스 권한을 부여할 수 있게 하는 언어입니다.

| 기능         | 지원됨 |
| ---------- | :-: |
| OIDC SSO   |  —  |
| SAML SSO   |  예  |
| SCIM 프로비저닝 |  —  |
| ECE 지원     |  —  |

{% hint style="warning" %}
SAML은 사용자를 조직에 추가하거나 초대하지 않습니다. 단지 이전에 프로비저닝된 사용자가 Verkada에서 관리하는 사용자 이름과 비밀번호가 아닌 AD 자격 증명으로 로그인할 수 있게 해줄 뿐입니다.

도메인 사용자와 그룹을 Command와 동기화하는 데 관심이 있으시면, 다음에 대해 자세히 알아보세요. [SCIM](/command/ko/security/identity-providers/microsoft-entra-id.md).
{% endhint %}

### 시작하기 전에

SAML 통합을 시작하려면 다음을 수행해야 합니다. [조직의 클라이언트 ID를 생성해야 합니다.](/command/ko/security/identity-providers.md#generate-client-id) (클라이언트 ID는 대소문자를 구분합니다).

***

## 구성

### 신뢰 당사자 트러스트 추가

{% stepper %}
{% step %}
**AD FS 관리 도구를 엽니다.**

<div align="left" data-with-frame="true"><img src="/files/f8ef63461543a753b30f259442275aa47225892a" alt=""></div>
{% endstep %}

{% step %}
**작업 > 신뢰 당사자 트러스트 추가를 선택합니다.**

<div align="left" data-with-frame="true"><img src="/files/342fa84e4dc19511f925248fed9276d33dac637d" alt=""></div>
{% endstep %}

{% step %}
**Claims aware를 선택하고 시작을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/aaf13b93b29e293603818206b1fc444cbedc4dad" alt=""></div>
{% endstep %}

{% step %}
**신뢰 당사자에 대한 데이터를 수동으로 입력을 선택하고 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/aa9890da39ec63031217dc5739219bbe3eb2f64e" alt=""></div>
{% endstep %}

{% step %}
**표시 이름(아무거나 가능)을 입력하고 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/96c4687d8d582911126d45b43bd4de0e0a11f71d" alt=""></div>
{% endstep %}

{% step %}
**선택적 토큰 암호화 인증서를 지정하고(지정하려면 찾아보기를 클릭), 그런 다음 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/ac511a66c7d50564eb9bc7187fb178374c1faefa" alt=""></div>
{% endstep %}

{% step %}
**SAML 2.0 WebSSO 프로토콜 지원 활성화를 선택하고, 신뢰 당사자 SAML 2.0 SSO 서비스 URL 필드에 다음을 입력합니다(대체&#x20;*****client-ID*****&#x20;을 이전에 생성한 클라이언트 ID로 바꿉니다):**

* 미국 조직의 경우: <https://vauth.command.verkada.com/saml/sso/%3Cclient-ID%3E>
* 유럽 연합(EU) 조직의 경우: [https://saml.prod2.verkada.com/saml/sso/](https://saml.prod2.verkada.com/saml/sso/%3Cclient-ID%3E)
* 호주(AUS)의 경우: <https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E>

{% hint style="warning" %}
속한 지역을 확인하려면 다음을 [Verkada에서 조직이 생성된 위치를 참조하세요.](/command/ko/getting-started/get-started-with-verkada-command.md).
{% endhint %}
{% endstep %}

{% step %}
**다음을 클릭합니다.**
{% endstep %}

{% step %}
**신뢰 당사자 트러스트 식별자 필드에 7단계와 동일한 URL을 입력하고 추가 > 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/9c2a0063e0c87f67b57fcb02b59555b467dba410" alt=""></div>
{% endstep %}

{% step %}
**이 애플리케이션에 적합한 액세스 제어 정책을 구성하고 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/3ac0c37cf7401a320c75856038cbe3928a1017fe" alt=""></div>
{% endstep %}

{% step %}
**신뢰 당사자 설정을 검토하고 다음 > 닫기를 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/dffffda857843d31de9cebdc964a9c7afe57387a" alt=""></div>
{% endstep %}
{% endstepper %}

### 클레임 발급 정책 편집

{% stepper %}
{% step %}
**새로 만든 신뢰 당사자 트러스트를 마우스 오른쪽 버튼으로 클릭하고 클레임 발급 정책 편집을 선택합니다.**

<div align="left" data-with-frame="true"><img src="/files/f563486b14f03664ae6c358966d4fbb24cb72072" alt=""></div>
{% endstep %}

{% step %}
**규칙 추가 > 확인을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/bcd213636c7ea5f77565b0eff25b9b49acaae5cb" alt=""></div>
{% endstep %}
{% endstepper %}

### 변환 클레임 규칙 추가

{% stepper %}
{% step %}
**Send LDAP Attributes as Claims가 선택되어 있는지 확인하고 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/ca18ca148bf645569d87e8ec7e99b34722ad88ac" alt=""></div>
{% endstep %}

{% step %}
**다음 규칙 설정을 구성하고(완료되면) 마침을 클릭합니다:**

a. 다음을 입력합니다. **클레임 규칙 이름** (아무거나 가능).\
b. 아래에서 **속성 저장소**, 다음이 **Active Directory** 가 선택되어 있는지 확인합니다.\
c. 다음 LDAP 특성을 적절한 **보내는 클레임 유형**:

* E-Mail-Addresses > E-Mail Address
* Given-Name > Given Name
* Surname > Surname

<div align="left" data-with-frame="true"><img src="/files/93ef34680c4ece905a040b15ee5e4e570847e17b" alt=""></div>
{% endstep %}

{% step %}
**클레임 규칙 템플릿 아래에서 들어오는 클레임 변환을 선택하여 다른 규칙을 추가한 다음 다음을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/df2bddeb722a10e1a14147b6a4412983a46d11fd" alt=""></div>
{% endstep %}

{% step %}
**클레임 규칙을 구성합니다:**

a. 다음을 입력합니다. **클레임 규칙 이름** (아무거나 가능).\
b. 다음 옆에 **들어오는 클레임 유형**를 선택합니다. **E-Mail Address**.\
c. 다음 옆에 **보내는 클레임 유형**를 선택합니다. **Name ID**.\
d. 다음 옆에 **보내는 Name ID 형식**를 선택합니다. **Transient Identifier**.\
e. 다음이 **모든 클레임 값 전달** 가 선택되어 있는지 확인합니다.\
f.  **마침을 클릭합니다**.

<div align="left"><figure><img src="/files/1d8c9245a45b1df1251d749c2f7b7994bbe673a8" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**다음으로 이동합니다. `https:///FederationMetadata/2007-06/FederationMetadata.xml` 를 눌러 XML 메타데이터 파일을 다운로드합니다.**

{% hint style="danger" %}
**하지 마세요.** 이 단계를 완료하는 데 Internet Explorer를 사용하지 마십시오. Internet Explorer를 사용하면 XML 파일에 문제가 발생할 수 있습니다.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### Command에서 SAML 설정 완료

다음의 단계를 따르세요. [Command 계정에 SAML 활성화](/command/ko/security/identity-providers.md#upload-saml-xml-metadata) Command에서 SAML 설정을 완료합니다.

### 통합 테스트

통합이 완료되면 테스트하세요.

{% stepper %}
{% step %}
**시크릿/개인 브라우징 창을 열고 다음으로 이동합니다(여기서 clientID를 위에서 생성한 클라이언트 ID로 바꿉니다):**

* 미국의 경우: <https://vauth.command.verkada.com/saml/login/%3Cclient-ID%3E>
* 유럽 연합(EU)의 경우: [https://saml.prod2.verkada.com/saml/login/](https://saml.prod2.verkada.com/saml/login/%3Cclient-ID%3E)
* 호주(AUS)의 경우: [https://saml.prod-ap-syd.verkada.com/saml/sso/](https://saml.prod2.verkada.com/saml/login/%3Cclient-ID%3E)

{% hint style="warning" %}
속한 지역을 확인하려면 다음을 [Verkada에서 조직이 생성된 위치를 참조하세요.](/command/ko/getting-started/get-started-with-verkada-command.md).
{% endhint %}
{% endstep %}

{% step %}
**AD FS 로그인 페이지로 이동해야 합니다. 자격 증명으로 로그인해 보세요.**
{% endstep %}

{% step %}
**Command 조직으로 리디렉션되면 SAML 통합이 성공한 것입니다.**
{% endstep %}
{% endstepper %}


---

# 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/ad-fs.md?ask=<question>&goal=<endgoal>
```

`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.