Operators
Operators
Following are the operators used in NGL:
Logical
and
Usage: `and1 operator performs a logical and operation of the properties/statements immediately before and after it.
Syntax: property1 = value1 and property2 = value2
Example:
Microsoft365 sharepointtenant should-have sharingCapability = "Disabled" and enableAzureADB2BIntegration = falseExplanation: NGL will return all Microsoft365 apps’ that have sharing capability disabled and AzureAD B2B Integration option is false.
or
Usage: or operator performs a logical or operation of the properties/statements immediately before and after it.
Syntax: property1 = value1 or property2 = value2
Example:
Microsoft365 sharepointtenant should-have sharingCapability = "Disabled" or enableAzureADB2BIntegration = falseExplanation: NGL will return all Microsoft365 apps’ that have sharing capability disabled or AzureAD B2B Integration option is false.
not
Usage: not operator performs a logical not operation of the properties/statements immediately before and after it.
Syntax: not(property1 = value)
Example:
Microsoft365 sharepointtenant should-have sharingCapability = "Disabled" and not enableAzureADB2BIntegration = falseExplanation: NGL will return all Microsoft365 apps’ that have sharing capability disabled and where enabling AzureAD B2B Integration option is not false.
Arithmetic
+
Usage: + operator performs addition of values immediately before and after it.
Syntax: len(list1) + len(list2) > 0
–
Usage: - operator performs subtraction of values immediately before and after it.
Syntax: len(list1) – len(list2) > 0
*
Usage: * operator performs multiplication of values immediately before and after it.
Syntax: property1 * 2 > 10
%
Usage: % operator returns the remainder of the division of value immediately before and after it.
Syntax: property1 % 4 = 0
/
Usage: / operator performs division of values immediately before and after it.
Syntax: property1 / 4 > 0
Example:
microsoft365 securescore should-not-have controlscores with-any-element [ controlname = "AdminMFAV2" and (count / total < 1) ]Relational
=
Usage: = operator compares the property/statement/value before it with property/statement/value after it, and returns a boolean result.
Syntax: property1 = property2
Example:
Microsoft365 sharepointtenant should-have sharingCapability = "Disabled" Explanation: NGL will return all Microsoft365 apps’ that have sharing capability disabled.
!=
Usage: != operator negates an equality comparison of the property/statement/value before it with property/statement/value after it, and returns a boolean result.
Syntax: property1 != property2
Example:
Microsoft365 sharepointtenant should-have sharingCapability != "Disabled" Explanation: NGL will return all Microsoft365 apps’ that have sharing capability not disabled.
>
Usage: > operator performs a greater than comparison of the property/statement/value before it with property/statement/value after it, and returns a boolean result.
Syntax: property1 > property2
Example:
microsoft365 malwarefilterpolicy should-have len(FileTypes) > 0Explanation: NGL will return all Microsoft365 apps’ malware filter policy whose length of file type is greater than 0.
>=
Usage: >= operator performs a greater than or equal to comparison of the properties/statement/value before it with properties/statement/value after it, and returns a boolean result.
Syntax: property1 >= property2
Example:
microsoft365 malwarefilterpolicy should-have len(FileTypes) >= 10Explanation: NGL will return all Microsoft365 apps’ malware filter policy whose length of file type is greater than equal to 0.
<
Usage: < operator performs a lesser-than comparison of the properties/statement/value before it with properties/statement/value after it, and returns a boolean result.
Syntax: property1 < property2
Example:
microsoft365 malwarefilterpolicy should-have len(FileTypes) < 101Explanation: NGL will return all Microsoft365 apps’ malware filter policy whose length of file type is less than 101.
<=
Usage: <= operator performs a lesser-than or equal to comparison of the properties/statement/value before it with property/statement/value after it, and returns a boolean result.
Syntax: property1 <= property2
Example:
microsoft365 malwarefilterpolicy should-have len(FileTypes) <= 100Explanation: NGL will return all Microsoft365 apps’ malware filter policy whose length of file type is less than equal to 100.
Utility
( )
Usage:
- `()` is used to capture a functions’ input parameters, or to order boolean expressions. See Functions to learn more.
- ‘()’ is used to group elements.
Syntax: func1(arg1), (boolean1 or boolean2) and (boolean3 or boolean4)
Examples:
github repository should-have age(created_at , "days") > 1azuread deviceconfiguration should-have ( passwordminutesofinactivitybeforescreentimeout = 5 and passwordminutesofinactivitybeforelock = 0 ) or ( passcodeminutesofinactivitybeforescreentimeout = 5 and passcodeminutesofinactivitybeforelock = 0 )[ ]
Usage: [ ] is used to access an element of a list. with-element uses these elements in arrays [ item1, item2 ]. See Keywords to learn more.
Syntax: list_property [element1]
Example:
github app should-not-have write_permissions with-any-element [ "administration" ]{ }
Usage: { } is used to depict a structure. with-attribute uses this element to address key-value pairs inside nested objects { key1: val1, key2: val2 }.
Syntax: struct_attribute {member_attribute}
Example:
zoom User should-have in_meeting with-attribute { e2e_encryption = true }