Getting Started with Rules in the CoLab

Use this category to view and download Identity Security Cloud (ISC) rules built by the community.

:bangbang: You must update all inputs in the rule to match the inputs in your Identity Security Cloud environment before uploading to your environment. If you are unfamiliar with rules at this stage, please read the rules documentation before using any CoLab items.

There are two types of rules in Identity Security Cloud: cloud rules and connector rules. It is important to know the difference in steps when you’re using rules from the CoLab.

Cloud Rules

Follow these steps to download and use a cloud rule from the CoLab:

  1. Choose a cloud rule that you want in the CoLab and click the GitHub link to download the rule.

  2. Download the cloud rule from GitHub.

  3. Open the cloud rule in your preferred code editor (we recommend Visual Studio Code if you do not have one).

  4. Read the documentation specified in your cloud rule’s CoLab topic to identify all the inputs you must update in the cloud rule to reflect your environment. Carefully replace each input. Then save the file.

  5. Before submitting your cloud rule, test your rule logic with the Rule Development Kit

  6. Run the Rule Validator against your cloud rule to validate syntax and code usage.

  7. Submit your cloud rule for upload to Identity Security Cloud.

Connector Rules

Follow these steps to download and use a connector rule from the CoLab:

  1. Download the connector rule you want from the #colab:rules category.

  2. Open the connector rule in your preferred code editor (we recommend Visual Studio Code if you do not have one).

  3. Identify all the inputs you must update in the connector rule to reflect your environment. Carefully replace each input. Then save the file.

  4. Before uploading your connector rule, test your rule logic with the Rule Development Kit.

  5. Format your connector rule with a Java Escaping tool like Free Formatter.

  6. Upload your connector rule via API https://developer.sailpoint.com/idn/api/beta/create-connector-rule.

1 Like