Skip to main content

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, enter the Web API URL, User Name, and Password in their respective fields.

  2. To set up a proxy server, select the desired proxy in Proxy.

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

  4. In the File Handling Configuration section, in Folder Path, do one of the following:

    • To browse to a folder, select the ellipsis button.

    • Enter the path to a folder manually 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; sub-folders are not scanned for files.

    The connector only reads files with the .json extension.

  5. In Thumbnail Path, do one of the following:

    • To browse to a thumbnail image file, select the ellipsis button.

    • Enter the path to a thumbnail image file that is used to display the SaaS product logo.

    The selected and valid thumbnail is displayed in the Thumbnail space.

    note

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

  6. In File Cleanup, select one of three options that control what happens with files once data is read from them. Archive is selected by default.

    • Delete: Files that have had data read from them are deleted.

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

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

  7. In the Account Configuration section, enter the Account Id which is the unique ID for this account instance. It is recommended to take the value from the SaaS product itself. If the value is unavailable, you can populate this field using Generate.

    note

    • Copy and save the value of the Account Id to reuse later for recreating the connector.

    • The Account Id data structure consists of Vendor Name, Product Name, and an Account Type Id that together uniquely identify the account type. If the property values describe the same account type, then the property values can be used with multiple instances of the SaaS generic connector.

    EXAMPLE

    Vendor Name: Slack Technologies Inc.

    Product Name: Slack

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

  8. In Creation date, do one of the following:

    • To display the date when the SaaS account was created with the SaaS provider, select a date manually.

    • If the Creation date is unavailable, clear the checkbox.

  9. To populate the Account Type Id, select Generate. The value is a Universally Unique Identifier (UUID) which is a 128-bit integer number used to identify resources. If you want to create multiple connectors with the same account type, you must use the previously generated value.

  10. Enter the Vendor Name of the SaaS product vendor, that is the manufacturer.

  11. Enter the Product Name of the SaaS product.

  12. To save the settings and close the configuration window, select OK.