UniFi 정보 프로토콜 역분석: 멀티테넌트 라우팅 방법

UniFi inform 프로토콜 구조

모든 UniFi 장치(액세스 포인트, 스위치, 게이트웨이)는 10초마다 포트 8080으로 HTTP POST를 통해 컨트롤러에 연결합니다. 이는 장치 통계, 구성 동기화, 펌웨어 버전 및 클라이언트 수를 처리합니다. 페이로드는 AES-128-CBC로 암호화되어 있지만, 헤더에는 평문 장치 식별 정보가 포함됩니다.

패킷 헤더 세부 정보

모든 inform 패킷의 처음 40바이트는 암호화되지 않습니다:

오프셋 크기 필드
────── ───── ──────────────────────────
0      4B    매직: "TNBU" (0x544E4255)
4      4B    패킷 버전 (현재 0)
8      6B    장치 MAC 주소
14     2B    플래그 (암호화, 압축 등)
16     2B    AES IV 길이
18     16B   AES IV
34     4B    데이터 버전
38     4B    페이로드 길이
42+    var   암호화된 페이로드 (AES-128-CBC)

바이트 오프셋 8의 MAC 주소는 완전히 암호화되지 않습니다. "TNBU"는 "UBNT"를 거꾸로 한 것입니다(Ubiquiti의 티커 심볼 및 기본 SSH 자격 증명).

MAC 추출 및 라우팅

MAC 주소 추출에는 최소한의 코드만 필요합니다:

header := make([]byte, 40)
if _, err := io.ReadFull(conn, header); err != nil {
    return err
}
if string(header[0:4]) != "TNBU" {
    return fmt.Errorf("inform 패킷이 아님")
}
mac := fmt.Sprintf("%02x:%02x:%02x:%02x:%02x:%02x", 
    header[8], header[9], header[10], 
    header[11], header[12], header[13])

MAC 주소를 확보하면 라우팅이 간단해집니다: MAC 주소를 테넌트에 매핑하는 테이블을 유지한 다음, 전체 패킷(헤더와 암호화된 페이로드는 그대로)을 올바른 백엔드로 전달합니다. 프록시는 메모리 내 MAC-테넌트 조회 테이블을 사용하여 약 200줄의 Go 코드로 구현할 수 있습니다.