본문 바로가기

직접 만든 소프트웨어, 두 가지 개발 기록

구현 구조와 적용 범위, 확인한 기능과 남은 한계를 함께 기록합니다.

소프트웨어개발

Copilot 비밀정보 검사 추가: 변경 코드와 저장소 이력은 따로 보세요

by 아빠띠띠뽀 2026. 11. 19.

Copilot의 보안 리뷰에 GitHub 비밀정보 탐지기를 함께 쓰는 공개 미리보기가 추가됐습니다. 새 기능은 기본적으로 꺼져 있고, 검토 대상은 코드 변경이며 저장소 이력을 검색하지 않습니다. 켜기, 실제 리뷰, 발견한 비밀값의 조치를 다른 단계로 확인해 주세요.

GitHub는 2026년 11월 17일 개발자와 에이전트가 요청해 사용하는 secret scanning을 발표했습니다. 18일 공식 공지와 개념·지원 패턴 문서를 확인했어요. 이 글은 Copilot CLI·앱·SDK·코드 리뷰에서 변경 사항을 점검하려는 개발자를 위한 안내이며, 실제 자격증명을 넣거나 탐지 기능을 켜서 성능을 시험한 결과는 아닙니다.

기존 LLM 리뷰에 선택형 탐지기가 더해집니다

비밀정보, 즉 secrets는 API 키·비밀번호·토큰처럼 서비스에 접근하는 데 쓰는 민감한 값입니다. 코드에 직접 넣은 자격증명이 외부로 노출되면 원하지 않는 접근에 쓰일 수 있어요. 이번 기능은 코드가 병합되기 전에 변경 사항에서 그런 값을 찾는 작업과 연결됩니다.

Copilot의 security-review 전문 에이전트는 이전에도 LLM 기반 분석으로 노출된 비밀정보를 찾았습니다. 이번 공개 미리보기에서 사용자가 선택해 켜면 GitHub secret scanning 탐지기를 그 분석과 함께 실행합니다. 기존 리뷰가 있다는 사실과 새 탐지기를 활성화했다는 사실을 같은 것으로 보지 마세요.

공지는 서비스 제공자 패턴으로 500종이 넘는 비밀 유형을 다루며 파트너 프로그램에 참여한 150곳 이상의 업계 파트너와 만든 목록이라고 설명합니다. 이는 발표 시점의 지원 범위 설명입니다. 숫자가 크다고 모든 조직의 자격증명이나 모든 표현 형태를 찾아낸다고 보장하는 것은 아닙니다.

또 다른 구성은 비밀정보 탐지를 위해 조정한 모델입니다. 일정한 형식을 갖지 않는 비밀번호나 연결 문자열 안의 자격증명을 주변 코드 문맥과 함께 살펴봅니다. 알려진 발급자 형식과 문맥 기반 탐지가 보완적으로 쓰인다는 뜻으로 읽어 주세요. 이 글은 어느 쪽의 정확도·오탐률을 측정하지 않았습니다.

공식 지원 패턴 문서도 일반 패턴, AI 탐지, 서비스 제공자 패턴의 기능이 같지 않다고 나눕니다. 유효성 확인이나 push protection 등은 유형과 실제 설정·플랜에 따라 다릅니다. 목록에 어떤 비밀 유형이 있다는 설명을 그 값이 지금 유효한지 확인됐거나 자동 차단됐다는 뜻으로 넓혀 읽으면 안 됩니다.

변경 검사와 저장소 이력 검사는 범위가 달라요

이번 발표가 명시하는 대상은 변경 사항입니다. 저장소의 이전 이력을 뒤지는 검사가 아닙니다. Copilot code review에서는 추가된 줄에서 비밀정보를 표시할 수 있다고 설명합니다. 현재 변경을 검토했다는 사실로 과거 커밋과 다른 브랜치까지 모두 안전하다고 기록하면 안 됩니다.

