Flowsint

Flowsint은 윤리적 조사, 투명성 및 검증을 위해 설계된 오픈소스 OSINT 그래프 탐색 도구입니다.

윤리: 책임 있는 사용 지침은 ETHICS.md를 읽어주세요.

https://github.com/user-attachments/assets/eaabfa81-d7b3-414d-8cf7-f69b4e37bab6

https://github.com/user-attachments/assets/7457d94a-cf1d-4a97-949f-f9b1d8d92644

https://github.com/user-attachments/assets/65c3f26e-7132-4853-be45-21b8933688bd

기여하기

Flowsint은 아직 초기 개발 단계이며 커뮤니티의 도움이 절실히 필요합니다! 자유롭게 이슈를 제기하고, 기능을 제안해주세요.

시작하기

읽기 싫으신가요? 알겠습니다. 설치 지침은 다음과 같습니다.

Linux / macOS

1. 사전 요구사항 설치

• Docker
• Make

2. 설치 명령 실행

git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod

Windows

Make가 필요 없습니다. 명령 프롬프트(cmd) 및 PowerShell 모두에서 작동합니다.

1. 사전 요구사항 설치

• Docker Desktop (다음 단계 전에 실행 중인지 확인)
• Git

2. 저장소 복제 및 환경 파일 설정

git clone https://github.com/reconurge/flowsint.git
cd flowsint

copy .env.example .env
copy .env.example flowsint-api\.env
copy .env.example flowsint-core\.env
copy .env.example flowsint-app\.env

3. 시작

docker compose -f docker-compose.prod.yml up -d

이 명령은 GitHub Container Registry에서 미리 빌드된 이미지를 가져옵니다 — 로컬 빌드가 필요 없습니다.

첫 로그인

그런 다음 http://localhost:5173/register로 이동하여 계정을 생성하세요. 기본적으로 제공되는 자격 증명이나 계정은 없습니다.

✅ OSINT 조사는 높은 수준의 프라이버시가 필요합니다. 모든 정보는 사용자 기기에 저장됩니다.

네트워크에 배포 (팀 / 서버)

동일한 설정이 서버에서도 즉시 작동합니다: 프론트엔드가 UI를 제공하고 모든 API 호출을 내부적으로 프록시하므로 클라이언트에 추가 구성이 필요하지 않습니다.

git clone https://github.com/reconurge/flowsint.git
cd flowsint
cp .env.example .env
# .env 편집 — 아래 "네트워크에 노출하기 전" 참조
docker compose -f docker-compose.prod.yml up -d

그러면 네트워크상의 모든 사용자가 http://<서버-ip>:5173에서 Flowsint에 접근할 수 있습니다.

네트워크에 노출하기 전에 .env의 기본 시크릿을 변경하세요:

• AUTH_SECRET — 인증 토큰에 서명합니다. 다음 명령으로 생성: openssl rand -hex 32
• MASTER_VAULT_KEY_V1 — 저장된 API 키를 암호화합니다. 다음 명령으로 생성: python3 -c "import os, base64; print('base64:' + base64.b64encode(os.urandom(32)).decode())"
• NEO4J_PASSWORD — Neo4j 데이터베이스 비밀번호.

또한 서버 호스트 이름/IP를 Host-헤더 허용 목록에 추가하세요 (flowsint-app/nginx.conf에서 map $http_host $is_flowsint_host 부분을 찾으세요). 기본 허용 목록은 localhost / 127.0.0.1 / [::1]만 허용하므로 단일 사용자 설치를 DNS 리바인딩으로부터 보호합니다. LAN 및 공개 배포 시 자체 호스트 이름을 추가해야 합니다. 동일한 map 블록에 주석 처리된 두 개의 템플릿 줄에 형식이 나와 있습니다.

포트 5173만 네트워크에 노출됩니다. PostgreSQL, Redis, Neo4j 및 API는 서버의 127.0.0.1에 바인딩되어 있으며 프론트엔드 프록시를 통해서만 접근할 수 있습니다.

