용어집¶
- 요청 허용¶
-
요청을 원본 서버로 전달하기로 하는 결정입니다. Sibuna에서는 유효한 세션,
ALLOW규칙, 정적 우회 경로, 평판allow접두사가 이 결정을 내리며, 어떤 경우에도 WAF의 거부 판정을 뒤집지는 않습니다. - Aho-Corasick 오토마톤¶
-
고정된 패턴 집합에 속한 패턴을 입력을 한 번 훑으며 찾아내는 유한 오토마톤입니다. Sibuna는 실패 링크를 밀집 전이 테이블에 미리 반영해 두므로 바이트마다 테이블을 한 번만 읽습니다.
- 차단 테이블¶
-
차단된 클라이언트 주소와 만료 시각을 담는 락 프리 슬롯 4,096개입니다. 허니팟과 클러스터 전체가 공유하는 평판이 기록하고, 모든 요청이 읽습니다.
- 캠페인¶
-
페이로드 임베딩이 서로 코사인 거리 0.35 이내에 있는 보안 인시던트의 묶음입니다. 휴리스틱에 따른 묶음이며, 출처가 같다는 증명이 아닙니다.
- 챌린지 레코드¶
-
클라이언트가 풀어야 하는 70자 길이의 상태 없는 식별자입니다. 버전, 알고리즘, 난이도, 개방 수, 발급 시각, 클라이언트 지문, PRF nonce, 규칙 해시, 16바이트 키 기반 BLAKE3 태그를 담습니다. 챌린지를 발급해도 서버에는 아무것도 기록되지 않습니다.
- 난이도, 작업 비트¶
-
두 계층의 작업량을 함께 정하는 정수 하나입니다. Hashcash에서는 선행 0비트의 개수이고, 순차 작업에서는 트리 깊이에 3을 더한 값입니다.
- Edge¶
-
--data-dir(노드 하나의 SQLite 파일) 또는--database-url과--cluster-node(클러스터가 공유하는 PostgreSQL 데이터베이스 하나)를 사용하는 Sibuna 배포입니다. 어느 운영 구성에든 영속 정책, 공유 평판, 인시던트 포렌식을 제공합니다. - 엔진 슬롯¶
-
게시된 정책 엔진이 참조 카운트 포인터로 놓이는 자리입니다. 워커는 분류하는 동안 참조를 쥐고 있습니다. 저장소 스레드는 요청 경로 밖에서 새 엔진을 만들어 포인터 교환으로 게시하고, 이전 엔진은 마지막 읽기 측이 참조를 놓을 때 해제됩니다.
- 지문¶
-
클라이언트 주소와 User-Agent의 키 기반 해시입니다. 챌린지와 토큰에 묶여 있으므로 어느 쪽도 다른 클라이언트에서 재전송할 수 없습니다.
- forward-auth¶
-
인그레스가 Sibuna에 요청을 허용할지(
200), 아니면 챌린지를 제시하거나 거부하거나 제한할지(401,403,429) 묻고, 원본 서버로의 프록시는 인그레스가 직접 맡는 배포 모드입니다. - Gate¶
-
작업 증명 기반 요청 허용, 세션, 규칙, 평판, GCRA 제한과 차단을 갖추었지만 애플리케이션 검사는 하지 않는 운영 구성입니다(
--gate). - GCRA¶
-
Generic Cell Rate Algorithm입니다. 클라이언트마다 이론적 도착 시각 하나만 두고, \(N\)개의 버스트를 허용한 뒤 방출 간격마다 요청 하나를 허용합니다. 윈도 경계가 없습니다.
- Hashcash¶
-
첫 번째 계층입니다. 챌린지, 콜론, 십진수 nonce를 이어 붙인 값의 SHA-256이 선행 0비트 \(b\)개를 갖도록 하는 nonce를 찾습니다. 기대 시행 횟수는 \(2^b\)이며, 해시 한 번으로 검증합니다.
- 허니팟¶
-
/__sibuna/honeypot으로 향하는 보이지 않는 링크입니다. 이 링크를 따라간 클라이언트는 차단되고, 평판 \(-100\)인 인시던트가 기록됩니다. - 유휴 연결 회수기¶
-
--idle-timeout보다 오래 아무것도 주고받지 않은 연결을 닫는 스레드입니다. 느린 클라이언트가 연결 스레드를 붙잡아 둘 수 없게 합니다. - 중간 페이지¶
-
보호된 페이지 대신 제공하는 내장 HTML 페이지입니다. 챌린지를 가져와 Web Worker에서 풀고, 풀이를 보낸 뒤 페이지를 다시 불러옵니다.
- JA4¶
-
FoxIO가 정의한, 클라이언트가 TLS 연결을 여는 방식에 대한 36문자 지문입니다. 프로토콜, TLS 버전, 서버 이름, 암호 스위트와 확장의 개수, ALPN, 그리고 정렬한 암호 스위트와 확장의 해시를 담습니다. Sibuna는 이 지문을 계산하지 않습니다. 신뢰할 수 있는 인그레스가
--ja4-header로 지정한 헤더에 담아 전달하는 값을 읽고, 규칙은ja4필드로 이 값을 비교합니다(SID 0014). 챌린지와 토큰에 묶이는 클라이언트 지문과는 관계가 없습니다. - 키 기반 BLAKE3¶
-
Sibuna의 키 스케줄, 챌린지 태그, 세션 태그, 지문, 챌린지 nonce의 바탕이 되는 의사 난수 함수입니다.
- MAC 토큰¶
-
기본 세션 쿠키입니다. 40바이트 페이로드(버전, 작업 수준, 타임스탬프, 만료, 규칙 해시, 지문)와 16바이트 키 기반 BLAKE3 태그로 이루어지며, 상수 시간에 검증합니다.
- 작업 수준¶
-
세션 보유자가 실제로 푼 방식과 작업 비트입니다. 토큰에 담기며, 경로는 세션의 수준이 그 경로의 요구 수준에 이를 때에만 그 세션을 허용합니다.
- 개방¶
-
순차 작업 증명에서 잎 라벨 하나와, 그 잎에서 루트까지의 경로에 있는 형제 라벨입니다. 검증자는 경로를 다시 계산해 커밋먼트와 비교합니다.
- 순차 작업 증명(PoSW)¶
-
두 번째 계층입니다. 라벨이 앞선 모든 라벨에 의존하는 Cohen-Pietrzak 해시 그래프로, 증명자가 코어를 몇 개 가지든 순차 해시 \(2^{n+1}-1\)번을 강제합니다. 검증에는 해시 \(t(n+1)\)번이 듭니다.
- 평판 트라이¶
-
정책 파일과
ip_reputation테이블에서 온allow,deny,challenge접두사를 담는 128비트 기수 트라이입니다. - Robin Hood 사용 완료 집합¶
-
해결된 챌린지 태그를 담는 고정 용량의 개방 주소법 테이블입니다. 유효한 풀이를 두 번 제출하지 못하게 합니다.
- 규칙 해시¶
-
챌린지를 요구한 규칙 이름의 64비트 해시입니다. 챌린지, 토큰,
X-Sibuna-Rule-Hash헤더에 담깁니다. - Shield¶
-
기본 운영 구성입니다. Gate에 의미 기반 방화벽을 더합니다(
--shield). - SID¶
-
Sibuna Discussion 기록입니다.
docs/sid/records아래에 있는 논문 형식의 설계 문서로, 시스템의 한 부분을 뒷받침하는 가정, 증명, 측정을 담습니다. - 운영 구성¶
-
두 가지 제품 형태인 Gate와 Shield 중 하나입니다. 저장소와 클러스터는 어느 쪽에서든 선택할 수 있습니다.
- WEIGH¶
-
즉시 결정하는 대신 요청 점수에 부호 있는 가중치를 더하는 규칙 동작입니다. 합계가 임계값 이상이면 추가 작업 비트로 챌린지를 제시하거나 거부합니다.
- Zaxonlite¶
-
SID 0005의 내장 SQLite 복제 엔진(Multi-Paxos)으로, SID 0011에서 SQLite와 PostgreSQL 저장소로 대체되었습니다. 지금은 그 클러스터 옵션을 지정하면
RemovedOption오류로 시작이 중단됩니다.
참고 문헌¶
- Aho, A. V., and Corasick, M. J. “Efficient string matching: an aid to bibliographic search.” Communications of the ACM 18(6), 1975.
- ATM Forum. Traffic Management Specification Version 4.0, af-tm-0056.000, 1996 (Generic Cell Rate Algorithm).
- Back, A. "Hashcash: a denial of service counter-measure." 기술 보고서, 2002.
- Blocki, J., Lee, S., and Zhou, S. “On the security of proofs of sequential work in a post-quantum world.” Information-Theoretic Cryptography (ITC), 2021.
- Celis, P. Robin Hood Hashing. 박사 학위 논문, University of Waterloo, 1986.
- Cohen, B., and Pietrzak, K. “Simple proofs of sequential work.” EUROCRYPT, 2018.
- Dwork, C., and Naor, M. “Pricing via processing or combatting junk mail.” CRYPTO, 1992.
- Fiat, A., and Shamir, A. “How to prove yourself: practical solutions to identification and signature problems.” CRYPTO, 1986.
- Fielding, R., Nottingham, M., and Reschke, J. HTTP Semantics, RFC 9110 및 HTTP/1.1, RFC 9112. IETF, 2022.
- FoxIO. JA4+ Network Fingerprinting. https://github.com/FoxIO-LLC/ja4, 2023 (JA4 TLS 클라이언트 지문).
- Hanson, N. “libinjection: SQL injection detection by tokenization.” Black Hat USA, 2012.
- Juels, A., and Brainard, J. “Client puzzles: a cryptographic countermeasure against connection depletion attacks.” NDSS, 1999.
- Lamport, L. "The part-time parliament." ACM Transactions on Computer Systems 16(2), 1998 및 "Paxos made simple." ACM SIGACT News 32(4), 2001.
- Mahmoody, M., Moran, T., and Vadhan, S. “Publicly verifiable proofs of sequential work.” Innovations in Theoretical Computer Science (ITCS), 2013.
- O'Connor, J., Aumasson, J.-P., Neves, S., and Wilcox-O'Hearn, Z. BLAKE3: one function, fast everywhere. 명세, 2020.
- Vyukov, D. "Bounded MPMC queue." 1024cores.net, 2011 (인시던트 큐에 쓰는, 시퀀스 번호를 붙인 링).
- Wang, X., Hong, Y., Chang, H., Park, K., Langdale, G., Hu, J., and Zhu, H. “Hyperscan: a fast multi-pattern regex matcher for modern CPUs.” NSDI, 2019.
- Sibuna Discussions 0001부터 0014까지,
docs/sid/records, 2026: 프로세스, 기반 아키텍처, 선언형 정책 엔진, 의미 기반 검사, Zaxonlite 저장소 아키텍처, 수학적 기초, 콘솔 관리 인터페이스, AI 봇 트래픽 모니터링, 청크 요청 본문, Rust 포팅, sqlx를 통한 저장소, rustls를 통한 콘솔의 아웃바운드 TLS, 콘솔 저장소, 인그레스에서 받는 신뢰할 수 있는 JA4 지문.