Sibuna 기술 안내서 1.0.0-beta.3 문서
언어: 한국어
English简体中文한국어日本語EspañolDeutschहिन्दीالعربية
이 페이지의 내용

용어집

요청 허용

요청을 원본 서버로 전달하기로 하는 결정입니다. 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 지문.