Project: Backstage (App Definition and Development / Application Definition & Image Build)
File: v1.24.0.md

id: v1.24.0 title: v1.24.0 description: Backstage Release v1.24.0 These are the release notes for the v1.24.0 release of . A huge thanks to the whole team of maintainers and contributors as well as the amazing Backstage Community for the hard work in getting this release developed and done. This release is a big milestone for the authentication system of Backstage and includes a large collection of new APIs and services. The full proposal can be found in , including the motivation for this change. The main highlight of these changes is that were adding security by default to Backstage, meaning that you will no longer be forced to protect your Backstage instance from unauthorized access. It also brings several other improvements, such as slimmer user tokens and better handling of user credentials. The majority of these improvements only apply to the new backend system, but the new service interfaces have backwards compatibility layers that allow them to be used in the old backend system too. This is the first phase of the rollout of these changes, and includes all breaking changes that we are expecting. The new service interfaces introduced in this release set us up for the ability to add further improvements to the system without the need for additional breaking changes. For information on how to migrate existing Backstage projects and plugins, refer to the . Due to this change, some backend plugins now require the `discovery` service to be forwarded from the plugin environment in the old backend system. As part of this change, the `getBearerTokenFromAuthorizationHeader` export from `@backstage/plugin-auth-node` has been deprecated and we discourage any usage of it. The events system has been changed to have better compatibility with the new backend system, by handling all communication through a new events service. Existing modules have been refactored to accept the new `EventsService` as input, rather than implementing the `EventSubscriber` interface. Refer to the changesets for each module for information on how to migrate. For information on how to wire up the events service in the old backend system, see the

This has also affected how the events backend is installed in the old backend system, see the and for details. Contributed by in . When creating a new project with `@backstage/create-app` you now get a backend built on top of the new backend system. Plugins created with the `@backstage/cli` now also support the new system. A new guest auth provider is now available for use in local development and testing. In contrast to the existing guest auth, this provider lets you get a valid session and Backstage user token. Contributed by in A `null` value is now treated as an explicitly undefined value, and does not fall back to other configuration files. This means that you can use a `null` value in configuration to reset or unset parts of configuration, such as disabling an auth provider. A new `@backstage/plugin-scaffolder-node-test-utils` package has been published, which provides `createMockActionContext` to make it easier to write tests for scaffolder actions, and avoid breakages as additions to the actions context is made. More details can be found in the documentation for . We encourage you to migrate existing tests to use this new utility, in order to avoid breaking changes in the future. The `catalogModelExtensionPoint` from `@backstage/plugin-catalog-node/alpha` can now be used to replace the default entity data parser and field validation rules in the new backend system. The `techdocsGeneratorExtensionPoint` from `@backstage/plugin-techdocs-node` can now be used to set a custom TechDocs generator. The majority of components from `@backstage/core-components` now support internationalization. Message customizations are available through the `coreComponentsTranslationRef` export from `@backstage/core-components/alpha`. See the for details on how to customize these messages in your application. Contributed by in This release does not contain any security fixes. We recommend that you keep your Backstage project up to date with this latest release. For more guidance on how to upgrade, check out the documentation for . Below you can find a list of links and references to help you learn about and start using this new release. , , and Backstage's for discussions and support Backstage , , and Sign up for our if you want to be informed about what is happening in the world of Backstage.