Channels

채널 관리

채널은 FIDOX API를 운영하는 독립 단위입니다. API 키, FR 설정, 멤버, 디바이스는 모두 채널 단위로 관리됩니다.

채널이란?

채널은 하나의 서비스 또는 환경을 나타냅니다. 예를 들어 prod-main, dev-test처럼 서비스 단위나 환경별로 채널을 분리해 관리할 수 있습니다.

채널마다 별도의 Access Key / Secret Key 발급
채널별 독립적인 얼굴 데이터베이스
채널별 FR 설정 (임계값, 라이브니스 등)
채널별 사용량 통계

플랜별로 생성 가능한 채널 수가 다릅니다. 요금제 페이지에서 확인하세요.

채널 생성

사이드바 → '대시보드' 또는 채널 드롭다운에서 채널 관리 진입 후 '새 채널' 클릭

채널명과 설명 입력

채널명은 콘솔 식별용 이름이며 언제든 변경할 수 있습니다. 채널 코드(ch-xxxxxx)와 API 키 한 쌍은 생성 시 자동으로 부여됩니다.

생성 완료

채널 트리에 새 채널이 추가됩니다. 채널을 선택하면 사이드바의 디바이스/API 키/Playground/사용량/FR 로그/FR 설정 메뉴가 해당 채널에 연동됩니다.

하위 채널(가맹점·매장 등)은 채널 트리에서 상위 채널 우측의 하위 채널 추가 버튼으로 생성합니다.

채널 설정 수정

채널 관리 화면에서 채널 카드의 편집 아이콘으로 수정합니다.

옵션	설명
채널 이름 / 설명	언제든 변경 가능. 채널 코드는 변경 불가.
활성 / 비활성	비활성 상태에서는 해당 채널 API 호출이 차단됩니다.
FR 설정	검색 범위·이미지 보관·동의/중복 검사 옵션. 사이드바의 FR 설정 메뉴에서 변경합니다(Owner·최상위 채널만).

API 키 관리

채널마다 Access Key(ak_)와 Secret Key(sk_) 한 쌍이 발급됩니다. API 호출 시 두 키로 채널 토큰을 발급받아 사용합니다.

채널 선택 → 사이드바의 'API 키' 메뉴 클릭

현재 채널의 Access Key가 표시됩니다. Secret Key는 마스킹된 상태로 표시됩니다.

'키 갱신' 클릭 (Owner만)

기존 키 한 쌍이 즉시 무효화되고 새 키 한 쌍이 발급됩니다. 새 Secret Key는 갱신 직후 화면에서 한 번만 전체 값을 확인할 수 있으니 즉시 복사해 보관하세요.

키 갱신은 즉시 적용되며, 갱신 전 기존 키를 사용하던 모든 클라이언트는 갱신 직후 401을 받습니다. 새 키를 안전하게 배포한 뒤 갱신하거나, 짧은 다운타임을 감수할 수 있는 시점에 진행하세요.

채널 계층 (부모-자식)

채널에 상위 채널(parentId)을 지정해 계층 구조를 구성할 수 있습니다. 가맹점(자식 채널)의 사용량을 본사(부모 채널) 단위로 집계하거나, 채널별 데이터를 격리하면서도 상위에서 관리하는 방식으로 활용할 수 있습니다. FR 설정은 최상위(루트) 채널에서만 변경할 수 있고 하위 채널은 부모 설정을 따릅니다.

채널 삭제

채널을 삭제하면 등록된 모든 얼굴 데이터, 로그, API 키, 디바이스, 그리고 하위 채널까지 함께 영구 삭제됩니다.

채널 관리 화면에서 대상 채널 카드의 휴지통 아이콘 클릭

확인 다이얼로그에서 '삭제' 버튼 클릭