한편 일반적인 저장소 secret scanning의 공식 개념 문서는 모든 브랜치의 Git 이력에서 하드코딩한 자격증명을 살피는 범위를 설명합니다. 이 기능의 접근 조건과 동작은 해당 저장소의 플랜·Secret Protection·설정에 따라 확인해야 합니다. 새 요청형 검사의 제공 조건을 일반 저장소 기능 전체의 무료 제공 조건으로 가져오면 혼동이 생겨요.

예를 들어 새 PR에 실제 비밀값을 추가하지 않았더라도 예전 커밋에 값이 남아 있을 가능성은 별도의 문제입니다. 반대로 이력 검사에 경고가 없었다는 이유로 방금 만든 로컬 변경의 검토를 생략할 근거도 되지 않습니다. 이 예시는 검사 경계를 설명하는 가상 상황이며 실제 저장소에서 발견한 사건은 아닙니다.

Actions 로그도 다른 영역입니다. 코드 변경, 저장소 Git 이력, 실행 중 남은 로그를 한 번의 검사 결과로 합치지 말고 각각 어떤 기능과 설정으로 확인했는지 남겨 주세요. 하나의 경고 목록만 보고 모든 노출 경로가 확인됐다고 판단하기 어렵습니다.

검사 대상은 파일·변경 시점과 함께 적어 두는 편이 좋습니다. 리뷰를 받은 뒤 에이전트가 다시 코드를 바꿨다면 앞선 결과가 최신 변경에도 적용되는지 다시 생각해야 해요. 이 글이 제안하는 것은 통과 표시를 복사하는 방식이 아니라 실제로 검토한 변경과 남은 미확인을 구분하는 기록입니다.

확인 범위 이번 변경 검사와의 관계
작업 중 코드 변경 요청형 security-review의 검사 대상
PR에 추가된 줄 Copilot code review에서 표시할 수 있는 범위
저장소의 과거 Git 이력 이번 요청형 검사에 포함되지 않는 별도 확인
실행 로그와 실제 키 상태 각각의 노출 경로·발급자 조치를 따로 확인

도구별 켜기와 실제 리뷰 요청을 따로 확인하세요

secret scanning은 기본적으로 꺼져 있습니다. 사용자가 선택하기 전에는 기존 LLM 기반 탐지만 사용합니다. 아래 경로는 18일 확인한 공지의 기능별 안내이며, 실제 계정에서 설정을 바꾸거나 리뷰를 요청한 것은 아닙니다. 사용 중인 도구·버전·조직 정책에서 제공되는지 먼저 확인해 주세요.

Copilot CLI의 대화형 세션에서는 /settings aiSecretDetection on으로 활성화합니다. 이후 task 도구를 통해 security-review에 위임하거나 /security-review를 직접 요청하는 방식입니다. 설정을 켜는 명령의 완료와 실제 리뷰 결과의 확인은 다른 단계예요.

Copilot 앱은 Settings의 Experimental에서 AI secret detection을 켜는 경로입니다. 여기서도 task를 통한 위임이나 security-review 요청이 별도로 필요합니다. 팀의 실험 기능 사용 정책이 있다면 그 범위 안에서 검토하고, 이 글만 보고 조직 전체의 옵션을 임의 변경하지 마세요.

SDK 통합은 세션을 만들 때 SECURITY_REVIEW_FINE_TUNED_MODEL 기능 플래그를 true로 두는 조건입니다. 실행 경로에는 세션 에이전트의 위임 또는 session.rpc.tasks.startAgent에서 agentType: "security-review"를 사용하는 방식이 있습니다. 이 호출을 실제 연동 코드에서 시험하지 않았으므로 본문을 완성된 실행 예제나 호환성 검증으로 보지 마세요.

Copilot code review는 저장소 Settings의 Copilot, Code review 아래 Security에서 Secret scanning을 켜는 경로입니다. 그 뒤 PR에 Copilot 리뷰를 요청하거나 자동 리뷰를 설정하는 흐름이에요. 저장소 정책을 바꾸는 작업은 권한과 팀의 리뷰 규칙을 확인한 담당자가 결정해야 합니다.