latest 대신 특정 버전을 고정하려면 .env에서 FLOWSINT_VERSION을 설정하세요 (예: FLOWSINT_VERSION=1.2.10).

HTTPS (신뢰할 수 있는 LAN 이상의 경우 권장): 포트 5173 앞에 리버스 프록시를 두세요. Caddy를 사용한 예:

flowsint.example.com {
    reverse_proxy 127.0.0.1:5173
}

리버스 프록시를 사용하는 경우 docker-compose.prod.yml에서 앱 포트도 localhost로 바인딩하세요 ("127.0.0.1:5173:8080"). 그래야 클라이언트가 HTTPS를 통해서만 접근할 수 있습니다.

이게 뭔가요?

Flowsint는 정찰 및 OSINT(오픈소스 인텔리전스)에 중점을 둔 그래프 기반 조사 도구입니다. 시각적 그래프 인터페이스와 자동화된 정보 수집기를 통해 엔터티 간의 관계를 탐색할 수 있습니다.

사용 가능한 정보 수집기

도메인 수집기

• 역방향 DNS 확인 - IP 주소를 가리키는 도메인 찾기
• DNS 확인 - 도메인을 IP 주소로 변환
• 서브도메인 검색 - 서브도메인 열거
• WHOIS 조회 - 도메인 등록 정보 가져오기
• 도메인을 웹사이트로 - 도메인을 웹사이트 엔터티로 변환
• 도메인을 루트 도메인으로 - 루트 도메인 추출
• 도메인을 ASN으로 - 도메인과 연결된 ASN 찾기
• 도메인 기록 - 과거 도메인 데이터 검색

IP 수집기

• IP 정보 - 지리적 위치 및 네트워크 세부 정보 가져오기
• IP를 ASN으로 - IP에 대한 ASN 찾기

ASN 수집기

• ASN을 CIDR로 - ASN에 대한 IP 범위 가져오기

CIDR 수집기

• CIDR을 IP로 - 범위 내 IP 열거

소셜 미디어 수집기

• Maigret - 소셜 플랫폼에서 사용자 이름 검색

조직 수집기

• 조직을 ASN으로 - 조직이 소유한 ASN 찾기
• 조직 정보 - 회사 세부 정보 가져오기
• 조직을 도메인으로 - 조직이 소유한 도메인 찾기

암호화폐 수집기

• 지갑을 트랜잭션으로 - 거래 내역 가져오기
• 지갑을 NFT로 - 지갑이 소유한 NFT 찾기

웹사이트 수집기

• 웹사이트 크롤러 - 웹사이트 구조 크롤링 및 매핑
• 웹사이트를 링크로 - 모든 링크 추출
• 웹사이트를 도메인으로 - URL에서 도메인 추출
• 웹사이트를 웹트래커로 - 추적 스크립트 식별
• 웹사이트를 텍스트로 - 텍스트 콘텐츠 추출

이메일 수집기

• 이메일을 Gravatar로 - Gravatar 프로필 찾기
• 이메일을 유출 정보로 - 데이터 유출 데이터베이스 확인
• 이메일을 도메인으로 - 연결된 도메인 찾기

전화번호 수집기

• 전화번호를 유출 정보로 - 유출 정보에서 전화번호 확인

개인 수집기

• 개인을 조직으로 - 조직 소속 정보 찾기
• 개인을 도메인으로 - 개인과 연결된 도메인 찾기

통합 수집기

• N8n 커넥터 - N8n 워크플로우에 연결

프로젝트 구조

프로젝트는 자율 모듈로 구성됩니다:

핵심 모듈

• flowsint-core: 핵심 유틸리티, 오케스트레이터, 볼트, Celery 작업 및 기본 클래스
• flowsint-types: Pydantic 모델 및 유형 정의
• flowsint-enrichers: 수집기 모듈, 스캐닝 로직 및 도구
• flowsint-api: FastAPI 서버, API 라우트 및 스키마만 포함
• flowsint-app: 프론트엔드 애플리케이션

모듈 의존성

flowsint-app (프론트엔드)
    ↓
flowsint-api (API 서버)
    ↓
