Skip to main content

@backstage/backend-plugin-api

Home > @backstage/backend-plugin-api

Core API used by Backstage backend plugins.

Functions

FunctionDescription
createBackendModule(config)Creates a new backend module for a given plugin.
createBackendPlugin(config)Creates a new backend plugin.
createExtensionPoint(config)Creates a new backend extension point.
createServiceFactory(config)Creates a root scoped service factory without options.
createServiceFactory(config)Creates a root scoped service factory with optional options.
createServiceFactory(config)Creates a plugin scoped service factory without options.
createServiceFactory(config)Creates a plugin scoped service factory with optional options.
createServiceRef(config)Creates a new service definition. This overload is used to create plugin scoped services.
createServiceRef(config)Creates a new service definition. This overload is used to create root scoped services.

Interfaces

InterfaceDescription
AuthService
BackendFeature
BackendModuleConfigThe configuration options passed to createBackendModule().
BackendModuleRegistrationPointsThe callbacks passed to the register method of a backend module.
BackendPluginConfigThe configuration options passed to createBackendPlugin().
BackendPluginRegistrationPointsThe callbacks passed to the register method of a backend plugin.
BackstageUserInfo
CacheServiceA pre-configured, storage agnostic cache service suitable for use by Backstage plugins.
DatabaseServiceThe DatabaseService manages access to databases that Plugins get.
DiscoveryService

The DiscoveryService is used to provide a mechanism for backend plugins to discover the endpoints for itself or other backend plugins.

The purpose of the discovery API is to allow for many different deployment setups and routing methods through a central configuration, instead of letting each individual plugin manage that configuration.

Implementations of the discovery API can be as simple as a URL pattern using the pluginId, but could also have overrides for individual plugins, or query a separate discovery service.

ExtensionPointConfigThe configuration options passed to createExtensionPoint().
HttpAuthService
HttpRouterService
HttpRouterServiceAuthPolicy
IdentityService
LifecycleService
LifecycleServiceShutdownOptions
LifecycleServiceStartupOptions
LoggerServiceA service that provides a logging facility.
PermissionsService
PluginMetadataService
PluginServiceFactoryConfig
RootConfigService
RootHttpRouterService
RootLifecycleService
RootLoggerService
RootServiceFactoryConfig
SchedulerService
ServiceFactory
ServiceRefConfig
TokenManagerServiceInterface for creating and validating tokens.
UrlReaderServiceA generic interface for fetching plain data from URLs.
UserInfoService

Namespaces

NamespaceDescription
coreServicesAll core services references

Type Aliases

Type AliasDescription
BackstageCredentials
BackstageNonePrincipal
BackstagePrincipalTypes
BackstageServicePrincipal
BackstageUserPrincipal
CacheServiceOptionsOptions passed to CacheService.withOptions().
CacheServiceSetOptionsOptions passed to CacheService.set().
ExtensionPointTODO
LifecycleServiceShutdownHook
LifecycleServiceStartupHook
PermissionsServiceRequestOptionsOptions for PermissionEvaluator requests.
ReadTreeOptionsAn options object for UrlReaderService.readTree() operations.
ReadTreeResponseA response object for UrlReaderService.readTree() operations.
ReadTreeResponseDirOptionsOptions that control execution.
ReadTreeResponseFileRepresents a single file in a UrlReaderService.readTree() response.
ReadUrlOptionsAn options object for readUrl operations.
ReadUrlResponseA response object for UrlReaderService.readUrl() operations.
SearchOptionsAn options object for search operations.
SearchResponseThe output of a search operation.
SearchResponseFileRepresents a single file in a search response.
ServiceFactoryOrFunctionRepresents either a ServiceFactory or a function that returns one.
ServiceRefTODO