보안의 발견 사항을 읽고 채팅 어시스턴트나 사용자 본인의 어시스턴트를 통해 조치할 수 있습니다.CoRoid를 MCP 서버로 사용: Claude Code, Codex, Cursor 또는 다른 MCP 클라이언트입니다. 이 도구들은 포털과 동일한 규칙을 따르므로 동일한 결과를 제공하고 같은 요청을 거부합니다.
읽기
보안에는 고유한 범위가 있으므로 다른 용도로 설정된 연결에서는
발견 사항을 확인할 수 없습니다. 이러한 도구들은 리뷰어 역할과mcp.security.read가 필요합니다. 이들 중 어느 것도 승인이 필요하지 않습니다. 이 도구들은 CoRoid 보안의 자체 규칙을 따르며, 포털에서 볼 수 있는 프로젝트만 표시됩니다. 특정 프로젝트로 제한된 연결의 경우 해당 프로젝트 중 하나 또는 관련 발견 사항을 지정해야 합니다.
| 도구 | 반환되는 내용 |
|---|---|
get_security_overview | 프로젝트별로 심각도에 따라 열린 발견 사항, 수정 기한이 지난 항목, 아직 확인되지 않은 항목, 테스트 코드, 그리고 사용자에게 대기 중인 항목 수를 표시합니다. |
list_security_findings | 프로젝트, 유형, 심각도 및 상태별 발견 사항을 표시하며, 먼저 악용된 순서대로, 그 다음 심각도순으로 나열됩니다.needsYou는 사람의 승인을 기다리는 항목만 표시합니다. |
list_security_needs | 사람의 승인을 기다리는 결정 사항들로, 우선순위가 높은 항목부터 처리되며 각각에 대해 CoRoid의 답변과 해당 내용을 열어볼 수 있는 링크가 제공됩니다. 이 목록은 보안 → 결정 사항 메뉴의 목록과 동일합니다. |
get_security_finding | 단일 발견 사항의 위치, 확인 여부, 마감일 및 수정 작업 내용을 표시합니다. 결코 비밀의 가치는 포함되지 않습니다. |
get_security_settings | 각 프로젝트의 보호 설정에 따른 검사 결과를 표시합니다: 해제, 관찰 모드, 강제 적용 또는 실행 불가 상태와 그 이유, 그리고 프로젝트 설정에 따른 선택 사항을 안내합니다. |
list_security_runs | 보안 실행 내역을 최신 순으로 표시하며, 실행 로그에 실행 중, 대기 중, 완료됨, 실패 또는 교체됨 상태와 실행 실패 원인을 기재합니다. |
get_attack_surface | 각 프로젝트의 진입점과 노출 대기 중인 항목 수를 표시합니다. 특정 프로젝트의 경우 코드에 나타난 진입점과 관련 결정 사항, 배포 제안 내용, pull request 가드가 탐지한 결과를 상세히 안내합니다. |
get_threat_model | 각 프로젝트의 위협 모델 버전과 리뷰 대기 중인 항목을 표시합니다. 특정 프로젝트의 경우 모델 내용, 대기 중인 제안 및 최신 버전 정보를 제공합니다. |
list_security_packages | 각 프로젝트의 최신 종속성 목록과 설치된 패키지 수, 취약한 패키지 수를 표시합니다. 특정 프로젝트의 경우 페이지별로 취약한 패키지를 먼저 보여줍니다. |
모든 발견 사항은 CoRoid 내 해당 페이지로 링크됩니다.
발견 사항에 대한 조치
이 도구들은 발견 사항에 대해 조치를 취할 수 있습니다. 이를 위해서는mcp.security.write와 소유자 또는
관리자가 필요하며, 이는 포털에서와 동일한 요건입니다.
| 도구 | 수행 기능 | 승인 |
|---|---|---|
start_security_fix | 포털에서와 같이 수정 작업을 수행합니다: 취약한 종속성에 대한 수정, 코드 발견 사항에 대한 회귀 테스트 작업, 유출된 인증 정보에 대한 교체 체크리스트 작성 등입니다. 두 번째 '수정' 명령은 이미 접수된 작업에 응답합니다. | 불가 |
run_security_scan | 현재 프로젝트의 모든 항목을 스캔합니다: 활성화된 항목, 종속성, 비밀 정보 이력, 공격 표면, 감사 대상(해당하는 경우) 또는 보존된 증거까지 포함됩니다. | 불가 |
confirm_real_secret | 유출된 인증 정보가 실제임을 확인합니다. 누군가 교체 사실을 인증하기 전까지는 해당 항목은 열린 상태로 유지됩니다. | 불가 |
revoke_security_exception | 예외 상황을 종료합니다. 그러면 발견 사항이 다시 열립니다. | 불가 |
dismiss_security_finding | 발견 사항을 '문제 아님'으로 표시하며 그 사유를 기재합니다. | 항상 필요 |
add_security_exception | 특정 날짜까지 발견 사항의 위험을 수용하며 그 사유를 기재합니다. | 항상 필요 |
attest_secret_rotated | 유출된 인증 정보가 교체되거나 폐기되었음을 인증하면 해당 항목이 닫힙니다. CoRoid는 탐지된 인증 정보를 직접 테스트하지 않습니다. | 항상 필요 |
공격 표면 및 위협 모델에 대한 조치
이러한 작업에도mcp.security.write와 소유자 또는 관리자가 필요합니다. 포털에서 하나의 제어 기능이 강화와 약화를 동시에 수행하는 경우 두 가지 도구가 존재합니다. 강화 기능을 수행하는 도구는 약화시키는 변경을 거부하므로, 해당 변경은 반드시 사람의 승인을 받아야 합니다.
| 도구 | 수행 기능 | 승인 |
|---|---|---|
raise_entry_point_exposure | 진입점을 더 노출되도록 설정하거나, 감사를 위해 고정하거나, 범위에 다시 포함시킵니다. | 불가 |
lower_entry_point_exposure | 진입점을 덜 노출되도록 설정하거나, 고정을 해제하거나, 사유를 명시하여 범위에서 제외시킵니다. | 항상 필요 |
refresh_threat_model | 프로젝트의 코드를 다시 읽어들이며, 그 결과는 제안 형태로 대기합니다. | 불가 |
add_threat_model_entries | 위협 모델에 항목을 추가합니다. | 불가 |
accept_threat_model_proposal | 코드를 새로 읽어들여 제안된 내용을 수용합니다. | 불가 |
update_threat_model_entries | 항목의 제목이나 세부 정보를 변경합니다. | 항상 필요 |
remove_threat_model_entries | 위협 모델에서 항목을 제거합니다. | 항상 필요 |
dismiss_threat_model_proposal | 코드를 새로 읽어들여 제안된 내용을 거부합니다. | 항상 필요 |
keep_security_proof | 발견 사항을 재현한 증거를 회귀 테스트로 저장합니다. | 불가 |
보호 설정 변경하기
한 프로젝트 또는 조직 기본 설정에 대한 보호 규칙의 설정은 다음 두 도구에서 동일하게 적용됩니다:tighten_security_protection해당 설정은 보호 수준을 강화하여 이를 약화시키는 모든 변경을 거부하며,relax_security_protection다른 설정은 보호 수준을 약화시키거나 프로젝트가 다시 조직 기본 설정을 따르도록 하며, 항상 사람의 승인을 기다립니다. 감지 또는 적용 기능이 비활성화되거나 심각도 임계값이 상향 조정되고, 수정용 풀 리퀘스트 개수가 줄어들거나 감사 기능이 꺼지거나 실행 빈도가 낮아지고, 비밀번호 스캔 범위가 축소되거나 샌드박스 네트워크가 더 개방되어 더 많은 호스트를 허용하거나 '설정되지 않음' 항목이 더 이상 인터넷에 노출된 것으로 간주되지 않는 경우 보호 수준이 약화됩니다. '자체 스캔 명령어'는 품질 관리 설정에서 지정합니다.
연락처 및 취약점 공개 절차
프로젝트의 보안 연락처는 소유자 및 관리자와 함께 취약점 공개 권한을 가집니다. 이들은 CoRoid가 공개되지 않은 취약점에 대해 비공개로 보관하는 수정 사항을 확인하고, 이를 게시하거나 삭제하며, GitHub 보안 권고안을 초안으로 작성하고 의존성 라이브러리 유지관리자에게 보고서를 전달합니다. MCP 및 채팅을 통한 이러한 작업은 소유자와 관리자만 수행할 수 있으며, 모든 작업은 사람의 승인을 받아야 합니다. 연락처 담당자는 취약점을 공개할 수 있으며, 일단 공개된 취약점 정보는 되돌릴 수 없습니다.
| 도구 | 기능 설명 | 승인 |
|---|---|---|
list_security_contacts | 프로젝트의 보안 연락처 및 해당 역할을 맡을 수 있는 사람 | 아니요 |
get_security_disclosure | 취약점에 대한 비공개 수정 사항(크기 및 상태, 내용은 제외)과 GitHub 권고안, 그리고 유지관리자에게 전송된 보고서 – 이 모든 것은 공개 권한을 가진 사람만 접근할 수 있습니다. | 아니요 |
add_security_contact | 프로젝트 멤버를 보안 연락처로 지정하기 | 항상 |
remove_security_contact | 보안 연락처 삭제하기 | 항상 |
publish_private_fix | 보류 중인 수정 사항 게시하기: 취약점이 공개되고 해당 작업에 pull request가 생성됩니다. | 항상 |
discard_private_fix | 보류 중인 수정 사항 삭제하기 | 항상 |
draft_github_security_advisory | 저장소에 GitHub 보안 권고안을 초안으로 작성하며, 이는 유지관리자에게 표시됩니다. | 항상 |
record_maintainer_report | 의존성 라이브러리 유지관리자에게 취약점을 보고한 위치를 기록합니다. CoRoid는 어떠한 내용도 전송하지 않습니다. | 항상 |
일부 작업이 왜 사람의 승인을 기다리는가?
문제가 아닌 경우, 허용된 위험 요소 및 순환 사용되는 인증 정보는 수정 없이 취약점 목록에서 제외되며, 노출 정도가 낮은 항목이나 규모가 작은 위협 모델 역시 감사 대상에서 제외됩니다. 보조 시스템이 이런 작업을 단독으로 수행해서는 안 되므로, 연결 설정과 관계없이 이러한 작업은 항상 사람의 승인을 기다립니다:
- MCP 클라이언트를 통해 요청이 전송되면 소유자 또는 관리자의 승인을 기다립니다. 설정 → 연결 → CoRoid MCP 서버 → 승인, 그리고 해당 사람에게 알림이 발송됩니다. 요청은 10분 후에 만료됩니다.
- 채팅에서는 보조 시스템이 작업을 수행하기 전에 채팅창에서 사용자의 확인을 요청합니다.
승인에는 CoRoid 자체 기록을 바탕으로 수행될 작업이 명확한 표현으로 설명됩니다: "접근 제어 문제를 표시할 위치:src/routes/admin.ts:76(Shop)
문제없음", 그 뒤에 따옴표로 묶인 이유가 나옵니다. 이유를 설명하는 문구는 CoRoid에서 가져온 것이며 보조 시스템이 작성한 것이 아니며, 인증 정보의 값은 절대 표시되지 않습니다. CoRoid는 해당 값을 저장하지 않기 때문입니다.