Organizational Strategy for MediaSpace Entitlements

When creating an organizational video portal with MediaSpace, MediaSpace categories, channels and their respective user permissions can be set and maintained in different ways. When categories and channels serve organizational units and groups, it may be possible to create the channels and maintain the channel permissions based on data managed in the organization’s information system (for example, identity management systems and group management systems).

This section addresses:

These tasks can be accomplished in different ways since every organization has different needs and requirements, deploys and supports different information systems, and has different levels of IT capabilities and resources. The guidelines in this document can be adapted to fit each organization’s needs and capabilities.

Terminology

User ID – A user’s unique identifier in your organization’s information systems. The same ID is used in Kaltura as a unique identifier of the user in a specific partner account.

Group ID – A unique identifier in your organizational information system representing an actual organizational unit or an ad-hoc security group. A user can be a member of multiple groups and may hold a different organizational role in each group. The organizational role of a user within a unit/group may or may not be represented within the organization information system.

MediaSpace Category – An open/private/restricted category in MediaSpace that a specific group of users (category members) is able to access. Categories are centrally created via the Kaltura Management Console (KMC) and reflect the navigation structure of your MediaSpace site. The list of people with permission to access the category may derive from user membership in a specific organizational group or may be defined manually by the category manager with no relation to organizational structure and units

MediaSpace Channel – An open/private/restricted channel in MediaSpace that a specific group of users (channel members) is able to access. The list of people with permissions to access the group channel may derive from user membership in a specific organizational group or may be defined manually by the channel manager with no relation to organizational structure and units.

NOTE: MediaSpace Channels can be associated with one or more MediaSpace Category according to the entitlements set in the category. 

Kaltura User – A Kaltura backend object that holds information about a specific user and is identified by the User ID. Kaltura supports the management of different user attributes. The user ID is a mandatory attribute; the user’s first name, last name, and screen name (by default, the user’s full name) are required to enable convenient end-user management in MediaSpace and in the KMC. Kaltura User objects are automatically created in Kaltura for different scenarios. For user management purposes, Kaltura User objects also may be created manually from the KMC or using bulk services. The Kaltura User object is used for managing both KMC admins and application end‑users. Only KMC administrators have a special attribute granting access to the KMC account.

Kaltura Category – A Kaltura backend object for managing media collections and the end‑user entitlements to access and manage these media collections in MediaSpace. This backend entity manages MediaSpace Channels and MediaSpace Categories.

Kaltura Category ID –A Kaltura internal unique identifier of a single Kaltura Category Object.

Kaltura Category Reference ID –A Kaltura Category attribute designed to hold and connect the category to an external identifier such as the Group ID. Uniquenessofthe Category Reference ID is not enforced by Kaltura.

Kaltura’s End-User Entitlements  –A permission level that enables a specific end‑user to access, contribute to, or manage a specific channel or category. In the Kaltura backend, end‑user entitlements are managed in Kaltura’s categoryUser object, which manages the relationship between a specific end‑user and a specific category.

Planning Considerations

Consider the following questions when you plan the organizational process for managing MediaSpace channels and channel memberships.

What types of channels will be in your video portal?

  • Education Examples
    • Course channels
      For media-rich courses, faculty can create a course channel in MediaSpace in a simple, feature-rich environment.
    • School/Department channels
      Each school/department has its own managed channel that shows content that either is accessible only to the school/department or is open to all.
    • Workgroup channels
      Not bound by a strict learning management system (LMS) structure, faculty and students can create cross-course ad hoc groups for research, projects, and more.
      Portfolio Channel
      Allow faculty and any authorized users to create their own portfolio channel, with recordings of public speaking, awards and events, lectures, video work, and more. Typically, the channels are public under the university roof, but also can be restricted to a specific set of users within the organization.
  • Enterprise Examples
    • Department channel
      Each department head manages the department channel that shows content that either is accessible only to the department or is accessible to all employees
    • Community channels
      All employees are empowered to create their own channels, and can either invite specific co‑workers to join or can enable open access. For each channel, the creator can control who can contribute and whether moderation is required.

