설명   |   설치   |   웹사이트   |   모듈   |   이슈   |   후원

iKy

설명

iKy는 이메일 주소 또는 기타 선택자로부터 정보를 수집하고 결과를 시각적 인터페이스로 표시하는 OSINT 도구입니다.

설치

사전 요구 사항

• Docker
• Docker Compose (Docker Desktop에 포함)
• (선택 사항) just 태스크 러너

빠른 시작

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up

브라우저에서 http://localhost:4300을 엽니다.

모든 서비스를 중지하려면:

just down

just up은 backend, iky-frontend, redis를 시작합니다. 기본적으로 다른 서비스는 시작되지 않습니다.

Docker 없이 (네이티브)

Docker를 실행할 수 없는 경우, iKy를 네이티브로 실행할 수 있습니다: Caddy가 미리 빌드된 프론트엔드를 제공하고, Redis + Celery + Uvicorn이 로컬 프로세스로 실행됩니다. 호스트에 redis-server, Python 3.12, curl, tar가 필요합니다 (Caddy는 자동으로 다운로드됩니다).

just setup          # 가상 환경 생성
just up-native      # 의존성 설치, Caddy + 프론트엔드 다운로드, 모든 항목 시작

브라우저에서 http://localhost:4300을 엽니다. Ctrl-C 또는 just down-native로 중지합니다.

프론트엔드는 최신 GitHub 릴리스에서 가져옵니다 — Node 빌드가 필요하지 않습니다. 네이티브 모드에서는 tor가 실행되지 않으며, darkweb 모듈에서만 필요합니다.

아키텍처

모듈

iKy는 backend/module_registry.py를 통해 26개의 모듈을 라우팅합니다:

API 키

애플리케이션이 브라우저에 로드되면 설정 패널에 API 키를 입력하세요. 아래는 backend/factories/apikeys_default.json의 전체 필드 표입니다:

🍪로 표시된 API는 브라우저 세션 쿠키를 사용하고, 나머지는 서비스 토큰을 사용합니다.

세션 쿠키

일부 모듈(LinkedIn, Twitter, TikTok)은 브라우저의 세션 쿠키가 필요합니다. 쿠키는 backend/cookies/에 저장되며(컨테이너 내 /app/cookies로 마운트됨) 재시작 후에도 유지됩니다. just를 통해 두 가지 방법으로 로드할 수 있습니다.

쿠키는 개인 세션 토큰입니다: 공유하거나 저장소에 커밋하지 마세요 (backend/cookies/는 git 무시됨).

옵션 A: 브라우저 내보내기 가져오기

Cookie-Editor와 같은 확장 프로그램을 사용하여 사이트 쿠키를 JSON 파일로 내보내고 가져옵니다:

just cookies-import linkedin ~/Downloads/linkedin_cookies.json

옵션 B: 브라우저에서 자동 추출

로컬 브라우저에서 직접 쿠키를 추출합니다. 실행하기 전에 브라우저를 닫으세요 (열려 있는 브라우저는 쿠키 데이터베이스를 잠급니다):

# 설치된 모든 브라우저 시도 (firefox, chrome, brave, edge)
just cookies-grab linkedin linkedin.com

# 또는 특정 브라우저 지정
just cookies-grab linkedin linkedin.com brave

명령은 브라우저별로 읽을 수 있었던 것과 읽을 수 없었던 것을 보고하고, 모듈에 필요한 쿠키를 찾은 경우에만 파일을 씁니다. 예를 들어, LinkedIn에는 li_at 및 JSESSIONID가 필요합니다.

쿠키는 주기적으로 만료됩니다 (LinkedIn 쿠키는 1~3개월 지속). 모듈 인증이 중단되면 명령을 다시 실행하세요.

개발

개발 워크플로는 린팅/pre-commit 훅을 위한 virtualenv와 **애플리케이션 빌드 및 실행을 위한 Docker(또는 네이티브 just up-native 흐름)**을 사용합니다.

개발 환경 설정

just를 설치한 후:

just setup
source .venv/bin/activate

이렇게 하면 pre-commit과 ruff가 포함된 Python virtualenv가 생성되고 git 훅이 설치됩니다.

일반적인 레시피

iKy 업데이트

최신 변경 사항을 가져오고 Docker 이미지를 재빌드합니다:

git pull
just rebuild

업데이트 시 API 키를 유지하려면 그래픽 인터페이스의 apikeys 메뉴에서 내보내기/가져오기 옵션을 사용하세요.

위키

• iKy 위키

데모 영상

Vimeo

프로젝트 후원

이 프로젝트를 사용하거나, 여기서 무언가를 배웠거나, 단순히 좋아한다면, 저에게 커피 한 잔 사주셔서 후원을 고려해 주세요. 그러면 이와 같은 오픈 소스 프로젝트에 더 많은 시간을 할애할 수 있습니다.

면책 조항

프로젝트에 기여했거나 기여하는 모든 사람(저를 포함)은 도구의 사용(합법적 사용, 불법적 사용, 또는 "기타" 사용)에 대해 책임을 지지 않습니다.

이 소프트웨어는 처음에는 농담으로 작성되었고, 그 다음에는 교육 목적(스스로 교육하기 위해)으로 작성되었으며, 현재 목표는 커뮤니티와 협력하여 양질의 무료 소프트웨어를 만드는 것임을 명심하십시오. 품질이 훌륭하지는 않더라도(때로는 좋지 않더라도) 우리는 탁월함을 추구하기 위해 노력합니다.

수집된 모든 정보는 무료이며 온라인에서 이용 가능하며, 도구는 단지 이를 발견, 수집 및 표시하려고 시도할 뿐입니다. 도구는 발견 및 수집 목표를 달성하지 못하는 경우가 많습니다. 필요한 API를 로드한 후에 제 어머니를 기억하기 전에 해주십시오. API를 사용해도 기대하는 "멋진" 것들이 표시되지 않으면 제 어머니를 기억하기 전에 다른 이메일을 시도해 보십시오. 여전히 기대하는 "멋진" 것들이 보이지 않으면 이슈를 생성하거나 이메일 또는 소셜 미디어를 통해 연락할 수 있지만, 제 어머니는 프로젝트의 창시자도 기여자도 아님을 명심하십시오.

만족하지 않을 경우 환불해 드리지 않습니다. 도구를 만드는 것만큼이나 사용하는 것을 즐기시길 바랍니다. 노력은 엄청났으며 지금도 엄청납니다 (시간, 지식, 코딩, 테스트, 검토 등) 그러나 우리는 다시 할 것입니다. 지침 및/또는 이 면책 조항을 명확히 읽을 수 없다면 도구를 사용하지 마십시오.

그나저나, 제 어머니를 계속 기억하려는 분들을 위해, 그녀는 몇 년 전에 돌아가셨지만 저는 그녀가 지금 이 자리에 있는 것처럼 사랑합니다.