Kaltura configuration
This section provides the steps on how the DAM extensibility allows the Kaltura plugin to follow the framework to provide interaction between DAM and actual Kaltura services.
Architecture
Kaltura configuration via DAM Extensibility
Following kaltura configuration changes are required to configure through DAM extensibility in values.yaml
Kaltura Plugin configuration Under kaltura plugin configuration by default the enable flag will be set as false, the end user can enable kaltura-plugin by setting the enable flag to true.
kaltura-plugin:
url: http://RELEASE_NAME-dam-plugin-kaltura:DAM_HTTP_PORT/dx/api/kaltura/v0/plugin
callBackHost: http://RELEASE_NAME-digital-asset-management:DAM_HTTP_PORT
authKey: Key
enable: false
playerid: kalturaPluginPlayerId
dataUrlPattern: https://cdnapisec.kaltura.com/p/{PARTNERID}/sp/{PARTNERID}00/playManifest/entryId/{ENTRYID}/format/url/protocol/https
playerLibraryUrlPattern: https://cdnapisec.kaltura.com/p/{PARTNERID}/sp/{PARTNERID}00/embedIframeJs/uiconf_id/{PLAYERID}/partner_id/{PARTNERID}
actions:
upload:
params: {}
url: "/upload"
status:
params: {}
url: "/status"
resize:
params: {}
url: "/resize"
delete:
params: {}
url: "/delete"
Kaltura Plugin Server Configurations
- Config Map
{ "thumbnailUrlPattern":string, "partnerId":string }
Example
damPluginKaltura:
# kaltura plugin configuration for thumbnail URL.
thumbnailUrlPattern: https://cfvod.kaltura.com/p/{PARTNERID}/sp/{PARTNERID}00/thumbnail/entry_id/{ENTRYID}/width/{width}/height/{height}/type/3
# kaltura plugin configuration for partnerId.
partnerId: partnerId
- Video Configuration in DAM
video/mp4: rendition: - name: Original transformationStack: - plugin: kaltura-plugin operation: upload: mediaId: '' thumbnailStack: - plugin: kaltura-plugin operation: resize: height: 192 width: 192 entryId: '' supplementalStack: - plugin: kaltura-plugin operation: status: entryId: '' video/ogg: rendition: - name: Original transformationStack: - plugin: kaltura-plugin operation: upload: mediaId: '' thumbnailStack: - plugin: kaltura-plugin operation: resize: height: 192 width: 192 entryId: '' supplementalStack: - plugin: kaltura-plugin operation: status: entryId: '' video/webm: rendition: - name: Original transformationStack: - plugin: kaltura-plugin operation: upload: mediaId: '' thumbnailStack: - plugin: kaltura-plugin operation: resize: height: 192 width: 192 entryId: '' supplementalStack: - plugin: kaltura-plugin operation: status: entryId: ''
Kaltura Synchronisation time interval configuration in DAM
We are using wait status in case of video synchronization. There will be 3 retries. each retry has same timeout of 2 minutes. Once all retries are finished the operation will go to FAILED status.
OPERATION_WAIT_INTERVAL is used as environment variable with default value of 2 minutes and the user can increase this value if needed. example: "OPERATION_WAIT_INTTERVAL: 120000".
How is the configuration setup for Kaltura Plugin
Plugin security Configuration
In DAM Extensibility, plugins come with the security enabled. So, the API requests are authenticated with the security key, which is transmitted and validated in every call, both for plugin and callback calls, and the user can write this in the same config file under security configuration and give the value to the authenticationKey parameter. This value is then passed for plugin configuration key attribute, so that DAM sends this with each request to authenticate.
# Security related configuration, e.g. default credentials default
# Security configuration for dam-kaltura-plugin
damKalturaPlugin:
# Authentication key for Plugin API
authKey: "kalturaPluginSecretAuthKey"
# Authentication key for Kaltura external service
secretKey: "cnVtYWFhYm9zZS1oY2wK"
List of removed Plugin APIs
The following DAM APIs are removed and no longer in use:-
-
PUT: /plugins/{plugin_id}
-
PATCH: /plugins/{plugin_id}
-
GET: /plugins/{plugin_id}
-
DELETE: /plugins/{plugin_id}
-
POST: /plugins
-
GET: /plugins
Note
Please take a note of all Kaltura Plugin configuration details before upgrading.