For which units in your organization do you want to create a MediaSpace channel?

Examples:

  • For all groups of a specific type (for example, all departments or all schools)
  • For only a few groups within the organization (for example, a few departments or media‑related courses only)
  • For a few communities/work groups within the organization
  • Every user will be able to open a channel.

What should be the typical/default privacy level required for channels of each type?

  • Open - All users in the organization are entitled to access the channel and contribute content.
  • Restricted - All users in the organization are entitled to access the channel, but only specific users are entitled to contribute content.
  • Private - Only specific users in the organization are entitled to access the channel and contribute content.

What should be the typical/default privacy level required for categories of each type?

  • Open - All users in the organization are entitled to access the category including anonymous users if your site is configured for unauthenticated access. Only specific users are entitled to contribute content.
  • Restricted - All users in the organization are entitled to access the cateogry, but only specific users are entitled to contribute content.
  • Private - Only specific users in the organization are entitled to access the category and contribute content.

What changes in your organization should require an update to user permissions?

Examples:

  • Someone joined/left an organizational group.
  • Someone's role in organizational groups changed.
  • Someone joined or left the organization.

What is the frequency and volume of the relevant organizational changes?

  • How often do the changes happen?
  • How many users/groups are affected?

What is the acceptable lag time for channel permissions to be updated in MediaSpace following an organizational change?

How promptly must organizational changes be reflected within MediaSpace channels and channel permissions? For example, immediately, within a few hours, on the next day.

How available is your organizational IT Department?

Do you have resources for developing and maintaining an automated update of channel permissions based on changes in your organizational information systems?

Channel Management Types

Based on your evaluation of the planning consideration questions, decide on the best way to manage channels and channel memberships in your organization. You can select one of the following options or combine options to manage different types of channels.

Management Type

Integration Effort 

Channel Management

 

Creation 

Channel Permissions — Initial Setup

Channel Permissions — Ongoing Updates

Self-Created

 

Very Low

 

Who?

Organizational unit/group managers or anyone authorized by the organization to create a MediaSpace channel

Channel Managers

Channel Managers

When?

Whenever a new channel is needed

Upon channel creation

When needed

How?

On the MediaSpace site

On the MediaSpace site

On the MediaSpace site

Centrally Assigned 

Low–Medium

Who?

Video portal administrators, with or without IT department assistance

Channel Managers

Channel Managers

When?

Upon initial set up of video portal channels, upon major organizational changes, when a new channel is needed

Upon channel creation

When needed

How?

In the KMC: manual or bulk CSV-based creation

On the MediaSpace site

On the MediaSpace site

Centrally Prepared

Medium 

Who?

Video portal administrators, with or without IT department assistance

Video portal administrators, with or without IT department assistance

Organizational unit managers and/or their assistants.

When?

Upon initial set up of video portal channels, upon major organizational changes, when a new channel is needed

Upon channel creation

When needed

How?

In the KMC: manual or bulk CSV-based creation

In the KMC: manual or bulk CSV-based setup

On the MediaSpace Site

Automatically Maintained

High

Who?

Video portal administrators, with or without IT department assistance

Video portal administrators, with or without IT department assistance

Scheduled automated update process or based on information system’s triggers

When?

Upon initial set up of video portal channels, upon major organizational changes, when a new channel is needed

Upon initial set up of video portal channels, upon major organizational changes, when a new channel is needed

Scheduled as needed or triggered in real-time upon group membership modifications

How?

In the KMC: manual or bulk CSV-based creation

In the KMC: manual or bulk CSV-based setup

See Automatically Updating Channel Permissions

Creating MediaSpace Channels

Creating Channels in MediaSpace by Users

Organizational group managers or anyone authorized by the organization to create channels in MediaSpace can create a channel on the MediaSpace site and manually select the channel’s settings and member permissions.

Users who create channels in MediaSpace require a MediaSpace application role that enables channel creation. To learn more, refer to Setting Permissions for Creating a MediaSpace Channel in this guide.

