Introduction

SaaS - Generic connector is a generic connector that enables the integration of data—users, subscriptions, and agreements—from third-party SaaS systems, via Snow Integration Manager into Snow License Manager. The data displays the number of active users in the SaaS provider solution and how much the subscriptions cost—if entered—per month in Snow License Manager, in the SaaS Overview category.

This connector reads data from a structured JSON file and converts it to a Snow format. The data is subsequently sent, processed, and presented in Snow License Manager. The data from the third-party SaaS system must be converted to a JSON file and conform to a JSON-schema definition. The schema file—generic_saas_schema.json—is found in the installation directory of Snow Integration Manager.

The connector is available in Snow Integration Manager from version 5.18. For detailed information, refer to Snow Integration Manager.

To successfully configure SaaS - Generic connector, take the contents of When to use SaaS - Generic connector into consideration. Also read the section Define a workflow.

Prerequisites

  • Snow Integration Manager 5.18 or later

  • The structured JSON file that is first mentioned in Introduction must be provided by the customer and adhere to the JSON-schema definition as described in the generic_saas_schema.json file.

Dependencies on other Snow products

The following Snow product versions are the minimum required version to support the SaaS - generic connector:

  • Snow Integration Manager 5.18

  • Snow License Manager 8.3

    To be able to use SaaS data to present in Snow License Manager, version 8.3 (or later) must be installed. This includes Web API 8.3.0 that is required to transfer data to Snow License Manager.

    A Snow License Manager user account is required for Web API authentication. The user account must either be member of the built-in role API Users or be member of a user-created role that is assigned both the GLOBAL > Complete access to all features and objects, and the WEB > Access to the License Manager Web API. See User Guide: Web API for Snow License Manager 8 or User Guide: Web API for Snow License Manager 9 for further details.

    The Snow License Manager API must be accessible from the machine where Snow Integration Manager is installed.

When to use SaaS - Generic connector

It is preferred to use one of the out-of-the-box SaaS connectors, rather than to create a new one by use of the SaaS - Generic connector, if possible. See the list of available SaaS connectors in Available integration connectors. If the SaaS product that you wish to integrate with Snow License Manager is not in the list, consider using SaaS - Generic connector.

If you decide to use SaaS - Generic connector, it is recommended to design a workflow where you both take into account how often that you want to update data in Snow License Manager and what data should be part of the update.

Warning

To successfully feed the connector, good knowledge of querying APIs, data processing, and structuring JSON data is required.