# Harbor v2.13.6

2026-10-06 · [릴리스 노트 원문](https://github.com/goharbor/harbor/releases/tag/v2.13.6) · [전체 정리](https://ratatosk.io/ko/releases/harbor/v2.13.6)

보안 13 (high 5) · 의존성 갱신 1

## 업그레이드 전 확인

### 알려진 문제

- **일부 레지스트리에서 푸시 복제 실패** · v2.14.6에서 수정됨: 일부 레지스트리는 업로드 `Location`을 반환하지만, 이번 릴리스는 이를 크로스 오리진으로 판단해 거부하므로 푸시 복제가 실패합니다. 릴리스 노트는 향후 패치에서 이 문제가 수정된다고 안내합니다.
  > > [!WARNING]
  > > **Known Issue: Push Replication Fails for Specific Registries such as AWS ECR (GHSA-wjpm-hv5w-gxr6 Regression)**
  > >
  > > The security fix for GHSA-wjpm-hv5w-gxr6 strictly validated upload Location headers against the statically configured registry endpoint (c.url). Because the AWS ECR adapter configures the API control-plane endpoint (https://api.ecr.<region>.amazonaws.com) while requests are rewritten to the data-plane host (<account>.dkr.ecr.<region>.amazonaws.com), ECR's response Location header is rejected as a cross-origin target.
  > >
  > >Workaround / Resolution:
  > >
  > > A fix has been provided in PR [#24113](https://github.com/goharbor/harbor/pull/24113) and will be released in the upcoming patch release.
  > > If your environment depends on push replication, we recommend postponing the upgrade until the next patch release or applying the patch directly.

## 보안 (13)

### [high] Harbor, 점 세그먼트가 포함된 `/v2/` 요청 거부

- 영향 대상: Harbor `/v2/` 레지스트리 API
- [GHSA-qj39-pjf2-wmrc](https://github.com/goharbor/harbor/security/advisories/GHSA-qj39-pjf2-wmrc)

수정 전에는 `.` 또는 `..` 경로 세그먼트를 넣어 조작한 요청이 한 저장소에 대한 권한 검사를 통과한 뒤 다른 저장소에 도달할 수 있었습니다. 공개 프로젝트가 하나라도 있으면 로그인하지 않은 사용자도 모든 프로젝트의 매니페스트를 읽을 수 있었고, 한 프로젝트에 푸시 권한이 있는 사용자는 다른 프로젝트의 태그와 매니페스트를 변경하거나 삭제할 수 있었습니다. 이제 이런 요청에는 HTTP 400을 반환합니다.

> * (high): Path traversal vulnerability in distribution endpoints [GHSA-qj39-pjf2-wmrc](https://github.com/goharbor/harbor/security/advisories/GHSA-qj39-pjf2-wmrc) in [`a82c5528f`](https://github.com/goharbor/harbor/commit/a82c5528f1e939a78f2ce9acab9ecd03ee90b98f)

### [high] 시스템 로봇의 `Project` 권한을 프로젝트 내부로 제한

- 영향 대상: 범위가 `Cover all projects`이고 `Project` 리소스 권한이 있는 시스템 로봇
- [GHSA-xq2m-cj8w-56v5](https://github.com/goharbor/harbor/security/advisories/GHSA-xq2m-cj8w-56v5)

이전 릴리스에서는 해당 권한으로 여러 프로젝트의 리소스가 노출될 수 있었습니다. `Project: Read` 권한으로 리소스를 읽을 수 있었고, `Project: Delete` 권한으로 리소스를 삭제할 수 있었습니다. 로봇 토큰을 완전히 신뢰할 수 없는 사람이나 시스템이 보유한 경우 위험이 있었습니다. 업그레이드 후에는 리포지토리, 아티팩트, 멤버, 로봇 계정 및 기타 프로젝트 내부 리소스에 접근하려면 각각 별도의 권한을 부여해야 합니다.

> * (high): Robot "cover all projects" scope collapses into a global wildcard, conferring the deliberately-ungrantable robot:update — enabling cross-project robot takeover with owner lockout [GHSA-xq2m-cj8w-56v5](https://github.com/goharbor/harbor/security/advisories/GHSA-xq2m-cj8w-56v5) in [`7331b58d5`](https://github.com/goharbor/harbor/commit/7331b58d594f245aaf7f70515473aedffff85499)

### [high] Registry API 관리자 권한의 auth-proxy 설정 연동

- 영향 대상: `auth_mode = http_auth`를 사용하는 HTTP auth-proxy 배포 환경
- 추가 조치: Harbor UI 관리자 상태를 이용해 Registry API에 접근하는 사용자 또는 그룹을 위한 `http_authproxy_admin_usernames` 또는 `http_authproxy_admin_groups` 항목
- [GHSA-xvh7-74g6-29xw](https://github.com/goharbor/harbor/security/advisories/GHSA-xvh7-74g6-29xw)

auth-proxy 토큰의 사용자 이름이 로컬 Harbor 시스템 관리자와 일치하면, `admin`을 포함해 프록시에서 관리자 권한을 부여하지 않았어도 `/v2/` 요청에 관리자 권한이 상속될 수 있었습니다. 그 결과 여러 프로젝트에서 pull, push, delete가 가능했습니다. 업그레이드 후에는 로컬 Harbor 관리자 플래그만으로 해당 요청에 관리자 권한이 부여되지 않습니다. 관리자 권한은 auth-proxy 관리자 설정에 의해서만 부여됩니다.

> * (high): External auth-proxy identity named admin inherits Registry system-administrator authorization [GHSA-xvh7-74g6-29xw](https://github.com/goharbor/harbor/security/advisories/GHSA-xvh7-74g6-29xw) in [`13e5a1b97`](https://github.com/goharbor/harbor/commit/13e5a1b979d90d346716c19eefc5f6cfa31dce0e)

### [high] 내부 웹훅 및 Slack 전송 기본 차단

- 영향 대상: 완전히 신뢰할 수 없는 사용자가 프로젝트 관리자가 될 수 있고, jobservice가 웹훅 또는 Slack 알림 대상으로 지정된 내부 서비스나 클라우드 메타데이터에 접근할 수 있는 Harbor 구성
- [GHSA-2phj-cp9f-qq6w](https://github.com/goharbor/harbor/security/advisories/GHSA-2phj-cp9f-qq6w)

이전 릴리스에서는 프로젝트 관리자가 내부 주소를 대상으로 HTTP 또는 Slack 웹훅을 설정할 수 있었습니다. jobservice가 해당 주소에 접근할 수 있고 주소에서 오류를 반환하면, 응답 본문이 웹훅 실행 로그에 기록됐습니다. 업그레이드 후에는 내부 엔드포인트로 보내는 기존 전송이 실패하고 새 전송도 기본적으로 거부됩니다. `network.allow_private_network_access: true`로 설정하거나 `core.extraEnvVars`와 `jobservice.extraEnvVars` 모두에서 `HARBOR_ALLOW_PRIVATE_NETWORK_ACCESS`를 `"true"`로 설정하면 보호 기능이 비활성화됩니다. 이 설정은 모든 프로젝트 관리자를 신뢰할 수 있고 네트워크 수준에서 `169.254.169.254`를 차단한 경우에만 사용해야 합니다.

> > [!WARNING]
> > **Breaking change: webhooks to internal addresses are blocked by default**
> > The fix for [GHSA-2phj-cp9f-qq6w](https://github.com/goharbor/harbor/security/advisories/GHSA-2phj-cp9f-qq6w) blocks webhook and Slack delivery to private, loopback, link-local and other non-public addresses. That includes hostnames that resolve to them, such as `*.svc.cluster.local`. After you upgrade, existing webhooks to internal endpoints fail to deliver, and new ones are rejected.
> > To allow them again, set the opt-out on **both core and jobservice**:
> > - `harbor.yml`: `network.allow_private_network_access: true`, then `./prepare` and restart
> > - Helm: add `{name: HARBOR_ALLOW_PRIVATE_NETWORK_ACCESS, value: "true"}` to both `core.extraEnvVars` and `jobservice.extraEnvVars`
> > This disables the protection entirely. Only use it if you trust all project admins, and block `169.254.169.254` at the network level.
> * (medium): SSRF in webhook delivery allows ProjectAdmin to reach internal services and cloud metadata endpoints [GHSA-2phj-cp9f-qq6w](https://github.com/goharbor/harbor/security/advisories/GHSA-2phj-cp9f-qq6w) in [`fb476e10c`](https://github.com/goharbor/harbor/commit/fb476e10c9f981bd994011563bef6c5292ec272c)

### [high] Harbor 시스템 관리자 플래그 변경을 시스템 관리자에게만 허용

- 영향 대상: `User: Update` 권한이 있는 시스템 로봇 계정
- [GHSA-w5fq-xrhj-j7g2](https://github.com/goharbor/harbor/security/advisories/GHSA-w5fq-xrhj-j7g2)

이런 로봇의 토큰을 충분히 신뢰할 수 없는 사람이나 시스템이 보유하면, Harbor 사용자의 시스템 관리자 권한을 부여하거나 회수할 수 있었습니다. 업그레이드 후에는 해당 작업이 HTTP 403을 반환하지만, 로봇의 다른 사용자 업데이트 작업은 변경되지 않습니다.

> * (high): A system robot with user:update makes itself a system administrator [GHSA-w5fq-xrhj-j7g2](https://github.com/goharbor/harbor/security/advisories/GHSA-w5fq-xrhj-j7g2) in [`8896be0ae`](https://github.com/goharbor/harbor/commit/8896be0aed0dbbd2b59d1524b748b4699e823c39)

### [medium] Harbor 이미지 pull 정책의 User-Agent 예외 제거

- 영향 대상: Content trust 또는 취약한 이미지 실행 방지 정책을 적용하는 프로젝트
- [GHSA-wrw5-gmvj-gf23](https://github.com/goharbor/harbor/security/advisories/GHSA-wrw5-gmvj-gf23)

이전에는 프로젝트 푸시 권한이 있는 사용자나 로봇이 `cosign` 또는 `notation` `User-Agent`를 사용해 두 정책 중 하나에 의해 차단된 이미지를 pull할 수 있었습니다. 이제 이러한 pull은 차단됩니다. 따라서 Content trust 프로젝트에서 서명되지 않은 새 이미지에 서명하려 하면 `412 Precondition Failed` 오류가 발생하지만, 이미 서명된 이미지는 계속 pull할 수 있습니다. `CONTENT_TRUST_LEGACY_SIGNER_PULL_ENABLED=true`로 설정하면 Content trust에 한해, 푸시 권한이 있는 사용자나 로봇의 예외가 복원됩니다.

> > [!WARNING]
> > **Breaking change: signing unsigned images fails when content trust is enforced**
> >
> > The fix for [GHSA-wrw5-gmvj-gf23](https://github.com/goharbor/harbor/security/advisories/GHSA-wrw5-gmvj-gf23) removes the User-Agent based exemption that let `cosign` and `notation` pull unsigned images. In projects that only allow signed images, `cosign sign` and `notation sign` on a new, unsigned image now fail with `412 Precondition Failed`. Images that already have a signature are not affected.
> >
> > To allow signing clients again, set `CONTENT_TRUST_LEGACY_SIGNER_PULL_ENABLED=true` on **core**. The value must be exactly `true`.
> > - Helm: add it to `core.extraEnvVars`
> > - `harbor.yml` installs: there is no `harbor.yml` option. Add it to `common/config/core/env` and restart. Re-running `./prepare` overwrites that file.
> >
> > The exemption still trusts the client's User-Agent, but only for users or robots with push permission on the project. Projects that block vulnerable images have no opt-out: a signing client can no longer pull an image that the vulnerability policy blocks.
> * (medium): Vulnerability & Content-Trust pull policies bypassable via attacker-controlled `User-Agent` header [GHSA-wrw5-gmvj-gf23](https://github.com/goharbor/harbor/security/advisories/GHSA-wrw5-gmvj-gf23) in [`9d255ebe1`](https://github.com/goharbor/harbor/commit/9d255ebe1ad3cae00929af2f8100cec566d9ee97)

### [medium] 다중 셀렉터 불변 태그 규칙의 올바른 적용

- 영향 대상: 여러 리포지토리 셀렉터 또는 태그 셀렉터가 포함된 불변 태그 규칙을 사용하는 프로젝트
- [GHSA-27f2-qg57-2gwg](https://github.com/goharbor/harbor/security/advisories/GHSA-27f2-qg57-2gwg)

이전에는 규칙이 각 유형의 첫 번째 패턴만 확인해, 뒤에 오는 셀렉터에 일치하는 태그는 변경 가능한 상태로 남아 덮어쓰거나 삭제할 수 있었습니다. 이제 뒤에 오는 셀렉터에 일치하는 태그도 보호되며, 이를 덮어쓰는 푸시와 삭제 시도는 거부됩니다.

> * (medium): Immutable tag rule matcher only evaluates first repository/tag selector, allowing multi-selector rules to be bypassed [GHSA-27f2-qg57-2gwg](https://github.com/goharbor/harbor/security/advisories/GHSA-27f2-qg57-2gwg) in [`08c58f3c7`](https://github.com/goharbor/harbor/commit/08c58f3c76bd8e9252996a3cc62dade10d4e3ab4)

### [medium] 스캐너 자격 증명 필터 노출 수정

- 영향 대상: 인증된 스캐너 등록이 있는 Harbor 설치
- [GHSA-vwvv-675v-p6rr](https://github.com/goharbor/harbor/security/advisories/GHSA-vwvv-675v-p6rr)

신뢰할 수 없는 사용자가 프로젝트 관리자가 될 수 있는 경우, `q` 필터 쿼리를 반복하면 저장된 스캐너 자격 증명이 한 번에 한 글자씩 노출될 수 있었습니다. 노출 여부는 자격 증명을 평문으로 복구할 수 있는지에도 달려 있었습니다. 이제 `access_cred`를 필터로 사용할 수 없으며, 스캔 동작은 변경되지 않았습니다.

> * (medium): scanner_registration.access_cred is missing filter:"false", giving a project admin a blind oracle over the scanner credential [GHSA-vwvv-675v-p6rr](https://github.com/goharbor/harbor/security/advisories/GHSA-vwvv-675v-p6rr) in [`d2e2312f5`](https://github.com/goharbor/harbor/commit/d2e2312f5735777b37041674bb146bcbd02fc054)

### [medium] 스캐너 베어러 토큰 요청의 TLS 검증 및 응답 크기 제한

- 영향 대상: 베어러 인증을 사용하는 스캐너로 실행하는 스캔 작업 중 `core_url`이 HTTPS이고 jobservice와 core 간 트래픽이 신뢰할 수 없는 네트워크를 통과하는 작업
- [GHSA-884q-mjcg-86x4](https://github.com/goharbor/harbor/security/advisories/GHSA-884q-mjcg-86x4)

이전에는 토큰 요청에서 인증서 검증을 건너뛰었고, 응답 크기 제한이나 타임아웃도 없었습니다. 그 결과 임시 스캔 자격 증명이 가로채기에 노출되거나 임의로 큰 응답이 메모리에 읽혀 들어갈 수 있었습니다. 이제 core 인증서를 검증하고 응답 크기를 1 MiB로 제한하며 30초 후 타임아웃됩니다. 신뢰할 수 없는 인증서로 인해 스캔이 인증서 오류와 함께 실패할 수 있습니다.

> * (medium): Scanner bearer authorization request disables TLS verification and reads the full response body [GHSA-884q-mjcg-86x4](https://github.com/goharbor/harbor/security/advisories/GHSA-884q-mjcg-86x4) in [`eb1a6fb64`](https://github.com/goharbor/harbor/commit/eb1a6fb6424d523213eeac1faffd938cc687f2af)

### [medium] jobservice 웹훅 오류 처리 수정

- 영향 대상: 웹훅을 사용하는 Harbor 설치 환경
- [GHSA-jw3v-7jvc-pfmx](https://github.com/goharbor/harbor/security/advisories/GHSA-jw3v-7jvc-pfmx)

웹훅 수신기가 오류를 반환하면 jobservice는 크기 제한 없이 응답 본문 전체를 읽고 자동으로 압축을 해제해 실행 로그에 기록했습니다. 이로 인해 메모리 사용량이 크게 늘어 작업이 지연되거나 실패할 수 있었습니다. 이제 오류 응답 본문은 최대 64 KiB까지만 버리고 상태 코드만 로그에 기록합니다. 리디렉션은 따라가지 않으므로 3xx 응답은 전달 실패로 기록됩니다.

> * (medium): Webhook error responses can cause unbounded decompression in Jobservice [GHSA-jw3v-7jvc-pfmx](https://github.com/goharbor/harbor/security/advisories/GHSA-jw3v-7jvc-pfmx) in [`fb476e10c`](https://github.com/goharbor/harbor/commit/fb476e10c9f981bd994011563bef6c5292ec272c)

### [medium] 안전하지 않은 레지스트리 업로드 `Location` 거부

- 영향 대상: 원격 레지스트리로 푸시 기반 복제를 수행하는 경우
- 추가 조치: 업로드를 다른 호스트 이름으로 넘기는 대상에서는 설정한 엔드포인트 URL에 해당 호스트 이름 사용
- [GHSA-wjpm-hv5w-gxr6](https://github.com/goharbor/harbor/security/advisories/GHSA-wjpm-hv5w-gxr6)

이전 릴리스에서 Harbor는 원격 레지스트리의 업로드 `Location`이 같은 레지스트리로 돌아가는지 확인하지 않고 사용했으며, blob 데이터와 레지스트리 `Authorization` 헤더를 해당 위치로 전송했습니다. 이제 스킴, 호스트 또는 포트가 다르거나 사용자 이름이 포함된 업로드 위치는 거부되고 복제 작업은 실패합니다. 상대 위치는 계속 사용할 수 있습니다.

> * (medium): Registry chunk upload reuses unvalidated Location headers [GHSA-wjpm-hv5w-gxr6](https://github.com/goharbor/harbor/security/advisories/GHSA-wjpm-hv5w-gxr6) in [`401e73429`](https://github.com/goharbor/harbor/commit/401e7342963c4c406fd103cf2931e8aac95d320d)

### [medium] 복제 클라이언트의 잘못된 페이지네이션 링크 거부

- 영향 대상: 원격 레지스트리에서 저장소 또는 태그 목록을 페이지네이션하는 풀 기반 복제
- 추가 조치: 페이지네이션 링크에 다른 호스트명을 사용하는 원격 레지스트리의 경우 Harbor 엔드포인트 URL에 해당 호스트명 지정
- [GHSA-xgp2-5vxg-rgh2](https://github.com/goharbor/harbor/security/advisories/GHSA-xgp2-5vxg-rgh2)

이전에는 Harbor가 원격 `Link` 헤더의 목적지를 확인하지 않고, 저장된 레지스트리 인증 정보를 요청에 함께 실어 보냈습니다. 이제는 다른 스킴, 호스트 또는 포트를 가리키거나 사용자 이름을 포함하는 `next` 링크가 있으면 오류와 함께 목록 조회를 중단하고 복제에 실패합니다.

> * (medium): SSRF and credential disclosure via attacker-controlled pagination Link header in the registry replication client [GHSA-xgp2-5vxg-rgh2](https://github.com/goharbor/harbor/security/advisories/GHSA-xgp2-5vxg-rgh2) in [`a01e0c6c5`](https://github.com/goharbor/harbor/commit/a01e0c6c561458fc719a16310d02b928a87e589a)

### 인증 모드 조회 실패 시 요청을 거부하는 Harbor 보안 미들웨어

- 영향 대상: Harbor core에 설정된 인증 모드
- [GHSA-3x7c-wf86-mjx6](https://github.com/goharbor/harbor/security/advisories/GHSA-3x7c-wf86-mjx6)

데이터베이스나 구성 캐시 장애 등으로 core가 설정된 인증 모드를 읽지 못하면, 미들웨어는 경고를 기록한 뒤 요청을 인증하지 않은 채 처리를 계속했습니다. 이제 해당 요청에는 HTTP 500 (`failed to determine authentication mode`)을 반환합니다. 정상 요청은 영향을 받지 않습니다.

> * (low): Security middleware continues after AuthMode lookup failure [GHSA-3x7c-wf86-mjx6](https://github.com/goharbor/harbor/security/advisories/GHSA-3x7c-wf86-mjx6) in [`bfd319a92`](https://github.com/goharbor/harbor/commit/bfd319a928460e50ad8f0536b5e163cefb24ef5c)

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `* fix: pin redis 7.2.11 instead of 7.2.6 in the redis base image by @bupd in https://github.com/goharbor/harbor/pull/24066`

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