To learn more about channel creation and management, refer to Creating and Managing a Channel in the Kaltura MediaSpace User Manual.

Creating Channels Centrally by Administrators

Video portal administrators can create channels, with or without the assistance of the organizational IT department.

Creating MediaSpace Channels in Bulk

You may need to create channels in bulk, either at the initial setup or upon major organizational changes that trigger the creation of numerous channels. We recommend creating channels in bulk using Kaltura’s bulk services with Kaltura’s Categories CSV.

NOTE: There is a 5000 user limitation on channel and category members. If more members are expected, please use Kaltura Groups . See Group Support in Kaltura Applications and Kaltura Groups FAQ for additional information.

To create MediaSpace Channels in bulk

  1. Prepare the initial list of groups that will use the new MediaSpace Channels. You can prepare the list manually or export the list from the organizational information system. Include at least the following information from your organizational information system:
    • For groups managed in your organizational information system, include the Group ID of each organizational group/unit.
    • If a group manager plans to create the channel members list and permissions in MediaSpace, specify the User ID of the group manager. This sets the group manager as the channel owner and enables the group manager immediate access to the group channel settings in MediaSpace.
    • If a friendly group name is available in your information system, you can export the friendly group name to use as the channel name.
  2. Edit the basic group list in a spreadsheet editor or programmatically to comply with Kaltura’s Categories CSV format. Insert the following information to create channels in MediaSpace with relevant channel settings (see the example below.).
    • Enter the relative category path to your MediaSpace Channels category.
    • When relevant, set each Group ID as the reference ID of its respective category. This enables you to refer to the category based on the Group ID,when needed (for example, for automated channel membership creation).
    • Enter the channel name. You can use the group name exported from your information system, the Group ID, or any name you select. The name will be displayed as the channel name in MediaSpace.
    • For the category owner, enter the User ID of the user who will initially manage the channel (for example, the User ID of the unit/group manager).
    • Enter the category entitlement settings according to the type of channel (open/restricted/private).
    • You can add additional information, such as channel description, tags, and any custom channel classification or topic managed by the category’s custom data. The channel owner also can manually enter this information in MediaSpace after the channel is created.
    • Insert the Categories CSV headers for fields that are populated in your CSV.

  3.  

    Categories CSV for creating different types of MediaSpace Channels

     NOTE: While there is no limit on the number of lines in the CSV, the processing time of each CSV is affected by the number of lines in the CSV. Therefore, we recommend splitting the CSV into manageable chunks for convenient editing, processing, and tracking.

  4. On the KMC Upload tab, upload the Categories CSV.
    Bulk processing in Kaltura is handled in an asynchronous batch process. Track the completion status of the bulk job in the KMC on the Bulk Upload Log page or using email notifications set by Kaltura for your account.

Creating MediaSpace Channels Individually

Occasionally you may need to create a single channel or a few channels. We recommend creating and configuring individual channels in the KMC Edit Category window.

To learn more, refer to Managing Categories in the Kaltura Management Console (KMC) User Manual and Understanding Privacy Types.

Creating and Updating Channel and Category Permissions

Assigning Permissions and Entitlements

Entitlements are configurable for categories as well as channels. You can define whether the category is open, private or restricted. You can also define who actually has access to specific categories and in which role. Formerly, if you wanted someone to publish media to a gallery they had to be defined as an adminRole. You can define a category and allow specific users to contribute content providing granular control over the entitlements and the roles of users according to the structure of your categories.

This includes:

  • Inheriting permissions from parent categories – you don’t need to define users again and again in each sub category
  • Importing  members from the parent category -  you can add or remove users from subcategories
  • You can define a group name, for example LDAP group or authorization provider that you are using and the default permission level, so that when you are developing an offline sync process, to synchronize roles and permissions on KMS and roles and permissions in your identity provider,  you can leverage the group name definition to add or remove users from KMS.

Setting Up Members and Permissions Manually in MediaSpace

Channel and category managers can manually add members to their channels, assign and update member permission levels, and remove members. A channel manager manages channel members and permissions on the Edit Channel / Category page in MediaSpace.

