---
title: "보안 에이전트 | Briks"
url: https://briks.dev/ko/docs/security-agent
description: "보안 에이전트를 고용하면 사이트의 코드, 키, 라이브 페이지를 점검해 쉬운 말로 알려주고, 승인한 수정은 Builder가 해요."
last_updated: 2026-10-08
---

# 보안 에이전트

보안 에이전트는 프로젝트의 보안을 살펴봐요. 게시할 때마다 사이트 코드를 점검하고 매주 사이트 전체를 점검해요. 발견한 내용과 다음에 할 일을 쉬운 말로 알려주고, 승인한 수정은 빌더에게 요청해요. 사이트를 마음대로 바꾸지 않고, 키의 값도 절대 보지 않아요.

읽는 데 6분 2026년 10월 8일 스튜디오 기준으로 확인함

누가 고용할 수 있나요

보안 에이전트는 다른 에이전트처럼 Agents에서 고용하고, 요금제의 프로젝트당 에이전트 수에 포함돼요. Owner와 Admin은 고용하고, 수정을 Builder에게 보내고, 위험을 감수하기로 정할 수 있어요. 워크스페이스의 모든 구성원이 리포트를 읽을 수 있어요.

## 점검 항목

점검 대부분은 Briks 자체 점검이 맡아요. 이 점검은 매번 같은 방식으로 사이트를 읽고 크레딧이 들지 않아요. 그다음 에이전트는 점검이 가리킨 곳만 읽고, 발견 사항이 실제인지 판단해서 설명해 줘요.

| 영역 | 점검 대상 |
| --- | --- |
| 내 사이트의 코드 | 파일에 적힌 키, 횟수 제한 없이 데이터를 바꿀 수 있는 변경, 요청자를 확인하지 않고 읽는 회원 기록, 원본 HTML로 표시되는 텍스트, 다른 웹사이트로의 호출, 그리고 각 경로를 누가 쓸 수 있는지 적은 사이트 자체 목록에 빠진 경로를 확인해요. |
| 키 | 코드가 읽는데 Settings → Secrets에 설정되지 않은 키, 그리고 거기에 설정되어 있지만 더는 아무것도 읽지 않는 키를 모두 보여 줘요. 이름만 다루며, 에이전트는 값을 절대 보지 않아요. |
| 라이브 사이트 | 모든 주소가 https로 응답하는지와 일반 http 요청이 https로 넘어가는지, 인증서가 며칠 남았는지, 보안 헤더, 로그인 쿠키, 다른 웹사이트가 로그인한 방문자인 것처럼 사이트의 API를 쓸 수 있는지, 내려받을 수 없어야 하는 파일, 사이트 내부 구조가 드러나는 오류 페이지를 확인해요. |
| 이메일 | 직접 이메일을 보내는 도메인이라면 SPF, 서명(DKIM), DMARC 레코드를 확인해요. |
| 파일과 양식 | 공개 Storage 폴더에서 backup, invoice, passport, contract처럼 비공개로 보이는 이름의 파일, 그리고 평소보다 갑자기 늘어난 폼 제출 건수를 확인해요. |
| 패키지 | 모든 사이트가 기본으로 갖는 패키지 외에 사이트에 추가된 패키지에 대해, 공개 보안 권고 데이터베이스에 올라온 알려진 보안 권고를 확인해요. |
| 자세히 보기 | 한 달에 한 번, 로그인, 결제, 업로드 파일, AI 기능을 다루는 사이트 부분을 읽어요. 지난번 이후 바뀐 부분부터 살펴봐요. |

## 실행되는 때

- **게시할 때마다.** 방금 공개된 버전을 저장된 그대로 코드 점검과 키 점검을 바로, 비용 없이 실행해요. 에이전트 자체는 점검에서 새로운 문제가 나오거나, 요청한 수정이 공개되어 확인이 필요할 때만 깨어나요.
- **매주** 월요일 아침, 워크스페이스의 시간대 기준으로 라이브 사이트를 포함한 전체 점검을 하고 짧은 보고서를 보내요.
- **When you write to it**: 스레드에서 직접 말을 걸 때예요. 예를 들어 새 양식을 라이브로 올려도 안전한지 물을 때요.

페이지에 키가 적혀 있거나 누구나 내려받을 수 있는 비공개 파일이 있는 것 같은 긴급한 발견은 바로 알려줘요. 알림 벨로 오고, 알림 설정에서 **Urgent security findings** 를 켜 둔 Telegram 채팅으로도 와요.

## 리포트 읽는 법

리포트 찾기

1. Agents 열기

   위치: Agents

   프로젝트를 고른 다음 Crew 탭에서 보안 에이전트를 선택하세요.

2. Security report 탭을 여세요

   위치: Security report

   발견 사항은 심각도에 따라 긴급, 높음, 보통, 낮음으로 나뉘어요. 탭에 표시된 숫자는 확인을 기다리는 항목 수예요.

3. 발견 사항 읽는 법

   각 항목에는 누군가 무엇을 할 수 있는지, 사업에 어떤 의미인지, 그리고 다음 단계가 적혀 있어요. 다음 단계는 사용자만 할 수 있는 일(어디서 하는지 포함), Builder가 할 수 있는 수정, 또는 Briks가 이미 처리 중이라는 안내 중 하나예요.

4. 접힌 목록 확인하기

   수락한 위험, 점검했고 문제없다고 확인된 항목, 최근 30일 동안 수정된 항목은 맨 아래에 접혀 있어요.

**Worth checking** 은 나만 볼 수 있는 것에 달려 있는 항목을 보여 줘요. 예를 들어 이름이 비공개처럼 보이는 파일이 공개 Storage 폴더에 있는 경우예요. 무엇을 어디서 확인할지 정확히 알려 줘요. 나를 기다리는 결과는 다른 에이전트가 요청한 것과 함께 **Waiting for you** 에도 나타나요.

