Creating and Managing Catalogs

A catalog is a collection of SoR YAML templates stored in a version control system. SGNL currently supports adding GIT repositories as catalogs through the SGNL console. Therefore, any GIT service provider that supports the GIT protocol over HTTPS can be added to SGNL as a SoR Catalog.

To successfully add a repository of SoR YAML templates to the SGNL Console, SGNL expects the following:

1. The repository name could be any string allowed by the GIT service provider
2. The SoR YAML templates must be stored in the top level directory in the repository.
3. The SoR YAML templates must have the following extension: .sgnl.yaml, or .sgnl.yml
   • E.g., azure-ad.sgnl.yaml
   • Any files that do not have the .sgnl.yaml extension are ignored. For example, Readme.md
   • YAML templates stored in a directory are ignored
4. The GIT repository must be versioned using GIT tags and the tag names must follow Semantic Versioning 2.0. E.g., v1.2.3

Catalogs can be added to the SGNL Console through the Admin panel. Your client will come bootstrapped with a SGNL Managed Catalog, which will include templates for the most common Systems of Record. We are continuously adding support for new Systems of Record, and each release will be tagged with a new version number and will include feature additions to existing templates or support for new SoRs.

The GIT repository for a catalog can be either public or private. Private repositories may be added to SGNL, but will require Personal Access Tokens created and specified when adding the catalog for SGNL to be able to read and pull templates from the repository. SGNL only needs repository level content-only read permissions. Please follow the instructions below for your GIT service provider:

• Github: Fine-grained Personal Access Token
• Gitlab: Project Access Tokens
• Bitbucket: Repository Access Token

SGNL Managed Catalog

All SGNL clients come bootstrapped with a SGNL-managed catalog backed by a Github repository that contains templates for common SaaS SoRs such as Salesforce, Azure Active Directory, ServiceNow, etc.

Adding a Custom Catalog

1. Login to SGNL Console
2. From the Navigation on the left, select Admin

3. Click on “SoR Template Catalog”, which will take you to the list of Catalogs.

4. SGNL SoR Catalog is a SGNL managed catalog that is available to all clients. Click on the “+ Add Catalog” button at the top next to “SoR Template Catalogs”

5. Enter the following information:

• Catalog Display Name: To help you identify the catalog
• Optional description
• GIT Repository URL: The HTTPS GIT URL for the repository
• Select an Authentication Method. Select “No Authentication” if the repository is public.
• If Basic or Auth Token is selected, enter the credentials.

6. Click on “Retrieve Tags”, which will display a list of GIT tags that you may select from. Click “Save”.
7. SGNL creates the catalog and populates it with the templates in the repository as shown below. You will then be able to click on a template, modify the fields as you see fit, and launch the corresponding SoR.

Walkthrough of Creating Catalogs in SGNL

For a walkthrough on how to create catalogs in SGNL, watch the video below.