Channels

채널 관리

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

채널이란?

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

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

대시보드 → 좌측 채널 목록에서 '새 채널' 클릭

채널 코드 및 이름 입력

채널 코드는 영문 소문자·숫자·하이픈 조합으로 계정 내 고유해야 합니다. 한 번 설정하면 변경할 수 없습니다.

생성 완료

채널 카드가 목록에 추가됩니다. 카드를 클릭해 채널 대시보드로 진입합니다.

채널 선택 → 상단 '설정' 탭 클릭

수정 가능한 항목

옵션	설명
채널 이름	서비스 식별용 표시 이름. 언제든 변경 가능합니다.
FR 설정	엔진·임계값·라이브니스 등 얼굴인식 세부 설정. FR 설정 가이드를 참고하세요.

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

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

'새 키 생성' 클릭

Access Key와 Secret Key가 발급됩니다. Secret Key는 이 화면에서만 전체 값을 확인할 수 있습니다.

키 교체

기존 키를 비활성화하고 새 키를 발급합니다. 서비스 중단을 방지하려면 새 키를 먼저 배포한 뒤 기존 키를 비활성화하세요.

비활성화된 API 키는 즉시 모든 요청을 거부합니다. 사전에 새 키로 교체를 완료한 후 비활성화하세요.

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

채널을 삭제하면 등록된 모든 얼굴 데이터, 로그, API 키가 영구적으로 삭제됩니다. 삭제 전 반드시 확인하세요.

채널 설정 → 하단 '위험 구역' 섹션

'채널 삭제' 버튼 클릭 → 채널 이름 재입력 후 확인