How to create rules using DOM files ?

Let us create an NGL query to list GitHub repositories that are disabled.

1. We need to write a NGL query on GitHub, hence the app suite will be GitHub.

2. Identify the resource type to be used based on the GitHub DOM file.

3. Since the NGL is checking for the status of the repository, the Repository resource type will be the Primary Resource Type to use here.

   

4. We need to choose an expression for the rule. Here we are trying to match a condition hence we will use a should-have expression. See Expressions article for more information.

5. Check the Repository resource type and pick a property that is appropriate for the requirement. In this case, we have to use the is_disabled boolean property as it stores the status of the repository.

   

6. Since we are checking for repositories that are not disabled the condition will be “is-disabled=false“.

7. Navigate to API-enabled Protection > Security Posture SaaS > Inventory menu and go to Resources tab. Click the Switch to NGL icon on the right side of the filters toolbar. This will open the NGL query tool which we can use to try the NGL queries.

8. Write the query as GitHub Repository should-have is_disabled = false. While writing the query, the NGL tool also indicates you with the possible options to write a rule.

9. Click search.

10. You will see a list of GitHub repositories which are not disabled. When converted to a rule, this will fail when the repositories have the condition “is-disabled=true”.

    

References

• Netskope Governance Language