문서

보안 및 배포

에이전트 작업이 실행되는 위치, 액세스 및 데이터 보호 방식, 결정 이력에 기록되는 내용, 그리고 지원되는 배포 모델에 대해 설명합니다.

CoRoid는 귀사의 코드에 대해 자율적인 엔지니어링 작업을 수행합니다. 이 페이지에서는 해당 작업이 실행되는 위치, 접근 가능한 범위, 인증 정보 및 데이터가 보호되는 방식, 그리고 남겨지는 기록에 대해 설명합니다. 또한 현재 적용된 제어 기능도 소개합니다. 계획 중인 제어 기능은 '계획됨'으로 표시됩니다.

에이전트 작업이 실행되는 위치

각 작업은 고유한 격리된 클라우드 워크스페이스에서 실행됩니다. 해당 워크스페이스는 작업을 위해 생성된 후 작업 완료 시 삭제됩니다. 에이전트는 해당 워크스페이스에 체크아웃된 저장소에 대해서만 읽기 및 쓰기 작업을 수행합니다.

총 세 개의 영역이 있습니다:

영역소유자포함 내용
에이전트 워크스페이스CoRoid하나의 작업에 대한 체크아웃, 빌드 및 테스트 도구입니다. 작업별로 생성되며 작업 완료 후 삭제됩니다.
제어 플레인CoRoid일정 관리, 사양, 증거 및 의사결정 이력이 저장됩니다. 프로젝트 범위 내의 인증 정보는 암호화된 구성 파일에 보관됩니다.
사용자의 네트워크 및 운영 환경사용자에이전트 워크스페이스에서 접근할 수 없습니다.
  1. 에이전트 작업 공간CoRoid에서 실행단일 작업을 위한 체크아웃, 빌드 및 테스트 도구 모음
  2. 제어 플레인CoRoid에서 실행일정 관리, 사양 명세, 증거 자료 및 결정 내역. 인증 정보는 암호화된 상태로 보관됩니다.
  3. 사용자 네트워크 및 운영 환경사용자 소유IDE 확장 프로그램이나 로컬 에이전트, 네트워크 접근이 필요하지 않습니다.

에이전트 워크스페이스는 사용자의 네트워크나 운영 환경에 접근할 수 없습니다.

유일한 출력물은 pull request이며, 병합 여부는 팀에서 결정합니다.

각 작업은 전용 워크스페이스를 가지며, 작업 완료 후에는 해당 워크스페이스가 삭제됩니다. 작업 결과는 오직 pull request 형태로만 남으며, 이후에는 사용자 지정 배포 경로를 통해 처리됩니다.

작업 결과는 하나의 형태로 워크스페이스를 떠납니다: 바로 pull request입니다. 귀사 팀에서 이를 병합할지 여부를 결정하며, 이후에는 자체 배포 경로를 통해 처리됩니다. CoRoid는 IDE 확장 프로그램이나 로컬 에이전트, 또는 귀사의 사내 네트워크 접근 권한이 필요하지 않습니다.

워크스페이스가 인터넷에 접근할 수 있는 범위

코드를 빌드하고 테스트하는 워크스페이스는 공용 인터넷 주소에 직접 접근할 수 있어 개발자 머신에서와 동일하게 설치 및 다운로드가 가능합니다. 단, 클러스터의 내부 네트워크, 클라우드 메타데이터 서비스 및 개인 IP 범위에는 접근할 수 없습니다.

샌드박스 네트워크, 아래에보안 → 설정, 대신 특정 범위의 워크스페이스를 CoRoid의 아웃바운드 프록시를 통해 전송합니다. 이 기능은 조직 기본 설정 또는 개별 프로젝트별로 활성화하기 전까지는 비활성 상태이며, 모든 요금제에서 사용할 수 있습니다:

  • 활성화(모니터링 모드).모든 연결은 프록시를 통해 이루어지며, 프록시는 작업의 호스트 및 포트 정보만 기록하고 경로나 콘텐츠는 기록하지 않습니다. 어떠한 요청도 거부되지 않습니다.
  • 허용되지 않은 항목 차단(강제 적용 모드), 보호 설정 패널에서 선택됩니다. 이 프록시는 공용 패키지 레지스트리(npm, PyPI, Go 모듈, crates.io, RubyGems, Maven Central 및 Gradle, NuGet, Packagist, Hex, pub.dev, conda), 프로젝트의 Git 호스트 및 설정의 허용 목록에 포함된 호스트를 사용할 수 있도록 지원하며, 그 외의 모든 호스트는 차단합니다. 차단 후에 명령이 실패하면 에이전트에게 어떤 호스트가 왜 거부되었는지 알려줍니다.

