close

Filter

loading table of contents...

Studio Developer Manual / Version 2301

Table Of Contents

9.27.2 Adapter Configuration

Once the implementation of an adapter has been created, an additional configuration must be available to tell Studio which concrete instances to display. These instances are configured in settings documents in a folder named Connections. The Connections folder should contain only Content Hub connections documents, otherwise you will encounter some warnings in the logging. Each document contains a Struct List connections. Every connection sub-struct defines the following properties:

Name Type Required Description
connectionId String x The identifier of the connection. For technical reasons, it must not contain '/' characters.
factoryId String x The identifier of the implementing factory class.
settings Struct x A struct that defines the connection attributes.
enabled Boolean Allows disabling a connection.
itemTypes Link Links to a settings document that contains the item type mapping. Alternatively, you can override getItemTypes() in your ContentHubAdapterType and implement this mapping hard coded.
contentTypeMapping Link Links to a settings document that contains the mapping from Content Hub types to content types. Alternatively, you can override getContentTypeMapping() in your ContentHubAdapterType and implement this mapping hard coded.

Table 9.8.  Connection Struct Properties


Every connection struct must contain a sub-struct settings. Properties of this struct will automatically be mapped to the settings interface that you have created for the adapter. For example, if the settings interface contains the method String getConnectionUrl(), then the struct must provide the String property connectionUrl.

Caution

Caution

Please take care of security protection. The settings should not contain secrets like passwords or API tokens. For example, better store them in a dedicated secrets manager and only pass them through to the external system in your custom adapter implementation during runtime.

The following rules of thumb provide additional protection for sensitive data:

  • Restrict access to the Connections folder to the people that actually configure the adapters.
  • Do not publish adapter configuration. The adapters are only accessed in the CoreMedia Studio. As such they are not relevant on the live side.
  • Ensure that there are not links to Settings content. The adapter configuration is identified by means of their location. Links are not required. A link would risk that the Settings content is accidentally published if for example its referring content is published.
  • Exclude the content and folder from website search by checking the corresponding option.
  • Prevent access to arbitrary content from the Headless Server and from other client applications. See Section 3.5, “Security” in Headless Server Manual for more details.

Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.