Integrations
The Integrations section of the TVE Dashboard allows you to view and manage settings for the integrations between your channels and MVPDs. You can also create a new integration as per your requirement.
The Integrations tab in the left panel displays a list of existing integrations with the following details:
- Status indicating whether the integration is currently active or inactive
- Integration linking specific channels with respective MVPDs
- Channel name with channel ID
- MVPD display name and MVPD ID
List of existing Integrations
Type the name of the channel or MVPD in the Search bar above the list to know more about the integration.
Manage integration configurations manage-integration-conf
Follow these steps to manage a specific integration.
-
Select the Integrations tab in the left panel.
-
Select an integration from the provided list to view and edit various settings in the following sections:
Endpoint selection endpoint-selection
This section enables you to choose the endpoints of the MVPD used for authentication, authorization, and logout flows from the respective dropdown menus.
Endpoints for authentication, authorization, and logout flows
Platform settings platform-settings
This section allows you to view and edit integration settings across all platforms. You can change these settings based on individual platforms. For example, you can adjust the Authorization TTL duration on Android while maintaining a default value for another platform.
Each property in platform settings inherit a default value set by the MVPD but can be adjusted if necessary.
Platform Settings is used to override settings for each level in the inheritance chain. The available levels in the chain are grouped as follows:
-
Default for All: Set values for properties applicable universally across all platforms if specific platform values are not defined, regardless of the Programmer’s implementations.
-
Desktop Devices: Set values for properties applicable to all desktop and laptop computers, irrespective of the programming method (JS SDK or REST API).
-
Mobile Devices: Set values for properties applicable to all mobile devices, including iOS, Android, and others, regardless of the programming approach (SDK or REST API).
-
TV Connected Devices: Set values for properties applicable to all TV connected devices, including tvOS, Roku, FireTV, and others, irrespective of the programming method (SDK or REST API).
-
Unidentified Devices: Set values for properties applicable to all devices where the current mechanism can’t accurately identify the platform. In such cases, apply the most restrictive rules defined by the MVPD.
Category of platforms and their devices
Select
Most used business flows most-used-flows
The Platform Settings section offers a range of properties used in different business flows. The actual properties may vary depending on the MVPDs selected in the specific integration. Below are the most used flows:
AuthN TTL and AuthZ TTL across all platforms
Follow these steps to change authentication and authorization TTL across all platforms for a specific integration.
-
Select the Integrations tab in the left panel.
-
Select the integration for which you want to change AuthN TTL and AuthZ TTL values.
-
Navigate to the Platform Settings section.
-
Select Default for All tab under Platform Settings.
note note NOTE If you want to change the duration of AuthN TTL and AuthZ TTL for a platform category or a specific platform, select the platform accordingly. 
Change AuthN TTL AuthZ TTL duration across all platforms
A. AuthN TTL property B. AuthZ TTL property
-
Select the upward and downward arrows to adjust the duration for the number of days, hours, minutes, and seconds in the AuthN TTL and AuthZ TTL properties.
The duration for AuthN TTL and AuthZ TTL across all platforms will be updated only after review and push changes.
Enable platform SSO
Follow these steps to enable or disable SSO for a specific integration and platform.
-
Select the Integrations tab in the left panel.
-
Select the integration for which you want to enable or disable single sign on.
-
Navigate to the Platform Settings section.
-
Select a specific platform or category of platforms for which you want to enable single sign on under Platform Settings.
Enable Single Sign On for a specific platform
A. Single Sign On property B. Enforce Platform Permissions property
-
Select Yes to enable or No to disable from the Enable Single Sign On dropdown menu.
-
Select Yes to enable or No to disable from the Enforce Platform Permission dropdown menu.
Enforce Platform Permission property controls if the user’s decision to Allow or Deny platform access to their TV Provider subscription is respected.
For example, if both the Enable Single Sign On and Enforce Platform Permission are enabled, and the user opts to deny platform access to their TV Provider subscription, then the respective application (channel) will be unable to use the Adobe Pass Authentication token obtained by another application (channel).
The Single Sign On property for a selected platform will be enabled or disabled only after review and push changes.
Enable home-based authentication
Follow these steps to enable or disable home-based authentication for OAuth2 based MVPDs.
-
Select the Integrations tab in the left panel.
-
Select the integration for which you want to enable or disable home-based authentication.
-
Navigate to the Platform Settings section.
-
Select a specific platform or category of platforms for which you want to enable home-based authentication under Platform Settings.
Enable home-based authentication for a specific platform
A. Attempt HBA property B. HBA AuthN TTL property
-
Select Yes to enable and No to disable from the Attempt HBA dropdown menu.
The Attempt HBA property for a specific MVPD will be enabled or disabled only after review and push changes.
Add more properties add-more-properties
The Add more properties allows the flexibility to include additional specific properties for integrations, particularly for less common flows.
You can add these properties:
- For all platforms, select Default for all tab on the left.
- For a category of platform, select Desktop Devices, Mobile Devices, or TV Connected Devices tab on the left.
- For a specific device, select iOS, Android, tvOS, Roku, or FireTV tab on the left.
Here are some examples of different flows that can be enabled by adding these properties:
Change the number for pre-authorized resources
Most MVPDs support a preflight authZ call using up to 5 resource IDs by default.
However, in cases where MVPDs agree to raise this limit, you can navigate to the Add more properties and select Preflight Max Resources from the options menu.
Preflight Max Resources will add a new attribute where the agreed limit with the MVPD can be specified.
Add Preflight Max Resources property
The Preflight Max Resources property will be added only after review and push changes.
Change MVPD display name or logo URL
For programmer applications that don’t want to build their MVPD picker and instead rely on provided configurations, you can navigate to the Add more properties and select Display Name or Logo URL to add the required display name or logo URLs for each MVPD from the options menu.
Different values for these properties can be used for the same MVPD depending on the device platform and the desired user experience.
Add Display Name or Logo URL property
The Display Name or Logo URL property will be added only after review and push changes.
Request a new authentication flow upon app (channel) switching
If you want to force a new authentication when users switch between apps. In that case, you can navigate to the Add more properties, select the Auth per Aggregator property.
Adding Auth per Aggregator effectively breaks single sign on for the respective channel.
Add Auth Per Aggregator property
The Auth per Aggregator property will be added only after review and push changes.
Once added, select Yes to enable Auth per Aggregator property for a selected integration.
Delete properties delete-properties
Select
The property will be deleted from the Platform settings section only after review and push changes.
User metadata user-metadata
This section allows you to update settings for each user metadata parameters shared by the MVPD.
The user metadata section displays the following columns:
Key: Represents the actual user metadata parameters to be used in the API to extract values.
Description: Provides a brief description of each user metadata parameter.
Encrypted: This column allows you to enable or disable parameters in the API by selecting Yes or No from the dropdown menu respectively. Opting for Yes indicates that the parameter value will be encrypted in the API. The encryption is performed using a certificate defined by a User metadata scope.
Learn more about available certificates in Programmers and Channels sections.
Enabled: This column allows you to enable or disable the parameters in the API by selecting Yes or No respectively from the dropdown menu.
Parameters available for User Metadata
Create new integration create-new-integration
To create a new integration with a new MVPD on your current setup, follow these steps:
-
Select the Integrations tab in the left panel.
-
Select Create new integration at the upper-right of the Integrations section.
Create a new integration
The following sections are displayed:
Select Channel and MVPD
Select a Channel from the Select Channel dropdown menu to add a new integration. Once you’ve selected the channel, select the required MVPD from the Select MVPD dropdown menu to be integrated with the selected channel.
Select Channel and MVPD
Select endpoints
After selecting the required MVPD, Select endpoint section will be pre-populated with the default endpoints configured for that particular MVPD.
note important IMPORTANT Don’t change the default endpoints in any flow unless stated specifically by the MVPD. 
Select endpoints
Additional information
This section includes various properties that need to be configured for the selected MVPD in the Select Channel and MVPD section.
note note NOTE The actual properties may differ depending on the MVPDs selected in the Select Channel and MVPD section. For example, you can edit the AuthN TTL or Partner ID (Channel ID) for co-branding purposes on the MVPD login page in the following image.
Edit Additional information
Select Save integration at the upper-right of the Create new integration section.
A new integration will be created only after review and push changes.
Disable integration disable-integration
To disable an integration, follow these steps:
-
Select the Integrations tab in the left panel.
-
Select the integration you want to disable.
-
Disable the toggle available at the top-right of the selected integration.
Disable integration
The integration will be disabled only after review and push changes.
After the integration is disabled, end users will lose the ability to authenticate or authorize using the specific MVPD.