패널에는샌드박스가 연결된 내역지난 30일간의 내역을 확인할 수 있으며, 각 호스트 및 포트, 해당하는 작업 및 연결 횟수, 마지막으로 접근한 작업, 허용/차단 여부, 또는 강제 적용 모드에서의 차단 예정 여부가 표시됩니다.허용호스트를 목록에 추가할 수 있습니다. 먼저 모니터링 모드로 시작하면 강제 적용 모드에서 차단될 항목을 미리 확인할 수 있습니다.

작업의네트워크해당 섹션의 Factory 뷰에서는 워크스페이스가 도달한 대상 목록을 거부 항목부터 순서대로 표시합니다. CoRoid가 직접 실행하는 스캔(예: 보안 스캔)의 경우 해당 워크스페이스는 별도의 작업으로 처리되며, 그 작업에는 어떤 스캔인지와 동일한 방식으로 도달한 대상 목록이 포함됩니다.

두 모드 모두에서 원시 TCP 연결과 같은 프록시를 우회하는 연결은 실패하며, 프록시는 사내 주소로 연결되지 않습니다. 도구들은 CoRoid가 설정한 표준 프록시 변수를 통해 프록시를 인식하며, Maven은 오직settings.xml에서만 프록시 정보를 읽기 때문에 샌드박스 네트워크가 활성화된 상태에서는 Maven 빌드가 인터넷에 접근할 수 없습니다. 호스트 이름 조회는 여전히 클러스터의 리졸버를 통해 이루어집니다. 이 설정은 이후 생성되는 워크스페이스에 적용됩니다.

허용 목록 항목은 호스트(api.example.com), 하위 도메인(*.example.com), 또는 포트와 함께 지정된 항목(example.com:8443; 포트를 지정하지 않으면 80번과 443번 포트가 적용됨). 자체 설정을 가진 프로젝트는 별도의 모드 및 목록을 가지며,기본 설정을 사용하세요조직의 설정으로 되돌아갑니다. 이 설정은설정 이식성보안 섹션의 다른 설정과 마찬가지로 적용됩니다.

ID 및 접근 권한

인증은 게이트웨이에서 중앙 집중식으로 관리됩니다. 지원되는 방식은 다음과 같습니다:

  • 포털 접속을 위한 JWT 기반 사용자 세션
  • 관리형 로테이션 기능이 적용된 서비스 간 토큰
  • 외부 연동을 위한 API 키
  • 사용자, 서비스 및 혼합 접근 엔드포인트를 위한 보안 장치

저장소 접근 권한은 프로젝트 단위로 제한됩니다. 한 프로젝트의 인증 정보는 다른 프로젝트에서 사용될 수 없으며, CoRoid는 단일 저장소 작업을 위해 조직 전체의 인증 정보가 필요하지 않습니다. 자세히 보기코드를 연결하세요.

조직 소유자 및 관리자는 '보안' 메뉴에서 멤버, 세션 및 보안 이벤트 피드를 관리합니다.설정 → ID 및 접근 권한. SCIM 프로비저닝 기능이 포함된 SSO/SAML는 Enterprise 요금제에 속하며, 현재비공개 프리뷰.