## 수정하기와 위험 수락

빌더에게 발견 사항 수정 맡기기

1. Fix it을 선택하세요

   위치: Security report

   확인 창에 변경에 보통 크레딧이 얼마나 드는지와 보유한 크레딧이 표시돼요. **Send to the Builder** 를 누르세요.

2. 승인하기

   위치: Waiting for you

   수정안은 에이전트가 요청하는 모든 변경과 마찬가지로 **Waiting for you**, 이메일, Telegram에서 기다려요. 읽어 보고, 문구를 고치고, 승인하거나 거절할 수 있어요.

3. Builder가 변경해요

   승인하면 새 버전으로 제작, 점검, 게시돼요. 버전 목록에서 언제든 되돌릴 수 있어요.

4. 에이전트가 다시 점검해요

   새 버전이 게시되면 점검을 다시 실행하고, 발견 사항이 사라졌으면 해결됨으로 표시해요.

**Accept the risk** 는 감수하기로 한 발견 사항에 쓰는 버튼이에요. 요청한 내용 때문에 생기는 경우가 많아요. 예를 들어 공유하려는 공개 Storage 폴더 안의 파일이 그래요. 선택은 내 이름과 날짜와 함께 저장되고, 에이전트는 상황이 나빠지지 않는 한 다시 알리지 않아요.

## 하지 않는 일

- 사이트를 직접 바꾸지 않아요. 모든 수정은 사용자가 승인한 변경이며, Builder가 만들고 되돌리기도 가능해요.
- 사용자가 요청한 것을 되돌리자고 제안하지 않아요. 사용자의 선택에 위험이 따르면 한 번 알려 주고, 결정은 사용자에게 맡겨요.
- 키의 값을 요청하거나 읽거나 반복하지 않아요. 키 이름만 가지고 작업해요.
- 침입을 시도하지 않아요. 라이브 사이트에는 방문자의 브라우저가 보내는 평범한 요청만, 점검 한 번에 최대 25건, 사이트 자체 주소로 보내요.
- 고객 기록을 하나씩 읽지 않아요. 개수만 세고, 발견 사항에 꼭 필요할 때만 하나를 짚어서 알려줘요.

## 예산과 크레딧

점검 자체에는 크레딧이 들지 않아요. 에이전트가 쓰는 것은 발견 사항을 설명하고 수정 문구를 작성하는 읽기와 쓰기이고, 이는 워크스페이스 크레딧에서 에이전트 자체의 월 예산 안에서 차감돼요. 기본값은 20 크레딧이며 설정에서 바꿀 수 있고, 그중 5분의 1을 하루에 쓸 수 있어요. 한 번 실행할 때 가장 심각한 것부터 최대 두 건의 수정을 요청하고, 각 수정은 자체 크레딧 견적이 있는 일반 변경이에요.

팁

설정에서 직접 고칠 수 있는 문제라면 에이전트가 Builder에게 요청하지 않고 그렇게 알려줘요. Settings → Secrets에 키를 추가하는 일은 크레딧이 들지 않아요.

### 묻지 않고 스스로 고칠 수도 있나요?

아니요. 보안 수정은 항상 승인을 기다리며, 이 에이전트의 설정에는 다른 에이전트에 있는 스위치 대신 그 내용이 적혀 있어요. 모든 수정은 크레딧 예상치와 함께 **Waiting for you** 에서 기다리고, 승인하면 되돌릴 수 있는 새 버전으로 게시돼요.

### Briks가 이미 처리 중이라고 나오는 이유는 무엇인가요?

일부 발견 사항은 보안 헤더나 인증서처럼 모든 사이트가 제공되는 방식에 관한 것이에요. 이런 항목은 Briks가 모든 사이트에 한꺼번에 고치니, 사용자나 Builder가 할 일은 없어요.

### 감수하기로 한 위험을 다시 문제 삼나요?

더 나빠졌을 때만 다시 알려요. 점검한 결과 실제 위험이 아니라고 확인된 항목도 다시 알리지 않아요.

## 다음 글 읽기

- [AI 에이전트 **AI 에이전트 고용하기** 라이브 사이트를 돌보는 AI 에이전트를 채용해요. 팀 리드가 이끄는 13종, 또는 직접 만든 에이전트가 일정과 예산에 맞춰 움직이고, 행동 전에 먼저 물어봐요.](https://briks.dev/ko/docs/ai-agents)
- [AI 에이전트 **승인과 예산** 에이전트가 실행 전에 묻는 내용을 확인하고 스튜디오, 이메일, Telegram에서 승인하세요. 혼자 할 일과 지출 한도도 정해요.](https://briks.dev/ko/docs/agent-approvals)
- [데이터와 자동화 **시크릿** 사이트 코드에 필요한 API 키와 비밀번호를 페이지나 다운로드가 아닌 서버에 보관해요. 추가, 변경, 삭제와 Briks가 적용하는 규칙을 안내해요.](https://briks.dev/ko/docs/secrets)
- [프로젝트에서 작업하기 **버전, 실행 취소, 다시 실행** 모든 제작과 변경이 사이트 버전으로 저장돼요. 변경을 취소하거나 다시 적용하고, 이전 버전을 그대로 되살려 게시해요. 크레딧은 묶이지 않아요.](https://briks.dev/ko/docs/versions)

아직 해결되지 않았나요?

프로젝트 이름과 기대했던 내용을 적어 [hello@briks.dev](mailto:hello@briks.dev) 로 보내 주세요. 스크린샷이 있으면 도움이 돼요.