# Backstage v1.56.6

2026-11-17 · [릴리스 노트 원문](https://github.com/backstage/backstage/releases/tag/v1.56.6) · [전체 정리](https://ratatosk.io/ko/releases/backstage/v1.56.6)

보안 5 · 호환성 변경 2

## 업그레이드 전 확인

### 업그레이드 안내

- **1.56.6으로 업그레이드하는 Upgrade Helper**
  > Upgrade Helper: [https://backstage.github.io/upgrade-helper/?to=1.56.6](https://backstage.github.io/upgrade-helper/?to=1.56.6)

## 보안 (5)

### Kubernetes 프록시의 호출자 헤더 전달 중단

- 영향 대상: 대상 클러스터로 보내는 Kubernetes 프록시 요청 (추정)

이전에는 이러한 요청에서 호출자의 `Authorization` 및 `Cookie` 헤더를 전달했습니다. 이제 업스트림 인증 정보는 설정된 인증 전략이나 `Backstage-Kubernetes-Authorization` 헤더에서만 가져옵니다.

> - fd7fe0c: Kubernetes proxy: stop forwarding the caller's `Authorization` and `Cookie` headers to the target cluster. Upstream requests now carry only credentials from the configured auth strategy or the `Backstage-Kubernetes-Authorization` header.

### Azure DevOps 플레이스홀더 읽기를 엔티티 자체 리포지토리로 제한

- 영향 대상: Azure DevOps 통합이 구성된 카탈로그 엔티티 플레이스홀더

이 제한은 기존 `{org}.visualstudio.com` 호스트와 Azure DevOps Server 호스트에도 적용됩니다. 리포지토리에 귀속시킬 수 없는 대상은 거부됩니다.

> - e26964d: Improved repository validation for catalog entity placeholders on Azure DevOps. Placeholder-driven reads on a configured Azure DevOps integration are now restricted to the entity's own repository on every Azure DevOps host shape, including legacy `{org}.visualstudio.com` hosts and Azure DevOps Server hosts, and targets that cannot be attributed to a repository are rejected as well.

### Fetch 액션 자격 증명 호스트 검사 수정

- 영향 대상: `scaffolder.requireScmUserCredentials`가 활성화된 설정
- 추가 조치: `scaffolder.requireScmUserCredentials` 활성화

이전에는 두 호스트가 다를 때 fetch 액션이 fetch URL에서 확인한 호스트가 아니라 템플릿 위치의 호스트를 검사했습니다. 이제 fetch URL 자체를 절대 URL로 파싱할 수 없는 경우에도 확인된 호스트를 사용합니다.

> - e33b6d9: Check the host that relative fetch URLs resolve to when user credentials are required.
>   When `scaffolder.requireScmUserCredentials` is enabled, the fetch actions now apply the user-credential requirement to the host that the fetch URL resolves to, rather than the host of the template location. This makes the requirement effective also for fetch URLs that are not parseable as absolute URLs on their own.

### 스캐폴더 액션의 대상 저장소 외부 경로 거부

- 영향 대상: `gitlab:repo:push`, `publish:gitlab:merge-request` 또는 `publish:github:pull-request` 스캐폴더 액션을 사용하는 설정

`targetPath` 입력과 `publish:github:pull-request`의 `filesToDelete` 항목에서는 절대 경로와 `..` 세그먼트가 포함된 경로를 거부합니다. 변경 사항은 의도한 저장소 하위 디렉터리 안에만 적용됩니다.

> - b2d18d7: Validates the `targetPath` input of the `gitlab:repo:push`, `publish:gitlab:merge-request` and `publish:github:pull-request` scaffolder actions, and the `filesToDelete` entries of `publish:github:pull-request`. The values must be relative paths within the target repository; absolute paths and paths containing `..` segments are now rejected, so changes are only applied inside the intended subdirectory of the repository.

### GitLab 스캐폴더 액션의 안전하지 않은 경로 거부

- 영향 대상: `gitlab:repo:push`, `publish:gitlab:merge-request` 또는 `publish:github:pull-request`를 사용하는 GitLab 스캐폴더 구성. 후자의 `filesToDelete`도 포함

이 액션들의 `targetPath`와 `publish:github:pull-request`의 `filesToDelete`에서는 절대 경로와 `..` 세그먼트가 포함된 경로를 거부합니다. 따라서 변경은 대상 저장소 내 상대 경로로 제한됩니다.

> ## @backstage/plugin-scaffolder-backend-module-gitlab@0.12.3
> ### Patch Changes
> - b2d18d7: Validates the `targetPath` input of the `gitlab:repo:push`, `publish:gitlab:merge-request` and `publish:github:pull-request` scaffolder actions, and the `filesToDelete` entries of `publish:github:pull-request`. The values must be relative paths within the target repository; absolute paths and paths containing `..` segments are now rejected, so changes are only applied inside the intended subdirectory of the repository.

## 호환성 변경 (2)

### `validate-entity` 요청 위치가 엔티티 어노테이션보다 우선

- 영향 대상: location 어노테이션이 있는 엔티티를 `validate-entity` 엔드포인트에 제출하는 환경

이전에는 제출된 엔티티의 location 어노테이션이 요청 위치를 덮어쓸 수 있었습니다.

> - e6e35ab: Location annotations on entities submitted to the validate-entity endpoint can no longer override the location of the request.

### AsyncAPI 정의 위젯의 기본 외부 참조 해석 중단

- 영향 대상: 정의 위젯에서 외부 문서를 참조하는 AsyncAPI 정의

문서 전체를 참조하면 로드되지 않은 문서의 이름을 표시하는 플레이스홀더가 나타납니다. `#` 프래그먼트를 사용해 외부 문서 안의 항목을 참조하면 해당 참조의 이름을 표시하는 오류와 함께 실패합니다. `resolvers` prop을 제공하면 외부 참조를 해석합니다.

> - 640f025: The AsyncAPI definition widget no longer resolves external references by default. References to whole external documents still render, with a placeholder naming the document that was not loaded; references that point into an external document (using a `#` fragment) fail to render with an error naming the reference. To resolve external references — for example to reach internal schema registries that require authentication — provide the `resolvers` prop to enable external reference resolution.

---

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