개발자 도구에서 켠 옵션이 모든 다른 도구와 저장소로 자동 공유된다고 가정하지 않는 편이 좋습니다. 어느 도구에서 설정했고 어떤 변경을 실제로 검토했는지 구분해 남겨 주세요. 화면이나 옵션을 확인할 수 없다면 지원되는 것으로 추정해 진행하기보다 현재 제공 상태를 확인하는 것이 정확합니다.

추가 플랜이 없어도 AI 크레딧은 사용합니다

공지가 밝힌 제공 조건은 위 도구들에서 이미 Copilot security review나 Copilot code review를 쓸 수 있다면 새 secret scanning도 사용할 수 있다는 것입니다. 별도의 추가 플랜은 필요하지 않다고 안내합니다. 이를 모든 계정의 무조건적인 무료 검사로 표현하면 비용 조건을 빠뜨리게 됩니다.

검사는 Secret Protection AI Credit SKU로 AI 크레딧을 사용합니다. 실제 청구와 조직의 사용 한도는 계정에서 확인해야 해요. 이 글에서는 크레딧을 소비하지 않았고 파일 수나 변경 줄 수를 임의의 금액으로 환산하지 않았습니다. 검사 효과가 지출보다 크다는 계산도 하지 않았습니다.

SDK나 자동 리뷰에 통합하려는 담당자라면 어떤 변화에서 검사를 요청할지, 결과를 누가 확인할지, 사용량을 어디서 볼지 먼저 정하는 편이 좋습니다. 요청을 반복하는 정책은 편리해 보일 수 있지만 검토가 끝나지 않은 상태에서 비용과 작업을 늘릴 수 있어요. 구체적인 빈도는 서비스의 실제 흐름과 조직 규칙에 맞춰 결정해야 합니다.

설정 변경의 승인과 검사 실행의 승인도 구분해 주세요. 특히 개발 에이전트가 작업을 마칠 때 자동으로 보안 리뷰를 요청하도록 연결한다면, 사용할 도구와 실제 변경 범위·부작용·비용을 담당자가 이해할 수 있어야 합니다. 기존 권한과 보안 규칙을 우회해 기능을 켜는 방법은 이 글의 범위가 아닙니다.

비교할 때는 검사 요청 수와 확인한 결과 수를 같은 값으로 두지 마세요. 요청이 접수된 뒤 실패하거나 아직 결과를 확인하지 못했다면 그 상태로 남기는 편이 정확합니다. 실제 변화가 없는 재요청과 변경 뒤의 새 검토를 나누면 결과와 비용을 설명할 때도 도움이 됩니다.

내부 보고에서는 대상 도구, 실제 설정, 검토한 변경, 요청·결과 시점, 발견 사항의 처리 상태를 함께 남겨 보세요. 이는 이 기능이 자동으로 만들어 주는 감사 체계를 보장한다는 말이 아니라, 팀이 빠진 단계를 찾도록 돕는 기록 제안입니다.

발견했다면 코드 수정과 비밀값 교체를 나누세요

검사에서 비밀정보로 의심되는 값이 나왔다면 먼저 실제 자격증명인지와 노출 범위·서비스 영향을 담당자가 확인해야 합니다. 공지의 흐름은 발견 사항을 바탕으로 수정하고 다시 리뷰를 요청하는 방식입니다. 표시된 줄을 지웠다는 사실을 실제 키가 폐기됐거나 서비스 접근이 차단됐다는 증거로 쓰면 안 됩니다.

일반 secret scanning 문서는 노출 알림을 받으면 영향을 받은 자격증명을 즉시 교체하도록 안내합니다. 과거 Git 이력에서 문자열을 지우는 작업은 별개이며, 이미 폐기한 자격증명이라면 이력 정리가 항상 필요한 것은 아니라는 설명도 있습니다. 이력 수정은 협업과 저장소에 영향을 주므로 별도 판단이 필요해요.

