판정 엔진: 판정은 어떻게 만들어지나
요청이 처리된 뒤 Contexa가 그 요청을 다시 살펴 판정을 만들고 저장하는 과정을 설명합니다. 어떤 요청이 분석되는지, AI 모델이 언제 한 번 더 판정하는지, 모델의 답이 언제 바뀌는지, 판정이 언제부터 적용되고 무엇을 배우는지 알 수 있습니다.
한눈에 보기
판정은 요청을 붙잡아 두고 만드는 것이 아닙니다. 보호 메서드(@Protectable)가 실행된 뒤 뒤에서 만들어져 저장되고, 같은 사용자의 다음 요청부터 적용됩니다. 그 요청 안에서 바로 판정이 필요한 메서드만 @Protectable(sync=true)로 즉시 판정합니다.
판정의 대응(허용 · 추가 인증 · 차단 · 검토 보류)은 AI 모델이 고릅니다. 엔진은 평소와 다른 점, 회사 기록(업무 기록), 과거 판정 같은 사실을 모아 모델에게 보낼 뿐 대응을 정하지 않습니다.
- 1분석 사건 만들기보호 메서드가 끝나면 요청의 사실을 사건으로 냅니다 (
ZeroTrustEventPublisher) - 2거르기이 사용자에게 이미 판정이 걸려 있으면 새로 분석하지 않습니다 (
ZeroTrustEventListener) - 3줄 세우기사용자 · 세션마다 한 줄로 세워 한 번에 하나씩 처리합니다 (
SecurityPlaneAgent) - 4판정 만들기1차 분석이 판정하고, 정하지 못하면 2차 분석이 다시 판정합니다 (AI 모델)
- 5집행 · 기록판정을 저장하고, 증거를 봉인하고, 감사 기록을 남깁니다
- 6다음 요청에 적용저장된 판정이 그 사용자의 권한을 바꿉니다 (요청 시점 집행)
어떤 요청이 분석되나
모든 요청이 AI 모델에게 가지는 않습니다. 아래 표에서 "분석"이라고 된 경우만 판정을 만듭니다.
| 경우 | 어떻게 되나 |
|---|---|
| 보호 메서드 호출(기본) | 메서드를 실행한 뒤 분석합니다. 메서드는 판정을 기다리지 않습니다. |
즉시 판정 메서드(@Protectable(sync=true)) | 그 요청 안에서 같은 엔진으로 바로 판정합니다. 줄 세우기를 거치지 않습니다. |
집행 모드가 끔 · 관찰(DISABLED · OBSERVE)이거나 contexa.security.zerotrust.enabled=false | 분석하지 않습니다. AI 모델을 부르지 않습니다. |
| 이 사용자에게 차단 · 추가 인증 · 검토 보류가 걸려 있음 | 메서드 실행 전에 거부하고 분석하지 않습니다. |
| 저장된 판정이 아직 살아 있음(분석 대기가 아님) | 새로 분석하지 않고 "분석하지 않은 요청"으로만 기록합니다. |
| 같은 사용자가 같은 범위를 5초 안에 다시 호출 | 통과시키되 분석하지 않습니다(contexa.security.zerotrust.protectable.rapid-reentry-window-ms, 기본 5000). |
| 인가 정책(XACML · URL)이 거부 | 분석하지 않고 세션 사실로만 기록합니다. |
| 같은 사건이 두 번 처리되려 함(여러 서버, 다시 줄 서기) | 사건마다 처리 권리를 한 번만 잡습니다(테넌트 · 사용자 · 맥락 · 사건 · 자원 · 메서드로 만든 식별자). 이미 처리됐거나 다른 곳에서 처리 중인 사건은 건너뜁니다. |
| 한 에이전트가 같은 요청을 한꺼번에 보냄 | 판정 통합을 켜면 같은 질문은 한 번만 분석합니다(기본 꺼짐). |
판정이 만들어지는 순서: 1차 분석과 2차 분석
판정은 두 단계로 만들어집니다. 대부분은 1차 분석에서 끝나고, 1차가 "이 사실로는 정할 수 없다(ESCALATE)"고 답한 요청만 2차 분석으로 갑니다.
- 사실 모으기세션 흐름, 행위 기준선과 다른 점, 회사 기록, 과거 판정 기록(검색은 먼저 시작해 두고 함께 기다림)
- 1차 분석 · Layer 1AI 모델이 판정제한 시간 90초 (
contexa.security.tiered.layer1.timeout.llm-ms) - 답이 ESCALATE일 때만 ↓ (그 밖의 답은 그대로 최종 판정)
- 2차 분석 · Layer 2같은 요청을 다시 판정1차의 프롬프트와 첫 판정을 받아 다시 묻습니다. 제한 시간 30초 (
contexa.security.tiered.layer2.timeout-ms)
최종 판정
- 허용ALLOW
- 추가 인증CHALLENGE
- 차단BLOCK
- 검토 보류ESCALATE
과거 판정 기록은 두 가지로 함께 찾고, 둘 다 PAST RECORDS 블록에 그립니다.
| 찾는 법 | 1차 분석 | 2차 분석 |
|---|---|---|
| 정확 조회 | 같은 행동에 대한 그 사람의 허용 기록을 같은 대상 먼저 · 최신 먼저, 임베딩 없이 조회(PastRecord 줄) | 1차가 찾은 기록을 그대로 쓰고, 없을 때만 다시 조회 |
| 유사도 검색 | 뜻이 비슷한 기록을 최대 12건(contexa.security.tiered.layer1.vector-search-limit), 관련도 0.5 이상(layer1.rag.similarity-threshold), SimilarCase 줄로 그림. "유사 사례 읽는 법" 부분을 지운 프롬프트 버전은 이 검색을 끔 | 1차가 찾은 기록을 그대로 쓰고, 없을 때만 다시 찾습니다(최대 5건 layer2.rag-top-k, 관련도 0.5 이상) |
층마다 다른 모델 쓰기
1차와 2차에 서로 다른 모델을 쓸 수 있습니다. 예를 들어 1차는 빠르고 싼 모델, 2차는 더 신중한 모델로 둡니다.
contexa:
security:
tiered:
llm:
layer1:
model: gpt-4o-mini # 비우면 기본 채팅 모델
layer2:
model: gpt-4o # 비우면 기본 채팅 모델
위 예는 기본 채팅 모델이 OpenAI일 때 그대로 동작합니다(같은 공급자 안에서 이름만 바꿈).
- 모델을 고르는 순서: 그 층의 모델 → (있으면) 그 층의 백업 모델(
layerN.backup.model) → 기본 채팅 모델. - 모델 이름에 맞는 연결 설정(
contexa.llm.bindings.chat)이 없으면 기본 채팅 모델을 복사해 이름만 바꿔 씁니다. 이 복사는 OpenAI(mutate())와 Anthropic(Contexa가 같은 클라이언트와 기본 옵션으로 다시 만듦) 채팅 모델에서 됩니다. Ollama처럼 복사할 수 없는 모델은 연결 설정을 따로 두어야 합니다. - 층 모델을 만들 수 없어도 애플리케이션은 시작합니다. 시작할 때 ERROR 로그 한 줄이 그 층 · 적어 둔 모델 · 대신 쓰는 모델(백업 모델, 없으면 기본 채팅 모델)을 알리므로 시작 로그를 확인하십시오. 같은 공급자 안의 틀린 모델 이름은 시작할 때 알 수 없고 그 층의 첫 호출에서 실패합니다.
판정 뒤에 하는 일: 다섯 단계
판정이 만들어지면 정해진 순서로 다섯 단계가 이어집니다. 번호는 실행 순서입니다.
- 50판정 만들기
- 55집행
- 56증거 봉인
- 60감사
- 65SaaS 전달
| 순서 | 단계 | 하는 일 | 언제 실행되나 |
|---|---|---|---|
| 50 | 판정 만들기 (ProcessingExecutionHandler) | 1차 · 2차 분석으로 판정을 만듭니다. | 항상. 채팅 모델 · 벡터 저장소가 없으면 판정을 만들지 못해 사용자는 분석 대기로 남습니다. |
| 55 | 집행 (SecurityDecisionEnforcementHandler) | 감사용 관찰 기록을 먼저 쓰고, 집행 모드면 판정을 저장합니다. 차단이면 진행 중인 응답을 끊는 신호를 보냅니다. | 판정 결과가 있을 때 |
| 56 | 증거 봉인 (SealedEvidenceCaptureHandler) | 모델에 보낸 그대로의 프롬프트와 판정을 봉인합니다. 판정은 바꾸지 않습니다. 기본은 서버가 뜬 뒤와 판정이 쓰는 버전이 바뀐 뒤 1,000건은 모두, 그 밖에는 1%를 봉인하고 90일 보관합니다. 봉인 증거와 공식 검증 | AI 모델이 판정한 경우(contexa.pqa.oss.sealed-evidence.capture-enabled, 기본 켜짐) |
| 60 | 감사 (AuditingHandler) | 감사 기록(ctxa_audit_log)에 판정을 남깁니다. 섀도 모드에서도 남깁니다. | 판정 결과가 있을 때 |
| 65 | SaaS 전달 (SaasForwardingHandler) | 허용 · 분석 대기가 아닌 판정을 Contexa SaaS로 보낼 상자에 담습니다. Contexa SaaS 연결 | contexa.saas.enabled=true일 때만(기본 꺼짐) |
판정이 저장되고 적용되는 방법
집행 모드(ENFORCE)에서 판정은 사용자 판정 저장소에 저장됩니다. 저장소는 단독 모드에서는 메모리, 분산 모드에서는 Redis입니다. 판정마다 유효 시간이 정해져 있습니다.
| 판정 | 유효 시간 | 어디에 적용되나 |
|---|---|---|
| 허용(ALLOW) | 15분(contexa.security.zerotrust.allow-validity로 바꿈) | 판정이 만들어진 같은 세션 · IP · 브라우저에서만 |
| 추가 인증(CHALLENGE) | 1,800초(30분) | 그 사용자의 모든 세션 |
| 검토 보류(ESCALATE) | 300초(5분) | 그 사용자의 모든 세션 |
| 차단(BLOCK) | 기한 없음(관리자가 풀거나 차단 해제 MFA를 거칠 때까지) | 그 사용자의 모든 세션 |
| 분석 대기(PENDING_ANALYSIS) | 저장된 판정이 없는 상태 | 요청은 통과하고 분석이 시작됩니다 |
- 더 엄격한 판정은 약한 판정에 덮이지 않습니다. 차단 > 검토 보류 > 추가 인증 순서로, 이미 더 엄격한 판정이 걸려 있으면 약한 새 판정은 저장하지 않습니다.
- 섀도 모드(
SHADOW)에서는 저장하지 않습니다. 감사용 관찰 기록만 남기고, 차단 신호 · 학습도 하지 않습니다. - 사건은 만들어질 때의 집행 모드를 지니고 다닙니다(
decisionBoundaryMode). 섀도 모드에서 만들어진 사건은, 판정이 나올 무렵 집행 모드가ENFORCE로 바뀌었어도 집행하지 않습니다. - 감사용 관찰 기록(DB)을 쓰지 못하면 집행하지 않습니다. 판정은 분석 대기로 남고, 같은 맥락의 새 분석은 30초 멈춥니다(
contexa.security.zerotrust.analysis.audit-failure-cooldown-ms).
저장된 판정이 다음 요청에서 권한을 어떻게 바꾸는지는 요청 시점 집행에서 설명합니다.
모델의 답이 바뀌는 경우
모델이 고른 대응은 아래 경우가 아니면 그대로 최종 판정이 됩니다.
| 경우 | 최종 판정 |
|---|---|
| 모델의 답을 받지 못함(공급자 장애, 호출 시간 초과, 출력 · 컨텍스트 한도 초과) | 추가 인증. 1차에서 일어나도 2차로 넘기지 않습니다. |
| 대응 값이 없거나 알 수 없는 값 | 추가 인증. 단 DENY 계열은 차단, REVIEW는 검토 보류로 읽습니다. |
| 답의 형식이 계약에 맞지 않고, 한 번 고쳐 묻고도 그대로임 | 검토 보류(1차라면 2차로 넘어감). 준비된 부분 "판정 규칙"을 넣은 프롬프트 버전에서는 여전히 어긴 경계가 정한 대응(차단이나 허용)이 됩니다. |
| 1차 분석 자체가 실패(결과 없음, 1차 제한 시간 초과) | 검토 보류로 바꿔 2차 분석으로 넘깁니다. |
| 2차 분석이 검토 보류(ESCALATE)를 고름 | contexa.security.tiered.layer2.escalate-fallback-action(기본 CHALLENGE)으로 바꿉니다. |
| 2차 분석이 기술적으로 실패(예외, 30초 초과) | 검토 보류가 최종 판정으로 저장됩니다(5분). |
| 과부하 보호 조건(위 상자) | 추가 인증 |
최소 대응 규칙을 집행 모드(contexa.security.zerotrust.minimum-action.mode=ENFORCE)로 켰고 답이 하한보다 약함 | 한 번 고쳐 묻고, 그래도 약하면 검토 보류. 기본값 OBSERVE는 기록만 합니다. |
무엇을 배우나
판정 엔진은 판정 결과로 두 가지를 배웁니다: 사람마다의 행위 기준선(평소 일하는 시간 · 단말 · 네트워크 · 대상 등)과 과거 판정 기록입니다. 둘 다 다음 분석에서 프롬프트의 사실이 됩니다.
- 실제로 적용된 허용 판정만 기준선에 배웁니다. 섀도 모드의 판정, 더 엄격한 판정이 걸려 있어 저장되지 않은 허용, 삭제된 계정의 늦은 결과는 배우지 않습니다. 학습은 지수 이동 평균(계수 0.1)이고, 사람의 요청이면 조직 기준선도 함께 갱신합니다.
- 기준선이 "확립"되는 조건: 개인 기준선은 학습한 요청이 20건 이상, 서로 다른 날이 5일 이상, 최근 10번의 학습에서 처음 보는 값이 20% 이하일 때입니다. 조직 기준선은 3명 이상의 요청에서 배워야 확립됩니다. IP 대역처럼 값을 여러 개 기억하는 항목은 자리가 차면 가장 덜 쓰인 값을 밀어냅니다(오래된 값은 반감기 14일로 덜 셉니다).
- 설명 안 된 새 값은 바로 배우지 않고 보류합니다. 민감 등급 이상의 자원에서 시간 · 요일 · 네트워크 · 단말 가운데 설명되지 않는 차이가 있으면 보류했다가, 같은 값이 2일 이상에 걸쳐 2번 이상 보이거나 검증되면 배웁니다. 에이전트는 자원 등급과 상관없이 처음 보는 값을 보류합니다.
- 확인을 거친 요청도 배웁니다. 추가 인증 · 검토 보류 · 차단으로 막힌 요청은 보관했다가, 사용자가 MFA를 통과하거나 관리자가 차단을 풀면 가중치 0.5로 배웁니다.
- 과거 판정 기록은 실제로 적용된 판정만 벡터 저장소에 저장하고, 90일(
contexa.rag.etl.behavior.retention-days)이 지난 기록은 매일 03:45에 지웁니다. 0 이하로 두면 지우지 않습니다. - 행위 기준선은 마지막 학습 뒤 30일(
contexa.security.zerotrust.baseline.retention) 동안 새 학습이 없으면 지웁니다.
자주 바꾸는 설정
| 설정 | 기본값 | 뜻 | 언제 바꾸나 |
|---|---|---|---|
contexa.security.zerotrust.mode | ENFORCE | 판정을 만들고 적용할지(DISABLED · OBSERVE · SHADOW · ENFORCE) | 처음 도입할 때 SHADOW로 지켜보다가 ENFORCE로. 집행 모드 |
contexa.security.tiered.llm.layer1.modelcontexa.security.tiered.llm.layer2.model | 없음(기본 채팅 모델) | 층마다 쓸 모델 | 1차는 빠른 모델, 2차는 신중한 모델로 나눌 때 |
contexa.security.tiered.layer1.timeout.llm-ms | 90000 | 1차 분석 제한 시간(ms) | 모델이 느려 1차 시간 초과가 잦을 때 |
contexa.security.tiered.layer2.timeout-ms | 30000 | 2차 분석 제한 시간(ms) | 2차 모델이 느려 검토 보류가 남을 때 |
contexa.security.tiered.layer2.escalate-fallback-action | CHALLENGE | 2차도 검토 보류를 고를 때 바꿀 대응 | 정하지 못한 요청을 더 엄격하게(BLOCK) 다룰 때 |
contexa.security.plane.agent.event-timeout-ms | 180000 | 사건 하나를 분석하는 전체 예산(ms) | 모델 호출이 길어 판정 없이 끝나는 사건이 있을 때 |
contexa.rag.etl.behavior.retention-days | 90 | 과거 판정 기록 보관 기간(일) | 보관 정책이 다를 때 |
모든 설정은 설정에 있습니다.
운영할 때 알아 둘 것
- 판정 결과 보기: 판정은 관찰 기록 표(
ctxa_ai_security_decision_observation)와 감사 기록에 남고, Zero Trust 콘솔의 판정 기록(/contexa/admin/zero-trust/decisions)과 관리 콘솔의 보안 이벤트 기록(/contexa/admin/security-monitor)에서 봅니다. - 판정이 나오지 않고 계속 분석 대기라면 먼저 확인합니다: 집행 모드가
OBSERVE·DISABLED가 아닌지, 채팅 모델과 벡터 저장소 빈이 있는지, 감사용 관찰 기록 DB에 쓸 수 있는지. - 분석 대기열은 10,000건까지입니다(
contexa.security.plane.monitor.queue-size). - 사건 하나의 예산은 180초입니다. 분석 스레드 풀(기본 코어 32 · 최대 64 · 대기 256)에서 60초 넘게 기다리거나 예산을 넘기면 판정 없이 끝나고, 최대 3번 다시 줄을 섭니다.
- 분산 모드(
contexa.infrastructure.mode=distributed)에서는 사건을 Kafka 토픽ctxa.<앱 이름>.security.events.<범주>.<유형>(예:ctxa.order-service.security.events.authorization.method. 앱 이름은spring.application.name이고, 이름이 없으면 접두사는ctxa.뿐입니다)으로 보내고, 처리하지 못한 사건은 DLQ 토픽(ctxa.<앱 이름>.security-events-dlq, 또는contexa.security.kafka.topic.dlq로 지정한 이름)으로 보냅니다. contexa.security.tiered.layer2.enable-soar는 현재 OSS에서 효과가 없습니다. 차단 판정에 붙일 플레이북을 채우는 코드가 없어 SOAR가 실행되지 않습니다(SOAR).