flowsint-core (오케스트레이터, 작업, 볼트)
    ↓
flowsint-enrichers (수집기 및 도구)
    ↓
flowsint-types (유형)

개발 환경 설정

사전 요구사항

• Docker

실행

Linux / macOS (Make 필요):

make dev

Windows (cmd 또는 PowerShell, Make 불필요 — 먼저 .env 파일을 생성하세요. 시작하기 참조):

docker compose -f docker-compose.dev.yml up -d --build
docker compose -f docker-compose.dev.yml logs -f

개발

앱은 http://localhost:5173에서 접근 가능합니다.

모듈 세부 사항

flowsint-core

다른 모든 모듈에서 사용하는 핵심 유틸리티 및 기본 클래스:

• 데이터베이스 연결 (PostgreSQL, Neo4j)
• 인증 및 권한 부여
• 로깅 및 이벤트 처리
• 구성 관리
• 수집기 및 도구의 기본 클래스
• 유틸리티 함수

flowsint-types

모든 데이터 유형에 대한 Pydantic 모델:

• 도메인, IP, ASN, CIDR
• 개인, 조직, 이메일, 전화번호
• 웹사이트, 소셜 프로필, 자격 증명
• 암호화폐 지갑, 트랜잭션, NFT
• 그 외 다수...

flowsint-enrichers

데이터를 처리하는 수집기 모듈:

• 도메인 수집기 (서브도메인, WHOIS, 확인)
• IP 수집기 (지리적 위치, ASN 조회)
• 소셜 미디어 수집기 (Maigret, Sherlock)
• 이메일 수집기 (유출 정보, Gravatar)
• 암호화폐 수집기 (트랜잭션, NFT)
• 그 외 다수...

flowsint-api

FastAPI 서버 제공:

• REST API 엔드포인트
• 인증 및 사용자 관리
• 그래프 데이터베이스 통합
• 실시간 이벤트 스트리밍

flowsint-app

프론트엔드 애플리케이션.

• 현대적이고 UI 친화적인 인터페이스
• 성능에 최적화 (수천 개의 노드에서도 지연 없음)

개발 워크플로우

1. 새 유형 추가: flowsint-types 모듈에 추가
2. 새 수집기 추가: flowsint-enrichers 모듈에 추가
3. 새 API 엔드포인트 추가: flowsint-api 모듈에 추가
4. 새 유틸리티 추가: flowsint-core 모듈에 추가

테스트

각 모듈에는 자체 (완전하지 않은) 테스트 스위트가 있습니다:

# 코어 모듈 테스트
cd flowsint-core
uv run pytest

# 유형 모듈 테스트
cd ../flowsint-types
uv run pytest

# 수집기 모듈 테스트
cd ../flowsint-enrichers
uv run pytest

# API 모듈 테스트
cd ../flowsint-api
uv run pytest

기여하기

1. 모듈 구조를 따르세요
2. 의존성 관리를 위해 Poetry를 사용하세요
3. 새 기능에 대한 테스트를 작성하세요
4. 필요에 따라 문서를 업데이트하세요

⚖️ 법적 및 윤리적 사용

윤리: 책임 있는 사용 지침은 ETHICS.md를 읽어주세요.

Flowsint은 법적이고 윤리적인 조사 및 연구 목적으로만 설계되었습니다.

다음과 같은 사람들을 돕기 위해 만들어졌습니다:

• 사이버보안 연구원 및 분석가
• 저널리스트 및 OSINT 조사관
• 법 집행 기관 또는 사기 조사 팀
• 내부 위협 인텔리전스 또는 디지털 위험 분석을 수행하는 조직

Flowsint은 다음 용도로 사용해서는 안 됩니다:

• 무단 침입, 감시 또는 데이터 수집
• 괴롭힘, 신상 털기 또는 개인 표적화
• 정치적 조작, 허위 정보 또는 개인정보 보호법 위반

이 소프트웨어의 오용은 엄격히 금지되며 ETHICS.md에 정의된 윤리 원칙에 위배됩니다.

❤️ 지원