Is it possible to add comments to an external list text file?
I am setting up an IP list and want to add comments for my team members to indicate the syntax the list is looking for. Any insight would be much appreciated.
For plain text files you can specify regex that will be used to select lines that will be imported. For example, if you want to treat as comments lines that starts with the '#' character, then you need to specify regex like ^[^#].*, so only strings that don't start with '#' will be included into list
Erik - this is helpful also. I wanted to lead in with some comments that detail what the syntax should be, and then I can also add comments here so we can track the entries also.
Sorry to jump in the middle here, but this raises an question for me: Are the comments available as a property to the rest of the gateway? My use case would be something like a custom black-list of malicious IP addresses with the comment being the date that specific entry was added to the list (or maybe it is the source of the blacklist, e.g. "Snort alert", or "ETPRO Reputation Feed". Being able to include the comment in the Block page and/or the access.log would be pretty cool. I looked around and couldn't find anything for this.
The list comments cannot be captured with a property and used anywhere like a block page.
They are strictly for documenting and viewing within the policy.
I've wanted something like that myself, but hasn't happened.
I think that you can do this with new Map Type that is available in 7.3.1 release. But comments should be on the same line as the data - so we could use regex to capture data & comments... You need to do following steps:
File with data should have following form:
10.149.114.44 # bad site
188.8.131.52 # another bad site
Block page template can contain expression: Map.GetStringValue(ExtLists.StringMap<your settings>(params...), IP.ToString(URL.Destination.IP)) - this will fetch comment for given IP address
I attached file with rules & block page, so you can play with this approach