To learn more, refer to Creating and Managing a Channel in the Kaltura MediaSpace User Manual.

Setting Up Permissions Centrally in Bulk

The video portal administrator in the KMC can initially assign category and channel permissions for categories or channels related to organizational units. The organizational IT department usually needs to assist setting up group permissions by exporting the organizational group membership data from the organization’s information systems.

Channel and category permissions should be assigned in bulk for a large number of new categories or channels, either at the initial setup or upon major organizational changes that trigger the creation of numerous categories / channels. We recommend assigning permissions in bulk using Kaltura’s bulk services with Kaltura’s End-User Entitlements CSV.

 

NOTE: You must assign permissions in bulk after creatingthe channels or categories. Assigning permissions in bulk requires first setting the Group ID value as the channel Category’s Reference ID. See the procedure To create MediaSpace Channels in bulk.

To create memberships and permissions in bulk

  1. For all channels or categories for which you are assigning permissions, prepare an initial list of organizational user/group membership pairs with the required channel permission levels.
    • Initial list of group memberships
      • When you export group memberships from your organizational information system for the list, you may need to separately query all group managers, all group members, and so on. This is to ensure that different channel permission levels are assigned according to the user’s organization role within a specific group.
      • If you want the channel to be self-managed in MediaSpace and did not assign a channel owner when creating the channel, assign a Managerpermission level to at least one user.
  2. Edit the basic group membership list in a spreadsheet editor or programmatically to comply with Kaltura’s End-User Entitlements CSV format. Specifically, insert the CSV field headers, specify the CSV ‘add’ action (action =1), and specify the numeric value of each permission level according to Kaltura’s specifications.
    1. You may assign permissions for multiple channels and categories within one CSV file.
    2. Memberships formatted in Kaltura's End-User Entitlements CSV
  3. On the KMC Upload tab, upload the End-User Entitlements CSV.

NOTE: While there is no limit on the number of lines in the CSV, the processing time of each CSV is affected by the number of lines in the CSV. Therefore, we recommend splitting the CSV into manageable chunks for convenient editing, processing, and tracking.

Bulk processing in Kaltura is handled in an asynchronous batch process. Track the completion status of the bulk job in the KMC on the Bulk Upload Log page or using email notifications set by Kaltura for your account.

Setting Up Permissions Individually

Occasionally the video portal administrator may need to assign individual membership and permissions. We recommend assigning individual channel membership and permissions in the KMC Edit Category window.

To learn more, refer to Managing Categories in the Kaltura Management Console (KMC) User Manual.

Automatically Updating Permissions

Following the initial setup of permissions, you can automate the updating of permissions to reflect relevant changes in your organization (user joined/left an organizational group; User joined/left the organization, and so on).

Automated updating of MediaSpace permissions based on changes made in your organizational information system is very useful for big organizations. Automatic permission updates help when organizational group memberships are updated frequently and when you want to eliminate the need for each channel manager to manually manage permissions in MediaSpace.

Automating ongoing updates of channel permissions requires the expertise and full involvement of the organizational IT department and requires your organizational information system to support one of the following modes:

NOTE: The following procedures provide general guidelines and rely on your IT experts and/or developers to tailor the automation process based on the capabilities of your organizational information system and related applications. Kaltura’s professional services team may provide assistance in designing and developing the automated updating process and will provide all information required for utilizing Kaltura’s bulk services and API for automation.

To develop an automated process for periodically updating channel membership permissions

  1. Define how frequently to schedule the update.
    Decide how often you need to update the membership permissions, and schedule the frequency of the update process accordingly.
  2. Develop an automated process that includes the following steps and logic:
    1. List the required permissions modifications.
      Based on your information system audit, querying, and export capabilities, retrieve the list of users who — within a specific time range — joined or left groups within your organization, or changed their organizational role in specific groups.
      You may rely on direct audit information available in your information system or develop a query and sync process that implements the following logic:
    2. List every user whose record was created/modified/deleted within a specific time range (for example, from the last update until now).
      1. For each user in this list:
        1. Query your information system to get the list of groups that the user currently belongs to (possibly with the specific role in each group)
        2. Query Kaltura for the list of channels and categories that the user currently is a member of.
    3. Compare the two lists (based on the Group ID and Category reference ID) and implement the logic for determining the channels for which the specific user’s permission should be created, updated, or deleted. Format this as an initial list of channel permission actions (add, update, delete).

