> 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/access-control/ko/integrations-and-alerts/integrate-supremas-biostation3-readers-with-verkada-access-control.md).

# Suprema BioStation3 리더

이 문서는 Suprema BioStation 3 생체 인식 리더를 Verkada의 출입 통제 시스템과 통합하는 방법을 설명합니다. 여기에는 고객이 제공하는 정보와 Suprema의 구성이 포함되며, Verkada는 출입 통제 인프라와 클라우드 관리 도구를 제공하고 Suprema는 얼굴 인식과 생체 데이터를 처리합니다.

***

### 통합 개요

모든 사용자와 액세스 레벨은 Verkada Command에서 관리됩니다. Suprema는 Verkada의 API를 사용하여 사용자 데이터와 프로필 사진을 가져온 다음, 각 얼굴에 고유한 자격 증명 문자열을 생성하여 Command에 업로드합니다. 사용자가 출입을 시도하면 BioStation 3가 얼굴을 스캔해 자격 증명 문자열로 변환한 후 Verkada의 ACU로 전송합니다. 자격 증명이 일치하면 출입이 허용됩니다.

<div align="left" data-with-frame="true"><img src="/files/39c026f9799d0bb4955ccce6d8e7ced1bb82b5ab" alt=""></div>

Suprema를 사용하면 사용자가 최신 Command 사용자 데이터를 정기적으로 가져와 권한을 최신 상태로 유지하도록 사용자 지정 동기화 주기를 설정할 수 있습니다. 얼굴 등록 및 모범 사례에 대한 자세한 내용은 Suprema의 [지식 베이스 문서](https://kb.supremainc.com/knowledge/doku.php?id=en:how_to_use_face_credential_correctly_for_biostation_3).

{% hint style="danger" %}
이 통합을 배포하려면 API 토큰을 생성하여 Suprema에 제공해야 합니다. 이 토큰은 Command에서 데이터를 검색하고 변경할 수 있는 권한을 부여하며, 고객은 이를 안전하게 유지할 책임이 있습니다. Verkada는 고객의 API 토큰을 사용하여 Command에서 액세스된 데이터 또는 수행된 변경 사항에 대해 책임을 지지 않습니다.
{% endhint %}

***

## 시스템 요구 사항

|             |                                                |                                                                                                                                                                                                                                                                        |
| ----------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|             | **하드웨어**                                       | **소프트웨어**                                                                                                                                                                                                                                                              |
| **Verkada** | **Verkada 출입 통제 패널 -** 단일 도어 또는 다중 도어 ACU.     | <p><strong>출입 통제 라이선스 -</strong> 최소 1개의 도어 라이선스.</p><p><strong>자격 증명 유형 -</strong> CLUeXfer는 각 Verkada 사용자에게 26비트 Standard Wiegand 카드를 자동으로 할당하여 CLUe에 저장하므로 수동 카드 등록이 필요하지 않습니다. 사용자가 인증하면 장치가 검증과 출입을 위해 26비트 카드 ID를 Verkada 컨트롤러로 전송합니다.</p>                        |
| **Suprema** | **BioStation 3(BS3) -** CLUe와 호환되는 펌웨어가 필요합니다. | <p><strong>CLUe 플랫폼</strong> -통합 설정을 위해 Suprema 플랫폼에 대한 액세스가 필요합니다.</p><p>**DataXfer 사이트( Suprema가 프로비저닝함) -** Suprema는 설정 중에 Suprema와 Verkada 시스템 간의 데이터 전송을 관리하기 위한 전용 사이트를 프로비저닝합니다.</p><p><strong>DataXfer 사이트 라이선스 -</strong> DataXfer 사이트에는 유효한 라이선스가 필요합니다.</p> |

***

## 필수 API 자격 증명

### Verkada API 키 구성

사용자는 다음 속성을 가진 Verkada API 키를 만들어야 합니다:

* **이름** - 설명이 있는 이름(예: "Suprema 통합 키").
* **엔드포인트 액세스**
  * **Core Command** - 읽기/쓰기 또는 읽기 전용일 수 있습니다.
  * **액세스 제어** - 사용자 프로비저닝 및 액세스 레벨 할당을 활성화하려면 읽기/쓰기로 설정해야 합니다.
* **만료** - 조직의 보안 정책에 따라 설정하세요.
* **지역 설정** - **Command > 개인정보 및 보안 > 데이터 상주** 에서 올바른 지역(예: 미국, EU)을 확인합니다.

### Suprema API 자격 증명

* **CLUe Place API 키 -** DataXfer 설정의 일부로 Suprema가 제공합니다.

{% hint style="warning" %}
API 키를 사용하거나 다른 사람이 사용하도록 허용하는 경우, 모든 활동이 API 사용 정책을 준수하도록 보장할 책임은 사용자에게 있습니다. Verkada는 데이터가 Command 플랫폼을 벗어난 이후의 어떠한 데이터에 대해서도 책임을 지지 않습니다.
{% endhint %}

***

## Suprema 구성

### 1단계: Verkada 정보 제공하기

사용자는 다음 Verkada 세부 정보를 Suprema의 통합 팀에 제공해야 합니다:

* 귀하의 Verkada Command 계정에서 생성한 유효한 API 키(참조 [필수 API 자격 증명](#h_b62c7a47d5)).
* 귀하의 Verkada 인스턴스에 대한 지역 설정(예: 미국, EU).
* Verkada에서 사용자 동기화에 사용할 Command 액세스 레벨. Suprema는 사용자 프로필을 이 액세스 레벨에 매핑합니다.

### 2단계: Suprema 구성 — CLUe 설정

필요한 정보가 수신되면 Suprema가 CLUe 플랫폼을 구성합니다.

#### CLUe에 대한 Suprema의 책임:

* **CLUe Place 및 Site 생성 -** Suprema는 CLUe 플랫폼 내에 고객을 위한 전용 "Place"와 "Site"를 프로비저닝합니다.
* **BS3 장치 추가 -** Suprema는 모든 BioStation 3(BS3) 장치를 등록하고 CLUe Site에 연결합니다.
* **CLUe API 생성** - CLUe 플랫폼과 Verkada를 연결하기 위한 API 통합 지점이 생성되어 사용자 데이터 전송 및 관리가 가능해집니다.

### 3단계: Suprema 구성 — DataXfer 설정

CLUe 플랫폼이 구성되면 Suprema는 DataXfer 도구를 사용하여 데이터 전송을 설정하고 검증합니다.

#### DataXfer에 대한 Suprema의 책임:

* **DataXfer Site 생성 -** CLUe와 Verkada 간의 데이터를 동기화하기 위해 전용 DataXfer Site가 프로비저닝됩니다.
* **테스트 사용자 데이터 전송 -** Suprema는 사용자 프로필이 Suprema 시스템에서 Verkada Command로 올바르게 이동하는지 확인하기 위해 테스트 전송을 수행합니다.

### 4단계: 하드웨어 설치 및 배선

마지막 단계는 고객 또는 현장 기술자가 실제 설치와 배선을 수행하는 것입니다.

#### 고객의 책임:

* **BS3 장치를 Verkada 출입 통제 패널에 배선 -** BioStation 3 Wiegand 출력을 Verkada 패널의 올바른 입력에 연결합니다.
* **신호 통신 확인 -** BS3의 Wiegand 신호가 Verkada에서 올바르게 처리되는지 확인하여 배지 판독 또는 생체 스캔이 출입 이벤트를 트리거하도록 합니다.


---

# 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/access-control/ko/integrations-and-alerts/integrate-supremas-biostation3-readers-with-verkada-access-control.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.
