# Backstage v1.56.6

2026-11-17 · [元のリリースノート](https://github.com/backstage/backstage/releases/tag/v1.56.6) · [全体のまとめ](https://ratatosk.io/ja/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.

### Scaffolder アクションによる対象リポジトリ外のパスの拒否

- 影響対象: `gitlab:repo:push`、`publish:gitlab:merge-request`、または `publish:github:pull-request` Scaffolder アクションを使用する環境

絶対パスと `..` セグメントを含むパスは、`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 scaffolderアクションでの危険なパスの拒否

- 影響対象: `gitlab:repo:push`、`publish:gitlab:merge-request`、`publish:github:pull-request`を使用するGitLab scaffolder環境。後者の`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 がエンティティのアノテーションより優先

- 影響対象: location アノテーション付きエンティティを `validate-entity` エンドポイントに送信する構成

以前は、送信されたエンティティの location アノテーションによって、リクエストの location が上書きされることがありました。

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

### AsyncAPI 定義ウィジェットで外部参照がデフォルトで解決されない仕様

- 影響対象: 定義ウィジェット内で外部ドキュメントを参照する AsyncAPI 定義

ドキュメント全体への参照には、未読み込みのドキュメント名を示すプレースホルダーが表示されます。外部ドキュメント内の `#` フラグメントを使った参照は、参照を示すエラーで失敗します。`resolvers` プロパティを指定すると、外部参照の解決が有効になります。

> - 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 が作成するため誤っている可能性があり、無保証で提供されます。
