Chapter 4. Technology Preview

Additional resources

• RHIDP-2757

• Environment variable control:

  • A new ENABLE_AUTH_PROVIDER_MODULE_OVERRIDE environment variable determines whether the backend installs the default authentication provider module.
  • When the new environment variable is enabled, dynamic plugins can be used to supply custom authentication providers.

• Custom sign-in page support:

  • A new signInPage configuration allows front-end dynamic plugins to provide a custom SignInPage component.

    Example configuration

    dynamicPlugins:
     frontend:
       my-plugin-package:
         signInPage:
           importName: CustomSignInPage

  • The exported CustomSignInPage will be mapped to components.SignInPage during front-end initialization.

• Authentication provider settings:

  • A new providerSettings configuration field allows front-end dynamic plugins to define authentication provider settings for display in the Authentication Providers tab on the Settings page.

    Example configuration

    dynamicPlugins:
     frontend:
       my-plugin-package:
         providerSettings:
    - title: Github Two
    description: Sign in with GitHub Org Two
    provider: core.auth.github-two

  • Each providerSettings entry creates a corresponding row in the Authentication Providers tab. The provider field must match the string used in createApiRef when defining the API reference:

    Example configuration

    export const ghTwoAuthApiRef: ApiRef<
     OAuthApi & ProfileInfoApi & BackstageIdentityApi & SessionApi
    > = createApiRef({
     id: 'core.auth.github-two', // <--- this string
    })