Configure the SaaS - Generic connector

The SaaS - Generic connector reads data from files that are saved in a folder and sends it to the Snow License Manager API.

In Snow Integration Manager, add the SaaS - Generic connector and configure the settings:

  1. In the Snow License Manager Connection section, configure the connection to Snow License Manager:

    1. Enter the Web API URL, User Name, and Password in their respective boxes.

    2. Select Test connection.

      If the connection to Snow License Manager is successful, a message is displayed, and the Customer box is populated with a Snow License Manager customer name.

    SaaS_Generic_connector_configuration.png
  2. In the File Handling Configuration section:

    1. In the Folder Path box, either select the ellipsis button to browse to a folder or manually enter the path to a folder from where the connector looks after JSON files to use.

      Note

      Every instance of the Saas - Generic connector must use a different folder.

      The connector only reads files from the specified folder; subfolders are not scanned for files.

      The connector only reads files with the .json extension.

    2. In the Thumbnail Path box, either select the ellipsis button to browse to a thumbnail image file or manually enter the path to to a thumbnail image file that is used to display the SaaS product logo. A selected and valid thumbnail image file is displayed in the Thumbnail section.

      Note

      We recommend that the file size of the thumbnail image file does not exceed 1 MB and that it is not wider or higher than 500 pixels.

    3. In the File Cleanup drop-down menu, select one of three options that control what happens with files once data is read from them. Archive is the default.

      1. Delete: files that have had data read from them are deleted.

      2. Archive: a folder named Archive is created in the specified folder; files that have had data read from them are moved to this folder.

      3. No action: no action is taken on the JSON files in the folder.

  3. In the Account Configuration section:

    1. Account Id: this is the unique ID for this account instance. We recommend that the value is from the SaaS product itself. If that value is not available, one can automatically be generated by selecting Generate.

      Save this value somewhere safe to later be able to recreate the connector; in that case, the Account Id must be reused.

    2. Creation Date: this is the date when the SaaS account was created with the SaaS provider. Select date manually. If the creation date is not available, clear the checkbox.

    3. Account Id: this is the data structure that consists of Vendor Name, Product Name, and an Account Type ID that together uniquely identifies the account type. The property values can be used with multiple instances of the SaaS - Generic connector if the property values describe the same account type.

      Save these values for Vendor Name, Product Name, and Account Type ID somewhere safe to later be able to recreate the connector.

      Example 13.  

      Vendor Name: Slack Technologies Inc.

      Product Name: Slack

      Id: bc923fb4-241b-4a23-a433-01b501ed74c6



    4. Account Type Id: select Generate to populate this box. The value is a universally unique identifier (UUID) which is a 128-bit integer number used to identify resources. If one wants to create multiple connectors with the same account type, the previously generated value must be used.

    5. Vendor Name: this is the name of a SaaS product vendor, i.e. the manufacturer. Enter the name in the Vendor Name box.

    6. Product Name: this is the name of the SaaS product. Enter the name in the Product Name box.

  4. Select OK to save the settings and close the configuration window of the connector.