Skip to content

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 plugin 2 Kaltura Plugin

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.