This logic assumes that changes in user group memberships affect the modification date of the user’s record. When changes in user group memberships affect the modification date of the group’s record, implement an equivalent logic that is oriented toward synchronizing the list of channel members instead of synchronizing the list of channels that the user is a member of.

NOTE:

  • An attempt to create/update/delete user permission in a channel’s category that does not exist yet in Kaltura will fail. You may extend the logic for automatic creation of new channels when the first relevant group membership is set in Kaltura. Note that such an addition may cause uncontrolled channel creation and may result in a large number of empty channels, which is not recommended when channel browsing is enabled in your site.
  • An attempt to create a user permission in a channel’s category when the user record is not yet in Kaltura will cause the automatic creation of the user’s record in Kaltura with the specified User ID.
  • The category’s reference ID is a standard way to map a single organizational group to a single channel. To automatically assign permissions for a single channel to users of multiple organizational groups, you may tailor a synchronization logic that relies on a category custom data schema that enables multiple Group IDs to be assigned specific permission levels to a single category. Contact Kaltura professional services for assistance if necessary.


Prepare the End-User Entitlements CSV.

Transform the initial list of channel permission actions (add, update, delete) to comply with Kaltura’s End-User Entitlements CSV format. Insert the CSV field headers and specify the permission levels and actions.

To add a user permission, use the CSV add action (action = 1).

To update a user permission or create a new one as a fallback in case the permission you attempt to update was not yet set, use the CSV add or update action (action = 6).

To delete a user permission, use the CSV delete action (action = 3).

Channel permission actions formatted in Kaltura's End-User Entitlements CSV

Submit the End-User Entitlements CSV.

When the End-User Entitlements CSV is available, submit it to Kaltura using the Kaltura API: Call the categoryUser.addfrombulkupload API action.

Bulk processing in Kaltura is handled in an asynchronous batch process. Track the completion status of the bulk job in the KMC on the Bulk Upload Log page or using email notifications set by Kaltura for your account.

    To develop a trigger-based process for updating membership permissions

NOTE: For changes in your information system to trigger real-time updates to channel membership permissions, your information system or related applications must support real-time triggering of notifications to other systems.

