그룹은 장치, 사용자, 데이터를 논리적으로 구분하는 단위입니다. 관리자는 그룹을 생성하고 각 그룹의 장치 제한, 데이터 보존 기간, 인증 정보를 관리할 수 있습니다.
그룹의 개념에 대한 자세한 설명은 기본 개념을 참조하세요.
그룹 관리는 관리자 전용 기능입니다.
라이선스와 장치 할당
라이선스에는 등록 가능한 총 장치 한도가 정해져 있습니다. 이 장치 수를 각 그룹에 나누어 할당합니다.
장치 할당 개념
| 용어 | 설명 |
|---|---|
| 총 장치 한도 | 라이선스에서 허용하는 최대 장치 수 |
| 할당된 장치 한도 | 모든 그룹의 "최대 장치 수" 합계 (각 그룹에 예약된 슬롯) |
| 등록된 장치 | 실제로 등록되어 사용 중인 장치 수 |
그룹 생성 시 설정하는 "최대 장치 수"는 해당 그룹에 미리 예약하는 개념입니다. 실제 장치가 등록되지 않아도 할당된 장치 한도에 포함됩니다.
라이선스에 대한 자세한 내용은 라이선스 문서를 참조하세요.
그룹 목록
그룹 목록에서 등록된 그룹들을 확인하고 관리할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 이름 | 그룹 이름 |
| 설명 | 그룹에 대한 설명 |
| 장치 | 등록된 장치 수 / 최대 장치 수 |
| 사용자 | 그룹에 속한 사용자 수 |
| 데이터 보존 | 데이터 보존 기간 (일) |
| 액션 | 인증 정보, 수정, 삭제 |
그룹 생성
그룹 추가 버튼을 클릭하여 새 그룹을 생성합니다.
| 항목 | 설명 |
|---|---|
| 이름 | 그룹의 고유 이름 (필수) |
| 설명 | 그룹에 대한 설명 (선택) |
| 최대 장치 수 | 그룹에 등록할 수 있는 최대 장치 수 |
| 데이터 보존 기간 | 장치 데이터를 보존할 기간 (일), 기본값: 365일 |
최대 장치 수는 라이선스에서 남은 할당 가능 장치 수를 초과할 수 없습니다.
그룹 수정
그룹 목록에서 버튼을 클릭한 후 수정을 선택합니다.
- 그룹 이름, 설명, 최대 장치 수, 데이터 보존 기간을 변경할 수 있습니다
- 최대 장치 수는 현재 등록된 장치 수보다 작게 설정할 수 없습니다
그룹 삭제
그룹 목록에서 버튼을 클릭한 후 삭제를 선택합니다.
주의: 그룹에 장치가 등록되어 있으면 삭제할 수 없습니다. 먼저 모든 장치를 영구 삭제해야 합니다.
삭제 확인을 위해 그룹 이름을 정확히 입력해야 합니다.
인증 정보
각 그룹은 고유한 그룹 ID와 API 키를 가집니다. 이 정보는 장치에서 데이터를 전송할 때 인증에 사용됩니다.
인증 정보 확인
그룹 목록에서 버튼을 클릭한 후 인증 정보를 선택합니다.
| 항목 | 설명 |
|---|---|
| 그룹 ID | 그룹의 고유 식별자 (MQTT 사용자명으로 사용) |
| API 키 | HTTP API 인증 및 MQTT 비밀번호로 사용 |
각 항목 옆의 버튼을 클릭하여 클립보드에 복사할 수 있습니다.
API 키 사용 방법
HTTP API
MQTT
| 설정 | 값 |
|---|---|
| 호스트 | 서버 주소 |
| 포트 | 8883 (TLS) |
| 사용자명 | 그룹 ID |
| 비밀번호 | API 키 |
| 토픽 | iotown/{그룹ID}/{장치ID}/data |
자세한 내용은 REST API 및 MQTT 문서를 참조하세요.
API 키 재생성
API 키가 노출되었거나 보안상의 이유로 키를 변경해야 하는 경우 재생성할 수 있습니다.
- API 키 관리 다이얼로그에서 키 재생성 링크를 클릭합니다
- 확인을 위해 "재생성"을 입력합니다
- 키 재생성 버튼을 클릭합니다
주의: API 키를 재생성하면 이전 키는 즉시 무효화됩니다. 해당 그룹의 모든 장치에서 새 API 키로 업데이트해야 합니다.
역할별 접근 권한
| 역할 | 그룹 관리 | 인증 정보 확인 |
|---|---|---|
| 관리자 | 모든 그룹 CRUD | 모든 그룹 |
| 매니저 | ❌ | 자신의 그룹만 (헤더 메뉴) |
| 뷰어 | ❌ | ❌ |
매니저는 화면 상단 헤더의 사용자 메뉴에서 자신이 속한 그룹의 인증 정보를 확인할 수 있습니다.