OHREN_Lab

News소식Nous ResearchNous Research

Nous Research presents an official Hermes Agent plugin that reviews a code repository for security bugsNous Research, 코드 저장소의 보안 버그를 찾아 주는 Hermes Agent 공식 플러그인 소개

It works out what an attacker could reach, splits the code among up to 10 reviewers and keeps the evidence for each candidate. It needs Hermes 0.21.5 or later and Python 3.11 or later, and the code under review goes to the configured model provider.공격자가 닿을 수 있는 곳을 먼저 따져 본 뒤 최대 10개의 검토자가 코드를 나눠 읽고, 후보마다 근거를 남깁니다. Hermes 0.21.5 이상과 Python 3.11 이상이 필요하고, 검토할 코드는 설정한 모델 제공사로 전송됩니다.

Source published원문 게시일
Checked확인일

Nous Research has presented hermes-security, an official Hermes Agent plugin that reviews a code repository for security bugs. It keeps each finding together with its evidence, any test results and a record of which code was actually read. Reports separate findings backed by the code from findings confirmed by a test, and rejected or inconclusive candidates stay in the report so you can see what was ruled out and why.Nous Research가 코드 저장소의 보안 버그를 찾아 주는 Hermes Agent 공식 플러그인 hermes-security를 소개했습니다. 찾아낸 문제마다 근거와 테스트 결과, 실제로 읽은 코드 범위를 함께 남깁니다. 보고서는 코드로 뒷받침된 항목과 테스트로 확인된 항목을 나눠 보여 주고, 걸러졌거나 결론이 나지 않은 후보도 왜 그렇게 됐는지 볼 수 있게 남겨 둡니다.

Official hermes-security plugin image: a classical statue with a winged helmet and a shield, a magnifying glass over a column, code windows and a padlock network on black, above the words Official Plugin and Security in large yellow letters
Image: Hermes Marketplace official plugin page.이미지: Hermes Marketplace 공식 플러그인 페이지. Open original원본 보기

When a scan starts, the agent first works out what an attacker could reach and which inputs are trusted. It then reviews the code, checks each candidate against the code and traces whether an attacker can actually reach it. The work is split by folder into chunks of about 4,000 lines, and up to 10 reviewers run at the same time, while one more reviewer looks across the whole scope for entry points and trust boundaries. A standard scan reads production code such as source, config, CI, infrastructure as code and migrations, and lists everything it skips in the report with the reason. A deep scan also reads the files a standard scan skips and makes independent passes over the whole repository, three by default.스캔을 시작하면 에이전트는 공격자가 닿을 수 있는 곳과 믿을 수 있는 입력을 먼저 따져 봅니다. 그다음 코드를 검토하고, 후보마다 코드와 맞춰 본 뒤, 공격자가 실제로 거기까지 갈 수 있는지 추적합니다. 코드는 폴더별로 약 4,000줄씩 나누고, 최대 10개의 검토자가 동시에 읽습니다. 다른 검토자 하나는 전체 범위에서 진입점과 신뢰 경계를 살핍니다. 표준 스캔은 소스, 설정, CI, 코드형 인프라, 마이그레이션 같은 운영 코드를 읽고, 건너뛴 파일은 까닭과 함께 보고서에 적습니다. 심층 스캔은 표준 스캔이 건너뛰는 파일까지 읽으며 저장소 전체를 기본 세 번 따로 훑습니다.

Before the review, the scan checks lockfiles against published advisories using Google's osv-scanner. On the first scan it downloads a pinned release from GitHub, about 55 MB, and uses it only if the SHA-256 matches. An advisory alone does not produce a finding; one is reported only when the review shows the code reaches the vulnerable behavior. If you allow tests, the agent writes small reproductions and runs them with your usual toolchain in a temporary copy of the repository, and a finding is marked Confirmed by test only when its test passes and a matching negative test behaves as expected. Reports export as Markdown, JSON, CSV and SARIF, and suggested patches are shown for reading only, so the plugin never applies them.검토에 앞서 잠금 파일을 공개된 취약점 권고와 대조합니다. 구글의 osv-scanner를 쓰며, 첫 스캔 때 GitHub에서 약 55MB의 고정된 판을 받아 SHA-256이 맞을 때만 사용합니다. 권고에 올랐다는 것만으로는 결과가 되지 않고, 검토에서 내 코드가 그 취약한 동작에 닿는다고 나와야 보고합니다. 사용자가 허락하면 작은 재현 코드를 써서 저장소의 임시 사본에서 평소 쓰는 도구로 실행하고, 그 테스트가 통과하고 짝이 되는 부정 테스트도 예상대로 동작할 때만 Confirmed by test로 표시합니다. 보고서는 Markdown, JSON, CSV, SARIF로 내보낼 수 있고, 제안된 패치는 읽기만 할 수 있어 플러그인이 코드에 적용하지 않습니다.

It needs Hermes 0.21.5 or later and Python 3.11 or later. Install it with hermes plugins install hermes-security --enable and restart Hermes. A scan can start from a chat request, from the hermes security-review command in a terminal or from the Security page in Hermes Desktop. The Desktop page has to be switched on under Capabilities, in Plugins, after installing. The plugin is under the Apache-2.0 license.Hermes 0.21.5 이상과 Python 3.11 이상이 필요합니다. hermes plugins install hermes-security --enable로 설치한 뒤 Hermes를 다시 시작합니다. 채팅에서 저장소를 스캔해 달라고 요청하거나, 터미널의 hermes security-review 명령, Hermes Desktop의 Security 화면에서 시작할 수 있습니다. Desktop 화면은 설치한 뒤 Capabilities의 Plugins에서 켜야 합니다. 플러그인은 Apache-2.0 라이선스입니다.

The model provider configured in Hermes receives the code it is asked to review. Scan data and reports stay in the profile's plugin data folder, and nothing is uploaded to a findings service or ticket system. Package names and versions go to api.osv.dev and api.deps.dev and declared runtime versions to endoflife.date, a check that HERMES_SECURITY_DEPENDENCY_CHECK=off turns off. Tests run as your user in a temporary copy with credential-looking environment variables removed, but that is not a sandbox, so they should only be allowed on code you trust. Files over 8 MB, vendored code, symlinks and special files are skipped and listed in the report. Code that was not reviewed shows up as a gap in coverage, so zero findings with partial coverage does not mean the code is clean.검토할 코드는 Hermes에 설정한 모델 제공사로 전송됩니다. 스캔 데이터와 보고서는 프로필의 플러그인 데이터 폴더에 저장되고, 취약점 관리 서비스나 티켓 시스템으로 올라가지 않습니다. 패키지 이름과 버전은 api.osv.dev와 api.deps.dev로, 선언된 런타임 버전은 endoflife.date로 전달되며, 이 확인은 HERMES_SECURITY_DEPENDENCY_CHECK=off로 끌 수 있습니다. 테스트는 사용자 권한으로 임시 사본에서 돌고 자격 증명처럼 보이는 환경 변수를 뺀 상태이지만 샌드박스는 아니므로, 믿을 수 있는 코드에만 허용해야 합니다. 8MB가 넘는 파일, 벤더 코드, 심볼릭 링크, 특수 파일은 건너뛰고 보고서에 남깁니다. 읽지 못한 코드는 커버리지 공백으로 표시되므로, 일부만 검토한 스캔에서 결과가 0건이어도 코드가 깨끗하다는 뜻은 아닙니다.

All algoit posts알고IT 글 목록

Follow algoit on알고IT 팔로우하기X Instagram Threads