Develop the following:

  1. Trigger an Add Permission call
    1. Create a script that implements the following Kaltura API requests when a new group membership is created for a user in your information system (a user joins an organizational group).
    2. Call the category.list API action to retrieve the category object. In the list filter, include the Group ID set astheCategory’s Reference ID attribute.
    3. When the category is found, call the categoryUser.add API action to create a new permission for the user with the proper permission level.
  2. Trigger a Delete Membership call
    1. Create a script that implements the following Kaltura API requests when an existing group membership is removed from a user in your information system (a user leaves an organizational group).
    2. Call the category.list API action to retrieve the category object. In the list filter, include the Group ID set astheCategory’s Reference ID attribute.
    3. When the category is found, call the categoryUser.delete API action to delete the user's existing membership.
  3. Trigger an Update Channel Membership call
    1. Create a script that implements the following Kaltura API requests when an existing group membership type in your information system is changed in a way that impacts the relevant channel or category permission level (for example, a user's role within a group changes and the user should be set as a channel manager).
    2. Call the category.list API action to retrieve the category object. In the list filter, include the Group ID set astheCategory’s Reference ID attribute.
    3. When the category is found, call the categoryUser.update API action to adjust the user’s permission level.


NOTE: In the previous steps you may skip step A, which lists the category with the specified Reference ID, if you store the Kaltura Category ID in your information system’s group record.

Enabling Manual Overrides of Automatically Updated Permissions

When permissions are assigned and automatically updated based on organizational group memberships, you may want to allow managers and video portal administrators the flexibility to assign different permissions in specific cases.

Examples:

  • In a company departmental channel, you want one of the employees to be the channel moderator, while all employees in the department are assigned only the channel member permission level.
  • In a course channel, you want to assign contribution privileges to one of the students, while all other students are assigned only the channel member permission.
  • In a company business unit channel, you want the unit’s administrative assistant to be the channel manager but there is no attribute within your organizational information system that you can use to assign this permission level automatically.

The Update Method attribute of channel permissions enables manual overrides to a channel’s user permission levels that will not be updated by the automatic update process. You can set the Update Method as automatic or manual.

Call the categoryUser.update Kaltura API action to enable a controlled override of permission levels that were set or updated manually in MediaSpace or the KMC. Use the override parameter to indicate whether to override a permission level that is set manually.

Using this API action enables you to implement a logic that prevents manually created or updated permission levels from being updated by automated processes or that allows the permission levels to be updated only in specific cases.

By default, end-user permissions created in bulk using a CSV use the automatic update method and will not override manual updates to permission levels.

Any member added in MediaSpace is set to the manual update method. In addition, any permission level change to existing members by a MediaSpace channel or category manager sets the channel permission to manual update.

You can view and fully control the permission level update method in the KMC Category Edit window.

Deleting MediaSpace Channels

MediaSpace Channels can be deleted:

When a category is deleted, the media entries in the category (including sub-category entries) are not deleted. The media entries lose the association with the deleted category, including any privacy setting defined in the deleted category.

To plan channel deletions and to ensure that access to content in deleted channels is controlled according to your organizational needs, note that:

  1. When a channel is deleted in MediaSpace, a media entry in the channel that is not associated with any other channel or gallery becomes private (associated with the MediaSpace private category).
  2. When categories are deleted manually in the KMC or using the Categories CSV, the media entries in the category automatically are associated with the deleted category's parent category. Before deleting a category, you may want to associate the category's entries with new categories using the entry bulk actions available in the KMC (Edit Categories, Add to New Category).

When a category is deleted using the category.delete Kaltura API action, you can control whether the deleted category's media entries automatically are assigned to the parent category. In addition, you can programmatically associate the entries with other categories before the category is deleted, according to the logic you want to implement.

Deactivating Channel Memberships

Deactivating MediaSpace channel memberships may be useful when you want to block channel members from accessing a channel’s content while retaining the option to reactivate their memberships later.

    To deactivate and reactivate channel memberships

You can do either of the following:

  • In the KMC Edit Category window, apply the deactivate/activate action to selected channel members.
  • Prepare a Kaltura End-User Entitlements CSV:
  • To deactivate a user's channel membership, use the CSV ‘update’ action (action = 2) with status = 3.
  • To activate a user's channel membership, use the CSV ‘update’ action (action = 2) with status = 1.

Creating and Updating the Add Members Auto-Complete List

A channel or category manager can add end-users as members in MediaSpace on the Members tab of the Edit Channel / Category page. The manager can conveniently select members using an auto-complete feature. In the Add Member window under Enter user name, the manager starts typing a user name or user ID. Suggested user names are displayed after three characters are entered, and the manager can select a member to add. To learn more about editing members, refer to Editing Channel Users in the Kaltura MediaSpace User Manual.

By default, the auto-complete list includes only users who already are listed in Kaltura.

When authorizing access to MediaSpace through integration with SSO/LDAP, a user's record in Kaltura is not necessarily created prior to the user’s first login to MediaSpace.

To populate the auto-complete list with all users who potentially can use MediaSpace (and not only those who already are logged-in), you may pre-provision the user records in Kaltura.

The Workflow for Creating and Updating the Add Members Auto-Complete List:

  1. Setting Up the Initial Add Members Auto-Complete List
  2. Updating the Add Members Auto-Complete List

NOTE: When you use Kaltura to authorize access to MediaSpace, it is assumed that all user accounts are pre-provisioned in Kaltura. Therefore, the auto-complete list includes all potential MediaSpace users.

 

Setting Up the Initial Add Members Auto-Complete List

To populate the Add Members auto-complete user list in bulk

  1. Prepare the initial list of users in your organization who will be eligible to access MediaSpace. You can prepare the list manually or export the list from your organizational information system. Include at least the following information:
    • User ID
    • User’s first name
    • User's last name
  2. Edit the initial users list in a spreadsheet editor or programmatically to comply with Kaltura’s end-users CSV format.
    1. Use the CSV add or update action (action = 6) to update any existing user record that includes only the user ID with the user’s first and last names, or to create new records.
    2. (Optional) Combine the first and last names into an additional field called screenName, which also is used in the KMC and applications.

      NOTE: While there is no limit on the number of lines in the CSV, the processing time of each CSV is affected by the number of lines in the CSV. Therefore, we recommend splitting the CSV into manageable chunks for convenient editing, processing, and tracking.

  3. On the KMC Upload tab upload the End-Users CSV.

Bulk processing in Kaltura is handled in an asynchronous batch process. Track the completion status of the bulk job in the KMC on the Bulk Upload Log page or using email notifications set by Kaltura for your account.

Updating the Add Members Auto-Complete List

You may need to update the Add Members auto-complete list when users join or leave your organization.

To add or delete users, you can:

NOTE: Deleted users are also removed from all channels in which they are members. Content ownership and analytics information of the deleted user are not deleted.

NOTE: Since user records are shared by all Kaltura applications running on the same account, we recommend that you delete records only of users who left the organization. 

NOTE: Integrating the Add Members auto-complete feature directly with your information system to enable a real-time search of users may be possible as custom work. The integration requires real-time access and search capabilities based on user ID and user name. To learn more, contact Kaltura.

 

To develop an automated process for periodically updating the Add Members auto-complete users list

  1. Define how frequently to schedule the update.
    Decide how often you need to update the Add Members auto-complete users list, and schedule the frequency of the update process accordingly.
  2. Develop an automated process that includes:
  3. List the users to add or delete in the Add Members auto-complete users list.
    Create the list of users to be added or deleted, based on your information system audit, querying, and export capabilities.
  4. Prepare the End-User CSV.

Transform your update data to comply with the Kaltura’s end-users CSV format for adding/deleting users from the user list. Insert the CSV field headers and specify the actions.

To add a user, use the CSV add or update action (action = 6). To delete a user, use the CSV delete action (action = 3).

User records are added/updated/deleted using Kaltura's End-Users CSV

Submit the End-User CSV.

When the End-Users CSV is available, submit it to Kaltura using the Kaltura API: Call the user.addfrombulkupload API action.

Bulk processing in Kaltura is handled in an asynchronous batch process. Track the completion status of the bulk job in the KMC on the Bulk Upload Log page or using email notifications set by Kaltura for your account.

NOTE: For the updating process, you can use direct Kaltura API calls (user.add, user.delete) instead of the CSV.

    To develop a trigger-based process for updating the Add Members auto-complete users list

NOTE: For changes in your information system to trigger real-time updates to the Add Members auto-complete users list, your information system or related applications must support real-time triggering of notifications to other systems.

Develop the following:

  1. Trigger an Add User notification.
    Create a script that implements the following Kaltura API requests when a new user who is eligible to access MediaSpace is added to your information system.
    • Call the user.add API action to create a new user record. Specify at least the following:
      • User ID
      • User’s first name
      • User’s last name
      • screenName (Combine the first and last names.)
  2. Trigger a Delete User notification.
    Create a script that implements the following Kaltura API requests when a MediaSpace user leaves your organization.
    • Call the user.delete API action to delete the user’s record from Kaltura.
    • Specify the User ID.
  3. Trigger an Update User notification.
    Create a script that implements the following Kaltura API request when an existing MediaSpace user's name changes in your information system.
    • Call the user.update API action to update the user record. Specify the following:
      • User ID
      • Updated values for:
        • User’s first name
        • User’s last name
        • screenName (Combine the first and last names
In This Article