데이터 보호

  • 데이터는 전송 중 및 저장 시에 암호화됩니다.
  • 귀사 조직의 인증 정보(예: 제공업체 키, 저장소 토큰, 기타 통합 비밀번호)는 귀사 조직 고유의 데이터 키로 암호화됩니다. 해당 데이터 키는 키 관리 서비스를 통해 다시 암호화됩니다. 이를 복호화할 수 있는 것은 CoRoid의 인증 정보 브로커뿐이며, 모든 사용 내역은 기록됩니다. 자세히 보기공급자 키.
  • CoRoid 자체의 구성 비밀번호도 암호화되어 저장됩니다.
  • 공용 클라우드 서비스는EU 호스팅 프로필을 GDPR 또는 데이터 거주 요건이 있는 팀을 위해 제공합니다.EU 전용AI 프로필은 모델 추론을 EU에 호스팅된 제공업체에서 처리하도록 합니다. 자세한 내용은AI 프로필.
  • 실행 이력, 대본 및 아티팩트의 보관 기간은 사용자가 직접 제어할 수 있습니다. 자세한 내용은데이터 보존.

결정 추적 내역

모든 자동화된 변경 사항은 리뷰어와 보안 팀이 이미 사용하는 용어로 설명됩니다:

  • 사양, 에이전트 활동, 리뷰 및 승인 결정이 해당 작업과 연계되어 유지됩니다.
  • 실행 추적 내역에는 실패한 시도와 그 원인을 포함하여 각 에이전트 실행 내용이 기록됩니다.
  • 풀 요청 이력에는 코드가 병합되기 전의 최종 증거가 표시됩니다.
  • 보안, 의존성, 커버리지, 시각적, 엔드투엔드 및 브라우저 테스트 증거를 리뷰에 첨부할 수 있습니다. 자세한 내용은리뷰 증거.

병합 게이트를 통해 운영 환경 변경 사항을 명시적 정책으로 관리합니다. 귀하의품질 게이트요건을 충족하지 않으면 코드는 병합될 수 없습니다.

운영 작업

  • CI 단계에서 SBOM 생성 및 컨테이너 이미지 스캔
  • TLS 종료 기능이 적용된 HTTPS 전용 공용 엔드포인트
  • 자동화된 데이터베이스 스냅샷 및 복원 런북
  • 메트릭, 로그 및 오류에 대한 모니터링 및 알림 기능

배포 옵션

CoRoid는 세 가지 운영 모델로 실행됩니다. 각 모델에서의 워크플로우는 동일하지만, 런타임, 스토리지, 저장소 접근 및 인증 정보의 위치는 달라집니다.

모델사용 가능 여부실행 위치
클라우드일반적으로 사용 가능CoRoid가 운영하며, 선택적으로 EU 호스팅 프로필을 적용할 수 있습니다.
엔터프라이즈 클라우드비공개 미리보기CoRoid가 운영하며, 계약된 용량, SSO/SAML, SCIM 및 감사 내역 내보내기 기능을 제공합니다.
온프레미스비공개 미리보기귀사의 인프라에서 Docker Compose 또는 Kubernetes를 사용합니다.

온프레미스

온프레미스 배포를 이용하면 규제를 받는 팀이 저장소 접근 권한, 스토리지, 자격 증명 및 네트워크 정책을 자신들이 관리하는 인프라 내에 유지할 수 있습니다.

  • Docker Compose는 단일 서버 설치 및 파일럿 환경에 적합합니다. 영구 볼륨에 데이터베이스, 저장소 및 로그가 저장됩니다.
  • Kubernetes는 다중 서버 및 자동 확장 설치에 적합합니다. Helm이 애플리케이션, 작업자, 동기화 및 러너 서비스를 관리하며, 관리형 또는 자체 호스팅된 PostgreSQL 및 객체 스토리지를 지원합니다.
  • 제한된 네트워크는 오프라인 모델 및 의존성 전략, 자체 호스팅된 비밀번호 관리 기능 및 내부 TLS를 사용할 수 있습니다.

Git 접근 권한은 타사 앱 설치가 아닌 개인용 액세스 토큰을 사용하며, 내부 저장소 호스트를 지정할 수도 있습니다.

인증

CoRoid는 현재 SOC 2 보고서나 기타 타사 보안 인증을 보유하고 있지 않습니다. SOC 2는 준비 완료를 위한 목표이며, 인증을 받기 전까지는 해당 제어 기능을 '인증됨'으로 표시하지 않습니다.