컴백부터 K-뷰티까지 — K-컬쳐의 모든 것을 메일로 받아보세요메일로 받아보기

METAL MEDIA

lifefloating/keyHunter-skill

★ 28Python

AI 게이트웨이 관리 패널을 찾아 약한 비밀번호를 테스트하는 도구, 단 승인된 보안 연구용으로만

keyHunter는 Sub2API, New-API, One-API 같은 AI 게이트웨이·쿼터 관리 패널의 보안 취약점을 연구하기 위해 만들어진 파이썬 명령줄 도구다. FOFA 검색으로 노출된 서버를 찾고, 어떤 종류의 패널인지 식별한 뒤, 약한 비밀번호 목록으로 로그인을 시도하고, 결과를 표준화된 JSON 파일로 정리하는 과정을 하나로 이어준다. README와 라이선스는 소유하고 있거나 서면으로 명확히 승인받은 시스템에만 사용하라고 못박고 있다.

무엇을 하는 레포인가

  1. FOFA 검색으로 후보 서버를 찾고, 지문 인식으로 어떤 패널(Sub2API/New-API/One-API)인지 확인하고, 함께 배포되는 약 489개 항목의 약한 비밀번호 사전으로 로그인을 시도한 뒤, 계정 데이터를 뽑아내 JSON 형태로 정리하는 파이프라인 구조다.
  2. 세 종류의 패널을 기본 지원한다. Sub2API는 이메일 로그인, New-API와 One-API는 사용자명 로그인과 IDOR 방식의 토큰/채널 접근 패턴을 쓰며 각각 로그인·데이터 추출 엔드포인트가 문서화돼 있다.
  3. 비밀번호 시도는 정해진 순서를 따른다. 제품에 내장된 알려진 조합을 먼저 쓰고, 그다음 이메일별로 사전 전체를 시도한다. 관리자가 아닌 세션이 뚫려도 기록만 하고 그걸로 관리자 행세를 하며 데이터를 빼내지는 않으며, 시도 횟수를 제한하지 않으면 기본적으로 전체 사전을 다 돌린다.
  4. 토큰은 디스크에만 저장하고 화면에는 절대 출력하지 않으며, 별도의 validate 명령으로 확보한 토큰이 해석 가능하고 만료되지 않았는지 확인한 뒤에야 쓸 수 있는 것으로 취급한다.
  5. agentskills.io 표준을 따르는 SKILL.md 파일을 함께 제공해서 Claude Code나 Codex CLI 같은 도구가 이를 자동화된 작업 매뉴얼로 바로 불러와 실행할 수 있게 했다.
  6. README와 별도의 'Defensive Security Source License'는 이 도구가 승인된 방어적 학술 연구 목적으로만 쓰여야 한다고 명시하며, 명시적 서면 승인 없는 시스템에 대한 스캔이나 자격증명 사용을 금지한다.

왜 중요한가

AI 에이전트용 코딩 도구들이 보안 연구 작업 흐름을 Claude Code 같은 에이전트가 바로 실행할 수 있는 설치형 스킬로 패키징하는 흐름을 잘 보여준다. AI 게이트웨이·쿼터 패널을 만들거나 운영하는 사람이라면, 노출된 관리 패널을 노리는 자동화된 정찰과 비밀번호 시도 과정이 구체적으로 어떻게 이뤄지는지 알 수 있고, 도구 자체가 '방어적'이라 표방해도 승인 범위가 무엇보다 중요하다는 점을 다시 확인할 수 있다.

이 레포의 용어

  • FOFA · 인터넷에 연결된 장비·서비스를 색인해두는 검색엔진으로, 대상 서버를 찾는 데 쓰인다
  • 지문 인식(fingerprinting) · 서버에 요청을 보내 어떤 소프트웨어인지 식별하는 기법
  • 撞库(비밀번호 스프레이) · 알려진 또는 흔한 아이디·비밀번호 조합을 로그인 시스템에 차례로 시도하는 방식
  • IDOR · 요청 속 ID값만 바꿔서 다른 사용자의 데이터에 접근할 수 있게 되는 취약점
  • JWT · 로그인 세션에 흔히 쓰이는 서명된 압축 토큰 형식

레포 원문 소개 (영문)

Academic research toolkit for AI gateway panel security studies (Sub2API / New-API / One-API): FOFA discovery, fingerprinting, credential-hygiene testing, artifact normalization. Authorized, defensive use only.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

METAL MEDIA 최신 기사