contexa-core

판정 엔진: 판정은 어떻게 만들어지나

요청이 처리된 뒤 Contexa가 그 요청을 다시 살펴 판정을 만들고 저장하는 과정을 설명합니다. 어떤 요청이 분석되는지, AI 모델이 언제 한 번 더 판정하는지, 모델의 답이 언제 바뀌는지, 판정이 언제부터 적용되고 무엇을 배우는지 알 수 있습니다.

한눈에 보기

판정은 요청을 붙잡아 두고 만드는 것이 아닙니다. 보호 메서드(@Protectable)가 실행된 뒤 뒤에서 만들어져 저장되고, 같은 사용자의 다음 요청부터 적용됩니다. 그 요청 안에서 바로 판정이 필요한 메서드만 @Protectable(sync=true)로 즉시 판정합니다.

판정의 대응(허용 · 추가 인증 · 차단 · 검토 보류)은 AI 모델이 고릅니다. 엔진은 평소와 다른 점, 회사 기록(업무 기록), 과거 판정 같은 사실을 모아 모델에게 보낼 뿐 대응을 정하지 않습니다.

판정 하나가 만들어지는 길1~5는 응답이 나간 뒤에 일어나고, 6은 같은 사용자의 다음 요청에서 일어납니다.
  1. 1
    분석 사건 만들기보호 메서드가 끝나면 요청의 사실을 사건으로 냅니다 (ZeroTrustEventPublisher)
  2. 2
    거르기이 사용자에게 이미 판정이 걸려 있으면 새로 분석하지 않습니다 (ZeroTrustEventListener)
  3. 3
    줄 세우기사용자 · 세션마다 한 줄로 세워 한 번에 하나씩 처리합니다 (SecurityPlaneAgent)
  4. 4
    판정 만들기1차 분석이 판정하고, 정하지 못하면 2차 분석이 다시 판정합니다 (AI 모델)
  5. 5
    집행 · 기록판정을 저장하고, 증거를 봉인하고, 감사 기록을 남깁니다
  6. 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차 분석과 2차 분석2차 분석은 1차가 ESCALATE라고 답했을 때만 실행됩니다.
  1. 사실 모으기세션 흐름, 행위 기준선과 다른 점, 회사 기록, 과거 판정 기록(검색은 먼저 시작해 두고 함께 기다림)
  2. 1차 분석 · Layer 1AI 모델이 판정제한 시간 90초 (contexa.security.tiered.layer1.timeout.llm-ms)
  3. 답이 ESCALATE일 때만 ↓ (그 밖의 답은 그대로 최종 판정)
  4. 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차 판정 100건 가운데 11건 이상이 쌓였고 그중 ESCALATE가 절반을 넘으면, 2차 분석을 부르지 않고 추가 인증으로 끝냅니다. 모델이 모두 "모르겠다"고 답하는 상황에서 2차 분석 호출이 폭증하지 않게 하는 장치입니다. 비율과 건수는 코드에 정해져 있습니다.

층마다 다른 모델 쓰기

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 로그 한 줄이 그 층 · 적어 둔 모델 · 대신 쓰는 모델(백업 모델, 없으면 기본 채팅 모델)을 알리므로 시작 로그를 확인하십시오. 같은 공급자 안의 틀린 모델 이름은 시작할 때 알 수 없고 그 층의 첫 호출에서 실패합니다.

판정 뒤에 하는 일: 다섯 단계

판정이 만들어지면 정해진 순서로 다섯 단계가 이어집니다. 번호는 실행 순서입니다.

처리 단계(핸들러) 순서앞 단계가 실패하면 뒤 단계는 실행되지 않습니다.
  1. 50판정 만들기
  2. 55집행
  3. 56증거 봉인
  4. 60감사
  5. 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)에 판정을 남깁니다. 섀도 모드에서도 남깁니다.판정 결과가 있을 때
65SaaS 전달 (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.modeENFORCE판정을 만들고 적용할지(DISABLED · OBSERVE · SHADOW · ENFORCE)처음 도입할 때 SHADOW로 지켜보다가 ENFORCE로. 집행 모드
contexa.security.tiered.llm.layer1.model
contexa.security.tiered.llm.layer2.model
없음(기본 채팅 모델)층마다 쓸 모델1차는 빠른 모델, 2차는 신중한 모델로 나눌 때
contexa.security.tiered.layer1.timeout.llm-ms900001차 분석 제한 시간(ms)모델이 느려 1차 시간 초과가 잦을 때
contexa.security.tiered.layer2.timeout-ms300002차 분석 제한 시간(ms)2차 모델이 느려 검토 보류가 남을 때
contexa.security.tiered.layer2.escalate-fallback-actionCHALLENGE2차도 검토 보류를 고를 때 바꿀 대응정하지 못한 요청을 더 엄격하게(BLOCK) 다룰 때
contexa.security.plane.agent.event-timeout-ms180000사건 하나를 분석하는 전체 예산(ms)모델 호출이 길어 판정 없이 끝나는 사건이 있을 때
contexa.rag.etl.behavior.retention-days90과거 판정 기록 보관 기간(일)보관 정책이 다를 때

모든 설정은 설정에 있습니다.

운영할 때 알아 둘 것

  • 판정 결과 보기: 판정은 관찰 기록 표(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).