설치 매뉴얼
AIM Starfort 앱은 AIM Intelligence의 Starfort Guard API로 개인정보를 검사합니다. AI 에이전트가 모델로 보내는 내용을 검사해 마스킹하거나 차단하는 가드레일로 동작하고, 화면과 쿼리 명령어로 직접 검사할 수도 있습니다. 앱만 설치해서는 동작하지 않으며 아래 항목이 함께 갖춰져야 합니다.
Note
- AIM Intelligence에서 발급받은 Starfort API 키(
sf_로 시작)가 있어야 합니다. - 로그프레소 서버에서 Starfort Guard API 엔드포인트로 HTTPS 접속이 가능해야 합니다. 직접 접속할 수 없으면 HTTP 프록시를 지정합니다.
- AI 에이전트 가드레일로 사용하려면 AI 어시스턴트 또는 에이전틱 SOC 앱 1.13 이상이 설치되어 있어야 합니다. 가드레일 테스트 화면과 쿼리 명령어는 AI 에이전트 앱 없이도 사용할 수 있습니다.
순서대로 진행하십시오.
1. 앱 설치
앱 스토어에서 AIM Starfort를 설치합니다.
설치가 끝나면 좌측 메뉴에 가드레일 테스트가 나타나고, 접속 프로파일 유형에 AIM Starfort가 추가됩니다.
2. 접속 프로파일 등록
로그프레소에서 유형이 AIM Starfort인 접속 프로파일을 추가합니다.
| 항목 | 필수 | 설명 |
|---|---|---|
| 엔드포인트 | 예 | Starfort Guard API 기본 URL입니다. 기본값은 https://bastion-guardian-api.starfort.io이며, 호출할 때 /v1/guard/api를 붙입니다 |
| API 키 | 예 | X-Starfort-Guard-Api-Key 헤더로 보내는 값입니다. 암호화되어 저장됩니다 |
| 접속 타임아웃 | 아니오 | 초 단위, 1~300. 미지정 시 10초 |
| 읽기 타임아웃 | 아니오 | 초 단위, 1~300. 미지정 시 30초 |
| HTTP 프록시 | 아니오 | IP:포트 형식 |
저장 후 연결 테스트를 실행합니다. 개인정보가 없는 짧은 문장으로 검사를 요청하여 HTTP 200과 판정이 돌아오는지 확인합니다. 실패하면 오류 코드와 Starfort의 X-Request-ID가 표시됩니다.
Note
AI 에이전트 가드레일은 AIM Starfort 접속 프로파일 중 식별자 순으로 첫 번째 프로파일을 사용합니다. 화면에서 선택하는 기능은 없으므로, 가드레일로 사용할 Starfort 하나에 대해 하나의 프로파일을 등록하십시오.
3. 설치 확인
가드레일 테스트 메뉴에서 검사가 실제로 동작하는지 확인합니다.
- 접속 프로파일을 선택합니다
- 예시 중 휴대폰 번호 (MASK) 버튼을 클릭합니다
- 검사 요청을 클릭합니다
- 판정이 MASK이고,
processed_content에010-****-5678처럼 가운데 자리가 가려진 번호가 표시되면 정상입니다
AI 에이전트 가드레일로 사용하는 경우 AI 에이전트 메뉴의 가드레일 탭에서 오른쪽 위 톱니바퀴를 클릭합니다. AIM Starfort가 준비됨으로, 사용 중인 접속 프로파일과 함께 표시되면 가드레일이 켜진 상태입니다.
4. 사내 환경 전환
테스트를 마치고 사내 환경으로 옮긴 뒤에는 접속 프로파일의 엔드포인트와 API 키를 사내 값으로 변경합니다. 판정 처리 방식은 그대로입니다. 변경 후 연결 테스트와 3의 확인 절차를 다시 실행하십시오.
문제가 발생할 때
| 증상 | 원인 | 조치 |
|---|---|---|
217400 접속 프로파일 없음 | AIM Starfort 접속 프로파일이 없음 | 2의 절차로 접속 프로파일을 등록합니다 |
217401 API 키 없음 | 접속 프로파일에 API 키가 비어 있음 | API 키를 입력합니다. 앞뒤 공백과 줄바꿈이 없는지 확인합니다 |
217402 엔드포인트 형식 오류 | URL이 http 또는 https가 아님 | https://로 시작하는 주소를 입력합니다 |
217404 프록시 형식 오류 | HTTP 프록시가 IP:포트 형식이 아님 | 예) 10.0.0.1:3128 |
217411 HTTP 401 (API_KEY_INVALID) | API 키가 잘못되었거나 사용 기간이 지남 | 헤더 값과 사용 기간을 AIM Intelligence에 확인합니다 |
217412 HTTP 403 | 접근이 제한됨 | AIM Intelligence에 문의합니다 |
217414 HTTP 5xx | 검사 엔진이 판정을 내지 못함 | 잠시 후 다시 시도하고, 계속되면 X-Request-ID와 함께 문의합니다 |
217415 연결 실패 또는 시간 초과 | 네트워크 차단 또는 프록시 미설정 | 방화벽에서 엔드포인트로의 HTTPS를 허용하거나 HTTP 프록시를 지정합니다 |
| 가드레일 상태가 준비 안 됨 | AIM Starfort 접속 프로파일이 없음 | 2의 절차로 접속 프로파일을 등록합니다 |
| 가드레일 상태 목록에 AIM Starfort가 없음 | AI 에이전트 앱이 1.13보다 낮거나 나중에 설치됨 | AI 에이전트 앱을 1.13 이상으로 업데이트합니다 |
설치가 끝났다면 사용 매뉴얼에서 사용 방법을 확인하십시오.