Starfort | 사용 매뉴얼 | 로그프레소 스토어

AIM Starfort 앱은 AIM Intelligence의 Starfort Guard API로 텍스트의 개인정보를 검사합니다. Starfort는 검사 결과로 다음 세 가지 판정 중 하나를 돌려줍니다.

판정	의미	처리
PASS	개인정보가 없거나 테스트용 값입니다	원문을 그대로 사용합니다
MASK	개인정보가 있어 가렸습니다	`processed_content`(마스킹된 내용)를 원문 대신 사용합니다
BLOCK	보내면 안 되는 내용입니다	사용하지 않고 중단합니다

판정을 받지 못한 경우(HTTP 4xx, 5xx, 시간 초과)는 통과가 아닙니다. 앱은 이 경우를 항상 오류로 처리합니다.

사전 준비

유형이 AIM Starfort인 접속 프로파일이 등록되어 있어야 합니다. 등록 절차는 설치 매뉴얼을 참고하십시오.

앱은 세 가지 방법으로 사용합니다.

방법	용도	매뉴얼
가드레일 테스트 화면	메시지를 직접 보내 판정과 탐지 결과를 확인합니다	가드레일 테스트
AI 에이전트 가드레일	AI 에이전트가 모델과 주고받는 내용을 자동으로 검사하고 마스킹하거나 차단합니다	AI 에이전트 가드레일
쿼리 명령어	텍스트나 로그 레코드를 쿼리에서 검사합니다	쿼리 명령어

Starfort는 개인정보 유형에 따라 다른 형태로 가립니다.

유형	원문	마스킹 결과
휴대전화번호	`010-1234-5678`	`010-****-5678` (가운데 자리만 가림)
이메일	`hong.gildong@example.co.kr`	`[EMAIL_1]` (분류 이름으로 바꿈)

010-0000-0000, test@test.com처럼 테스트용으로 흔히 쓰는 값은 PASS로 처리됩니다.

Note

Starfort 응답에는 탐지된 원문(matched_text, original_text)이 함께 들어 있습니다. 가드레일 테스트 화면, 쿼리 명령어 결과, AI 에이전트의 가드레일 감사 로그에도 원문이 표시되므로 조회 권한을 관리하십시오.

페이지	내용
가드레일 테스트	검사 요청 입력, 응답 패널, 오류별 조치
AI 에이전트 가드레일	검사 대상, 마스킹과 복원, 실패 처리, 실행 세부 단계, 가드레일 감사 로그
쿼리 명령어	`starfort-guard`, `starfort-guard-batch`

처음 사용하는 경우 가드레일 테스트에서 판정이 정상적으로 돌아오는지 먼저 확인하십시오.