Skip to main content

Kaltura Source

icon

Kaltura is a video platform for modular systems that exposes different web services that may be deployed in several deployment modes to support different levels of scale. Kaltura’s platform comes in different editions, including the Kaltura-hosted SaaS edition, managed by Kaltura for single publishers and Value Added Resellers (VARs). Kaltura also offers several licensing modes of the self-hosted Kaltura On-Prem edition: Kaltura Community Edition, Kaltura On-Prem for Publishers, and Kaltura OnPrem for OEMs. Kaltura source collects audit trail events and base entry events data and sends it to Sumo Logic.

Data collected

Polling IntervalData
5 minAudit Trail Events
1 hourBase Entry Events

Setup

Vendor configuration

In this configuration, you will create a new Kaltura App Token in the Kaltura Developer Portal or via your own hosted API portal to generate an App Token and App ID.

Create a New App Token

A Kaltura App Token with specific permissions is required for Sumo Logic to access Audit Trail and Base Entry Events from Kaltura. Follow the below instructions to create a new App Token.

  1. Start a Kalutra session using an admin account.
  2. Enter the following parameters in the body:
    • secret. The API Secret Keys that are generated when you create an account.
    • expiry. 86400 - KS (Kaltura Session) expiry time in seconds.
    • Partnerid. A unique identifier allocated to every Kaltura account. The partner ID can be retrieved from the KMC Integration Settings tab.
    • privileges. disableentitlement - Session privileges that allows you to limit the applications to perform only specific actions.
    • type. ADMIN [2] - The type of Kaltura session (admin or user).
    • userId. The Unique ID of the user who is performing the API call. This ID is the end-user’s ID on the publisher’s system.
  3. Click on the Send Request.
  4. Copy and save the Kaltura Session.
  5. Add a new App Token.
  6. Enter the following global parameters:
    • ks. Paste the KS (Kaltura Session) copied from the previous step.
    • format. JSON[1] - format of the response.
  7. Enter the following body appToken parameters:
    • description. Provide a description to identify what the Token will be used for.
    • hashType. SHA1[SHA1] - Kaltura App Token Hash Type.
    • sessionType. ADMIN[2] - Type of Kaltura Session that will be created using the current token.
  8. Click on the Send Request.
  9. Copy and save the App Token, App Token ID, and Partner Id from the response.

Source configuration

When you create an Kaltura source, you add it to a Hosted Collector. Before creating the Source, identify the Hosted Collector you want to use or create a new Hosted Collector. For instructions, see Configure a Hosted Collector.

To configure a Kaltura source:

  1. In Sumo Logic, select Manage Data > Collection > Collection.
  2. On the Collection page, click Add Source next to a Hosted Collector.
  3. Search for and select Kaltura.
  4. Enter a Name for the Source. The description is optional.
  5. (Optional) For Source Category, enter any string to tag the output collected from the Source. Category metadata is stored in a searchable field called _sourceCategory.
  6. (Optional) Fields. Click the +Add Field link to define the fields you want to associate. Each field needs a name (key) and value.
    • green check circle.png A green circle with a check mark is shown when the field exists in the Fields table schema.
    • orange exclamation point.png An orange triangle with an exclamation point is shown when the field doesn't exist in the Fields table schema. In this case, an option to automatically add the nonexistent fields to the Fields table schema is provided. If a field is sent to Sumo Logic that does not exist in the Fields schema it is ignored, known as dropped.
  7. Base URL. Enter the API Base URL.
  8. Partner ID. Enter the Partner ID collected from the Vendor configuration.
  9. App Token ID. Enter the App Token ID collected from the Vendor configuration.
  10. App Token. Enter the App Token collected from the Vendor configuration.
  11. Select Base Entry Types for Base Entry Logs. You have the option to Collect all types or Select types, where you can specify the exact event categories you would like to collect from the base entry logs. Must select from the pre-defined list.
  12. Polling Interval You have the option to select how often to poll for base entry events. Default is 24 hours.
  13. When you are finished configuring the Source, click Save.

JSON schema

Sources can be configured using UTF-8 encoded JSON files with the Collector Management API. See Use JSON to Configure Sources for details.

ParameterTypeValueRequiredDescription
schemaRefJSON Object{"type":"kaltura"}YesDefine the specific schema type.
sourceTypeString"Universal"YesType of source.
configJSON ObjectConfiguration objectYesSource type specific values.

Configuration Object

ParameterTypeRequiredDefaultDescriptionExample
nameStringYesnullType a desired name of the source. The name must be unique per Collector. This value is assigned to the metadata field _source."mySource"
descriptionStringNonullType a description of the source."Testing source"
categoryStringNonullType a category of the source. This value is assigned to the metadata field _sourceCategory. See best practices for details."mySource/test"
fieldsJSON ObjectNonullJSON map of key-value fields (metadata) to apply to the Collector or Source. Use the boolean field _siemForward to enable forwarding to SIEM.{"_siemForward": false, "fieldA": "valueA"}
apiBaseUrlStringYesnullAPI URL of your Kaltura environment.
partnerIdStringYesnullPartneter Id of the customers Kaltura account from where you want to collect the event from.
tokenIdStringYesnullClient ID of the Kaltura App Token created for Sumo Logic.
tokenStringYesnullClient Token of the Kaltura App Token created for Sumo Logic.
supportedApisArray of stringsYesAudit TrailDefine one or more of the available APIs to collect.
Options Base Entry, Audit Trail.
collectAllBooleanYesTrueBy default, the Source will ingest all Base Entry events. If false, baseEntryTypes is required..
baseEntryTypesArray of stringsnonullA list of Base Entry Types to collect. Required if collectAll is false.
Options: DATA, PLAYLIST, MIX, MEDIA_CLIP, SIP_ENTRY_SERVER, EXTERNAL_MEDIA, CONFERENCE_ENTRY_SERVER.
polling_intervalIntegerNo24How frequently the integration should poll to Kalura for Base Entry Events in hours.

JSON example

{
"api.version":"v1",
"source":{
"schemaRef":{
"type":"Kaltura"
},
"config":{
"name":"Kaltura",
"collectAll":true,
"partnerId":"*****",
"polling_interval":24,
"supportedApis":["baseEntry","auditTrail"],
"fields":{
"_siemForward":false
},
"token":"***********",
"tokenId":"*******",
"category":"sanbox/kaltura",
"apiBaseUrl":"https://www.kaltura.com"
},
"state":{
"state":"Collecting"
},
"sourceType":"Universal"
}
}

Download example

Terraform example

resource "sumologic_cloud_to_cloud_source" "kaltura-source" {
collector_id = sumologic_collector.collector.id
schema_ref = {
type = "Kaltura"
}
config = jsonencode({
"name":"Kaltura",
"description":"",
"apiBaseUrl":"https://www.kaltura.com",
"collectAll":true,
"partnerId":"********",
"token":"***********",
"tokenId":"*******",
"supportedApis":["baseEntry","auditTrail"],
"fields":{
"_siemForward":false
},
"category":"sanbox/kaltura",
"polling_interval":24
})
}
resource "sumologic_collector" "collector" {
name = "my-collector"
description = "Just testing this"
}

Download example

FAQ

info

Click here for more information about Cloud-to-Cloud sources.

Legal
Privacy Statement
Terms of Use

Copyright © 2024 by Sumo Logic, Inc.