시작하기

Quick Start

이 페이지는 처음부터 끝까지 따라 하는 튜토리얼입니다. 위에서 아래로 진행하면 갓 설치한 상태에서 시작해, 캡처한 HTTPS 요청을 살펴보고 Repeater로 보내 편집한 뒤 재전송하는 것까지 터미널을 벗어나지 않고 끝낼 수 있습니다. 10분 정도 잡아 두세요.

각 단계는 확인 항목으로 끝납니다. 다음으로 넘어가기 전에 보여야 하는 상태입니다. 화면이 다르게 보인다면 그 지점에서 멈추고 바로잡으세요.

시작하기 전에. gori를 설치하고 브라우저를 준비하세요. 자신의 브라우징을 캡처하게 되므로, 테스트 권한이 있는 사이트(자신의 앱, 스테이징 서버, 또는 의도적으로 취약하게 만든 연습용 타깃)를 고르세요. 정확한 결과가 필요한 부분에서는 안정적인 일회용 타깃인 example.com을 사용합니다.

1. gori 시작하기 {#1-start-gori}

하위 명령 없이 실행하면 gori는 프록시를 시작하고 인터페이스를 엽니다:

gori

첫 실행 시 짧은 설정 마법사(전역 바인드, 테마, Miss Ring 마스코트)가 실행되고, 이어서 가이드 UI 투어를 제안합니다. 투어는 지금 해도 되고 건너뛰었다가 나중에 돌아와도 됩니다. 이 페이지는 같은 내용을 실제 트래픽으로 다룹니다.

기본적으로 프록시는 127.0.0.1:8070에서 수신합니다. 한 번의 실행에 대해서만 재정의할 수 있습니다(프로젝트 자체 바인드가 설정되어 있으면 여전히 그쪽이 우선합니다):

gori --listen 0.0.0.0 --port 8080

확인. gori TUI가 보입니다. 한쪽에 늘어선 탭들(Project, Target, History, …)과 프록시 주소 127.0.0.1:8070을 보여주는 상단 바입니다.

2. CA 신뢰 후 첫 플로우 캡처 {#2-trust-the-ca-and-capture-your-first-flow}

HTTPS를 읽으려면 클라이언트가 gori의 루트 인증서(첫 실행 시 ~/.gori/ca 아래에 생성됨)를 신뢰해야 합니다. 가장 빠른 길은 사전 신뢰된 브라우저입니다.

Option A: 사전 신뢰된 브라우저 열기 (권장)

TUI 안에서:

1. Ctrl-P를 눌러 커맨드 팔레트를 엽니다.
2. browser를 입력하고 Open browser를 실행합니다.
3. 설치된 브라우저(Chrome, Chromium, Brave, Edge, Firefox, …)를 고릅니다.

gori는 이미 CA를 신뢰하고 HTTP/HTTPS를 프록시로 경유하는 일회용 프로파일로 브라우저를 실행합니다. 그 브라우저에서 사이트를 방문하세요(https://example.com을 먼저, 그다음 테스트 중인 사이트를).

Firefox 참고. CA 자동 신뢰에는 PATH에 있는 certutil(NSS)이 필요합니다. 없으면 gori가 프록시는 설정하지만 Firefox가 CA를 신뢰하지 않아 HTTPS 사이트에서 보안 경고가 뜹니다. 먼저 설치하고(brew install nss macOS, apt install libnss3-tools Debian/Ubuntu, dnf install nss-tools Fedora) 브라우저를 다시 열거나, 같은 창에서 직접 신뢰 등록하세요: about:preferences#privacy를 열고 인증서 보기, 인증기관 탭으로 가서 gori ca가 출력한 파일을 가져오기 하면 됩니다.

Option B: 클라이언트를 직접 지정하기

CA 경로를 출력하고 그 파일을 시스템 또는 브라우저 신뢰 저장소에 신뢰된 루트 CA로 가져오세요:

gori ca

그런 다음 클라이언트가 127.0.0.1:8070을 HTTP 및 HTTPS 프록시로 사용하도록 설정하세요. 다른 터미널에서 간단한 동작 확인:

curl -x http://127.0.0.1:8070 https://example.com

gori는 요청 시 루트로부터 호스트별 리프 인증서를 발급하므로, 루트만 한 번 신뢰하면 됩니다.

gori의 개인 키는 머신 비밀입니다. 0600 권한으로 기록되며 머신을 절대 벗어나지 않습니다. 이전의 모든 신뢰를 무효화할 의도가 있을 때만 팔레트(Regenerate CA certificate)에서 교체하세요.

Option C: 휴대폰이나 태블릿에 CA 설치하기

휴대폰은 파일 시스템에서 CA를 읽을 수 없으므로, gori가 네트워크로 직접 제공합니다.

1. 기기가 접근할 수 있도록 프록시를 바인딩하고 머신의 LAN IP를 확인하세요:

   gori --listen 0.0.0.0 --port 8070
   

2. 기기에서 WiFi의 HTTP 및 HTTPS 프록시를 <LAN-IP>:8070으로 설정합니다.

3. 그 기기의 브라우저에서 **http://gori.proxy/**로 접속합니다(http://gori/도 됩니다).

4. 인증서를 내려받아 신뢰 등록합니다. iOS는 두 단계입니다. 프로파일을 설치한 뒤 설정 → 일반 → 정보 → 인증서 신뢰 설정에서 활성화하세요. Android는 설정 → 보안 → 암호화 및 인증 정보 → 인증서 설치 → CA 인증서에서 설치합니다.

gori.proxy는 gori가 스스로 응답하는 예약된 이름입니다. 프록시를 설정한 뒤에만 동작하며 네트워크로 나가지 않습니다. 프록시를 먼저 설정하고 싶지 않다면 http://<LAN-IP>:8070/으로 바로 접속해도 같은 페이지가 나옵니다.

확인. History로 전환하세요(3). 최소 한 개의 행이 보여야 합니다. 200 상태의 GET https://example.com/ 요청입니다. History가 비어 있다면 캡처가 gori에 도달하지 않는 것입니다. 프록시 설정(Option B)을 다시 확인하거나 Open browser(Option A)를 사용하세요.

3. 두 가지 탐색 표면 익히기 {#3-learn-the-two-discovery-surfaces}

탭별 단축키를 외우기 전에, 거의 모든 것이 있는 두 곳을 먼저 익히세요.

팔레트는 도구 전체의 지도입니다. space 메뉴는 이 패널의 지도입니다. 둘 다 키 힌트를 보여주니, 키 조합이 기억나지 않으면 둘 중 하나를 여세요.

처음부터 알아 두면 좋은 전역 토글 세 가지입니다:

4. TUI 이동하기 {#4-move-around-the-tui}

gori의 화면은 한 줄로 늘어선 탭입니다. 기본 순서는 Project → Target → History → Intercept → Repeater → Fuzzer → … 로 시작합니다.

마우스는 활성화하면(Preferences → Editor & Keys → Editor) 동작합니다. 탭 클릭, 행 클릭으로 선택, 다시 클릭으로 열기. Help 탭은 이 페이지가 열려 있지 않을 때 쓸 수 있는 앱 안의 완전한 키 치트시트입니다.

5. History에서 플로우 읽기 {#5-read-a-flow-in-history}

History가 활성화되어 있는지 확인하세요(3). 모든 요청/응답은 플로우입니다. 시작 줄, 헤더, 본문(최대 2 MiB 저장), 그리고 HTTP/2 프레임, WebSocket 메시지, 존재하면 디코드된 JWT / SAML / GraphQL까지.

다음을 하나씩 해보세요:

/를 누르고 필터를 입력한 뒤 Enter를 누르세요:

host:example.com

History가 그 호스트로 좁혀집니다. 필터를 지우면(/, 지우기, Enter) 다시 전체가 보입니다. 나중에 시도해 볼 몇 가지:

status:5xx
method:POST body:password

이제 example.com 플로우를 선택하고 Enter를 누르세요. 상세 화면에서는 ↑ / ↓로 스크롤하고 y로 복사하며, hex / whitespace / pretty 본문은 x / b / p로 토글합니다. Esc로 목록에 돌아옵니다.

확인. History를 호스트 하나로 필터하고, 플로우를 열어 전체 요청과 응답을 읽을 수 있습니다.

6. Repeater로 보내 재전송하기 (핵심 루프) {#6-send-it-to-repeater-and-re-send-the-core-loop}

대부분의 시간을 보내게 될 루프입니다. 캡처한 요청을 가져와 무언가를 바꾸고, 다시 보내고, 비교합니다.

1. History에서 example.com 플로우를 선택합니다.
2. Ctrl-R을 누릅니다. gori가 플로우를 Repeater 탭으로 복사하고 그쪽으로 전환합니다.
3. 요청 패널에서 Enter 또는 i를 눌러 편집합니다(INS 모드). 작은 것 하나를 바꿔 보세요. 예를 들어 헤더 한 줄을 추가합니다:

   X-Gori-Test: 1
   

4. Esc로 편집 모드를 벗어난 뒤 Ctrl-R로 전송합니다.
5. 응답과 타이밍, 이전 응답 대비 diff가 오른쪽에 나타납니다. Tab으로 target → request → response를 순회합니다.

확인. Repeater 상태 줄에 replayed 200 in … ms 같은 문구가 보이고, Ctrl-R로 원하는 만큼 재전송할 수 있습니다. 이것이 완전한 캡처 → 검사 → 리플레이 루프입니다.

7. 다음으로 갈 곳 {#7-where-to-go-next}

이제 핵심 루프를 갖췄습니다. 여기서부터는 Playbooks가 이어받아, 스코프·매핑·인터셉트·퍼징·리포트를 한 번에 하나씩 체크포인트와 함께 끝까지 안내합니다. 아래는 첫 방향 몇 가지이며, 각각 가이드에서도 깊이 다룹니다:

• 파라미터 퍼징. 플로우를 선택하고 Shift-I로 Fuzzer에 보낸 뒤, 위치를 표시하고(Ctrl-A가 흔한 파라미터를 자동 표시), 워드리스트를 붙이고 Ctrl-R로 실행합니다. Repeater & Fuzzer를 보세요.
• 오가는 도중에 잡아 편집하기. i를 눌러 일치하는 요청을 잡아 두고, 계속 진행되기 전에 forward, drop, 또는 수정합니다. Proxy & History를 보세요.
• 찾은 것 추적하기. 보고할 가치가 있는 것은 Shift-F로 Issue로 만들고, 둘러보는 동안 Probe 탭에서 패시브 결과를 읽으세요. Scanning & Issues를 보세요.

Day-1 키 맵

키 조합이 손에 익을 때까지 이 표를 가까이 두세요:

첫 실행 마법사

가이드 설정(전역 프록시 바인드 기본값, 테마, 그다음 Miss Ring)을 언제든 다시 실행할 수 있습니다:

gori wizard

바인드 단계는 settings.json의 공유 기본값을 설정합니다. Preferences → Network & Tabs → Network와 같은 계층입니다. 프로젝트별 잠금이 아니며, 필요하면 Project 탭에서 평가마다 다른 주소를 고정하세요. 고른 포트에 이미 다른 프로세스가 열려 있으면 이 단계가 알려 주며, Enter를 한 번 더 누르면 그대로 유지합니다. Esc는 두 번 눌러야 마법사를 건너뜁니다(첫 번째는 예고만 하므로 입력 필드에서 실수로 누른 Esc가 설정을 끝내지 않습니다).

마지막 Review 스텝은 선택한 값을 요약하며, 편집 가능한 행이 하나 있습니다 — Shortcuts입니다. ←/→로 gori 내장 키 조합 패밀리(^P ^N ^W ^1-9)의 모디파이어를 Ctrl과 Option (⌥) 사이에서 전환합니다. Option을 고르면 Ctrl을 대체하는 게 아니라 ⌥ 별칭이 추가됩니다 — 터미널이나 멀티플렉서가 Ctrl 형태를 전달하지 않을 때 유용합니다. macOS의 Option-as-Meta 요구사항은 커맨드 모디파이어를 참고하세요.

가이드 UI 투어

탭/패널 이동, 팔레트, space 메뉴, READ/INS 편집 모드를 목업 UI로 따라가는 안내입니다. 실제 프록시 세션 없이 안전하게 실행할 수 있습니다. 각 레슨은 짧은 데모를 보여주고 실제 키를 눌러 보도록 요청하며, 마지막 단계는 네 가지 동작 모두를 직접 해보는 실습 샌드박스와 첫 세션 체크리스트입니다.

gori tutorial

이 투어는 첫 실행 마법사의 마지막에도 제안되며, 세션 안에서는 팔레트 명령 Guided tour(Ctrl-P)로 열 수 있습니다. 끝나면 원래 화면으로 돌아옵니다.

다음 단계

• 설정: 저장소 구조, 네트워크 설정, 그리고 CA
• Proxy & History: 캡처, 인터셉트, 스코프, 가져오기, match & replace
• Repeater & Fuzzer: 테스트 워크벤치와 env 토큰
• Query Language: 전체 필터 문법
• Hotkeys: 위의 키 조합을 원하는 대로 재지정