키의 폐기·교체는 발급자와 서비스를 아는 권한 있는 담당자가 수행해야 합니다. 운영에서 사용 중인 값을 갑자기 끊으면 연결이 중단될 수 있으므로 새로운 값의 안전한 배포와 기존 값의 무효화, 실제 서비스 동작 확인을 함께 계획해야 합니다. 이 글은 실제 키를 조회·발급·폐기하거나 운영 설정을 바꾸지 않았습니다.

에이전트가 만든 변경에도 같은 기준을 적용해 주세요. AI가 생성한 문자열이라는 이유로 시험용이라고 단정하지 말고 실제 자격증명과 연결되는지 확인하는 편이 안전합니다. 반대로 탐지 표시 하나를 실제 침해 사고나 악성 의도의 확정 증거로 표현해서도 안 됩니다. 확인한 사실과 추정은 구분해야 합니다.

테스트를 위해 실제 키를 코드에 넣을 필요도 없습니다. 기능을 검토한다면 조직에서 허용한 가상 자료와 비운영 환경을 사용하고, 검토 보고서나 대화에 민감한 값을 다시 복사하지 않는 것이 좋습니다. 이 글에는 실제 비밀값이나 검출용 자격증명 예시를 넣지 않았습니다.

수정 후에는 어떤 변경이 달라졌는지와 다시 받은 리뷰 결과를 연결해 보세요. 탐지 결과가 사라진 이유가 코드에서 제거됐기 때문인지, 설정·대상·실행 상태가 달라졌기 때문인지 구분할 근거가 필요합니다. 남은 확인을 지운 채 모든 위험이 해소됐다고 마감하지 않는 편이 정확합니다.

자주 묻는 질문과 병합 전 확인

security-review를 쓰고 있었다면 새 탐지기도 켜진 건가요? 아닙니다. 기본값은 꺼짐이며 선택하기 전에는 기존 LLM 기반 탐지를 사용합니다. 자신의 도구에서 실제 옵션과 리뷰 결과를 구분해 확인해 주세요.

검사 결과가 없으면 저장소 전체가 안전한가요? 이번 요청형 검사는 변경을 살피며 Git 이력을 검색하지 않습니다. 패턴 지원과 문맥 판단에도 범위가 있으므로 결과가 없다는 사실을 모든 노출 경로의 안전 보장으로 표현할 수는 없습니다.

새 플랜이 필요 없으면 추가 사용량도 없나요? 플랜 조건과 사용량은 다릅니다. 발표는 기존 리뷰 사용자가 추가 플랜 없이 쓸 수 있다고 하면서 AI 크레딧 사용도 명시합니다. 실제 비용은 계정의 제공 상태와 사용 기록으로 확인해야 합니다.

병합 전에 무엇을 남겨 두면 좋을까요? 실제로 켠 도구와 옵션, 검토한 변경, 결과·미확인 상태, 발견 사항의 수정과 발급자 조치를 구분해 남겨 보세요. 보안 리뷰는 사람이 읽는 변경 검토와 조직의 비밀정보 관리 규칙을 보완하는 경로로 이해하는 것이 좋겠습니다. 이 글은 특정 탐지 조합이 모든 노출을 막는다고 보장하지 않습니다.

자료 확인일은 2026년 11월 18일입니다. 공식 발표와 현재 문서로 확인한 범위이며, 실제 계정 설정 변경·명령 실행·성능 시험은 하지 않았어요. 적용 시점의 계정·버전·환경과 승인 범위는 담당자가 다시 확인해 주세요.

함께 읽어 볼 글: 노출된 토큰의 탐지와 실제 교체를 구분하는 글.

새 코드 변경을 나타내는 종이 폴더와 돋보기·분리한 열쇠 모양 종이 옆에 닫힌 이력 상자가 있는 개념 그림
새 변경의 검토와 저장소 이력 확인을 구분한 개념 이미지입니다. 실제 비밀값이나 탐지 결과·보안 보장을 나타내지 않습니다.