보안 에이전트
보안 에이전트는 프로젝트의 보안을 살펴봐요. 게시할 때마다 사이트 코드를 점검하고 매주 사이트 전체를 점검해요. 발견한 내용과 다음에 할 일을 쉬운 말로 알려주고, 승인한 수정은 빌더에게 요청해요. 사이트를 마음대로 바꾸지 않고, 키의 값도 절대 보지 않아요.
점검 항목
점검 대부분은 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 채팅으로도 와요.
리포트 읽는 법
리포트 찾기
Agents 열기
위치: Agents
프로젝트를 고른 다음 Crew 탭에서 보안 에이전트를 선택하세요.
Security report 탭을 여세요
위치: Security report
발견 사항은 심각도에 따라 긴급, 높음, 보통, 낮음으로 나뉘어요. 탭에 표시된 숫자는 확인을 기다리는 항목 수예요.
발견 사항 읽는 법
각 항목에는 누군가 무엇을 할 수 있는지, 사업에 어떤 의미인지, 그리고 다음 단계가 적혀 있어요. 다음 단계는 사용자만 할 수 있는 일(어디서 하는지 포함), Builder가 할 수 있는 수정, 또는 Briks가 이미 처리 중이라는 안내 중 하나예요.
접힌 목록 확인하기
수락한 위험, 점검했고 문제없다고 확인된 항목, 최근 30일 동안 수정된 항목은 맨 아래에 접혀 있어요.
Worth checking은 나만 볼 수 있는 것에 달려 있는 항목을 보여 줘요. 예를 들어 이름이 비공개처럼 보이는 파일이 공개 Storage 폴더에 있는 경우예요. 무엇을 어디서 확인할지 정확히 알려 줘요. 나를 기다리는 결과는 다른 에이전트가 요청한 것과 함께 Waiting for you에도 나타나요.
수정하기와 위험 수락
빌더에게 발견 사항 수정 맡기기
Fix it을 선택하세요
위치: Security report
확인 창에 변경에 보통 크레딧이 얼마나 드는지와 보유한 크레딧이 표시돼요. Send to the Builder를 누르세요.
승인하기
위치: Waiting for you
수정안은 에이전트가 요청하는 모든 변경과 마찬가지로 Waiting for you, 이메일, Telegram에서 기다려요. 읽어 보고, 문구를 고치고, 승인하거나 거절할 수 있어요.
Builder가 변경해요
승인하면 새 버전으로 제작, 점검, 게시돼요. 버전 목록에서 언제든 되돌릴 수 있어요.
에이전트가 다시 점검해요
새 버전이 게시되면 점검을 다시 실행하고, 발견 사항이 사라졌으면 해결됨으로 표시해요.
Accept the risk는 감수하기로 한 발견 사항에 쓰는 버튼이에요. 요청한 내용 때문에 생기는 경우가 많아요. 예를 들어 공유하려는 공개 Storage 폴더 안의 파일이 그래요. 선택은 내 이름과 날짜와 함께 저장되고, 에이전트는 상황이 나빠지지 않는 한 다시 알리지 않아요.
하지 않는 일
- 사이트를 직접 바꾸지 않아요. 모든 수정은 사용자가 승인한 변경이며, Builder가 만들고 되돌리기도 가능해요.
- 사용자가 요청한 것을 되돌리자고 제안하지 않아요. 사용자의 선택에 위험이 따르면 한 번 알려 주고, 결정은 사용자에게 맡겨요.
- 키의 값을 요청하거나 읽거나 반복하지 않아요. 키 이름만 가지고 작업해요.
- 침입을 시도하지 않아요. 라이브 사이트에는 방문자의 브라우저가 보내는 평범한 요청만, 점검 한 번에 최대 25건, 사이트 자체 주소로 보내요.
- 고객 기록을 하나씩 읽지 않아요. 개수만 세고, 발견 사항에 꼭 필요할 때만 하나를 짚어서 알려줘요.
예산과 크레딧
점검 자체에는 크레딧이 들지 않아요. 에이전트가 쓰는 것은 발견 사항을 설명하고 수정 문구를 작성하는 읽기와 쓰기이고, 이는 워크스페이스 크레딧에서 에이전트 자체의 월 예산 안에서 차감돼요. 기본값은 20 크레딧이며 설정에서 바꿀 수 있고, 그중 5분의 1을 하루에 쓸 수 있어요. 한 번 실행할 때 가장 심각한 것부터 최대 두 건의 수정을 요청하고, 각 수정은 자체 크레딧 견적이 있는 일반 변경이에요.
묻지 않고 스스로 고칠 수도 있나요?
아니요. 보안 수정은 항상 승인을 기다리며, 이 에이전트의 설정에는 다른 에이전트에 있는 스위치 대신 그 내용이 적혀 있어요. 모든 수정은 크레딧 예상치와 함께 Waiting for you에서 기다리고, 승인하면 되돌릴 수 있는 새 버전으로 게시돼요.
Briks가 이미 처리 중이라고 나오는 이유는 무엇인가요?
일부 발견 사항은 보안 헤더나 인증서처럼 모든 사이트가 제공되는 방식에 관한 것이에요. 이런 항목은 Briks가 모든 사이트에 한꺼번에 고치니, 사용자나 Builder가 할 일은 없어요.
감수하기로 한 위험을 다시 문제 삼나요?
더 나빠졌을 때만 다시 알려요. 점검한 결과 실제 위험이 아니라고 확인된 항목도 다시 알리지 않아요.