AI 모델
모델 저장소나 추론 엔드포인트를 연결하면, 모델을 노린 공격을 모의로 실행해 취약한 응답을 찾고(AI 모의 공격) 모델의 구성 정보를 부품 명세로 정리(AI BOM)할 수 있습니다. 본인이 소유하거나 운영 권한을 가진 모델만 대상입니다.
- 분석 : AI 모의 공격 · AI BOM
- 연결 : 모델 저장소(Hugging Face · GitHub · GitLab) 또는 평가용 모델 서버(OpenAI 호환 추론 엔드포인트)
- 필요한 것 : 분석에 따라 모델 저장소 주소 또는 추론 엔드포인트 주소
- 대상 : 등록된 모델만. 임의 모델 주소를 직접 입력해 점검할 수 없습니다.
AI BOM 은 모델 저장소를 읽어 구성을 정리하고, AI 모의 공격 은 실행 중인 추론 엔드포인트에 요청을 보냅니다. 두 연결은 서로 독립적이며, 한쪽만 선택해 등록할 수도 있습니다.
필요한 것
선택한 분석에 따라 연결 대상이 달라집니다.
- AI BOM : 모델 저장소를 연결합니다. 저장소 종류(Hugging Face · GitHub · GitLab)와 주소, 비공개 · 접근 제한 모델이면 읽기 권한 토큰이 필요합니다.
- AI 모의 공격 : 평가용 모델 서버를 등록합니다. OpenAI 호환 추론 엔드포인트의 주소(
https://...,POST /chat/completions)와 모델 이름이 필요하며, 인증이 필요하면 API 키를 함께 등록합니다.
저장소 접근 토큰과 모델 서버 API 키는 암호화되어 저장되고 화면에는 마스킹되어 표시됩니다. 값은 평문으로 노출되지 않으며, 비워 두면 기존 값이 유지됩니다.
등록 절차
[서비스 관리] 페이지에서 서비스 등록을 누르고 AI 모델 유형을 선택하면 4단계 마법사가 시작됩니다.
- 서비스 유형 : 등록할 유형으로 AI 모델을 선택합니다.
- 분석 유형 : 서비스 이름을 정하고 AI 모의 공격 · AI BOM 중 1개 이상을 선택합니다.
- 모델 저장소 : 2단계에서 선택한 분석에 맞는 연결 정보를 입력합니다.
- 확인 : 입력 내용을 검토하고 등록을 마칩니다.
3단계 연결 정보
2단계에서 고른 분석에 따라 입력 화면이 달라집니다. 둘 다 선택하면 두 영역이 함께 표시됩니다.
- 모델 저장소 연결 (AI BOM 을 선택한 경우) : 저장소 종류를 고르고 주소를 입력합니다.
- Hugging Face : 모델 ID 또는 주소를 입력하고 연결 테스트로 확인합니다. 공개 모델은 접근 토큰을 비워 둡니다. 비공개 · 접근 제한 모델은 읽기 권한 토큰이 필요합니다.
revision(브랜치 · 태그 · 커밋)을 비우면main을 사용하며, 등록 후에는 변경할 수 없습니다. - GitHub · GitLab : 저장소 URL 과 접근 토큰을 입력하고 인증 테스트를 통과한 뒤 분석할 브랜치를 선택합니다. 소스코드 등록과 같은 연결 방식입니다.
- Hugging Face : 모델 ID 또는 주소를 입력하고 연결 테스트로 확인합니다. 공개 모델은 접근 토큰을 비워 둡니다. 비공개 · 접근 제한 모델은 읽기 권한 토큰이 필요합니다.
- 평가용 모델 서버 (AI 모의 공격 을 선택한 경우, 필수) : 점검할 모델 서버 주소(
base_url)와 모델 이름을 등록합니다. 이 등록은 저장소 연결과 독립적이어서, 나중에 서비스 설정에서 등록하거나 바꿀 수 있습니다.
등록을 마치면 [서비스 관리] 목록으로 이동합니다. 서비스를 열고 각 분석 탭에서 분석 실행을 눌러 시작합니다.
GitHub · GitLab 저장소 모델의 AI BOM 은 공개 모델 정보가 아니라 제작 조직이 작성하는 자체 모델 명세로 만듭니다. 등록한 뒤 AI BOM 화면에서 명세를 기록하고, 발행할 때 저장소의 커밋 · 모델 파일 지문을 함께 읽습니다. 자세한 내용은 AI BOM을 참고하세요.
소유 모델만 대상
AI 모의 공격은 실제 모델에 공격 프롬프트를 보내고, AI BOM 은 저장소를 읽습니다. 두 분석 모두 등록된 모델만 대상으로 하며, 대상 모델은 등록 정보에서 가져오므로 점검 화면에서 임의 주소를 직접 입력할 수 없습니다. 본인이 소유하거나 운영 권한을 가진 모델에만 사용합니다.
설정 (등록 후 변경)
등록한 뒤에는 서비스 사이드바의 [설정]에서 저장소 접근 토큰이나 평가용 모델 서버 정보를 바꿀 수 있습니다. 저장소 종류 · 주소 · revision 은 등록 시 고정됩니다. 자세한 방법은 AI 모델 설정을 참고하세요.