Structure of the file importing custom web services (CSV format)

For each custom web service that can be imported or exported, this section defines the structure of a row that makes up the CSV file.

Importing/exporting custom web services

These services can be imported/exported in Objects > WEB SERVICES:

  • Import custom services tab to import,
  • List of web services tab to export (Export custom database menu).

Import CSV file: structure and limitations

  • Each line of the file is made up of several fields, all separated by commas,

  • Empty optional fields will be included between two commas,

  • The file must contain a blank line after the last entry.

#name,#ip/fqdn,#date,#revision,#comment

Field Description
Service name (mandatory)

Text string meeting the following criteria:

  • Maximum 20 alphanumeric characters,

  • Text string using only accepted characters (see Allowed names),

  • Case insensitive; the name will always be considered in lowercase. Uppercase characters are not kept on the SNS firewall during import.
IP address or FQDN (mandatory)

Public IPv4/IPv6 address or FQDN. An FQDN can contain only one wildcard * at the beginning or middle of its name.

If a web service relies on several IP addresses or several FQDNs, the line that describes it must be duplicated as many times as the number of addresses IP or FQDNs that the service web contains. Only the optional information from the first line will be kept.
Date of revision (optional)

Date and time of revision in YYYY/MM/DD or YYYY/MM/DD hh:mm format (e.g., 2022/10/15 10:30).
Revision number (optional)

Revision number that may contain up to 3 digits: major.minor.patch (e.g., 10.2).
Comments (optional) Free-form text string that can be placed between quotes if it contains commas.

name1,1.1.1.1,2021/09/21 11:00,1.1.1,Simple case
name2,2.2.2.2,2021/12/31,2,"Comment, with comma"
name2,domain.tld,2022/01/01,3,"Date, revision and comment are discarded"
name3,*.newdomain.tld,,,No date and revision

There are limits as to the number of lines allowed in the import file:

Physical SNS firewalls

  

Elastic Virtual Appliances (EVA)

SN160(W)

 5 000

SN210(W), SN310

 10 000
SN-S-Series-220, SN-S-Series-320,
SN510, SN710, SNi20, SNi40		 100 000
SN-M-Series-520, SN-M-Series-720,
SN910, SN-M-Series-920, SN1100,
SN2000, SN2100, SN3000, SN3100,
SN6000, SN6100		 1 000 000
 
EVA with 1 GB of RAM 10 000
EVA with 2 GB to 6 GB of RAM 100 000
EVA with 8 GB to 64 GB of RAM 1 000 000

There is a limit to the possible number of lines containing an FQDN with a wildcard * in the middle: 10% of the number of lines allowed in the import file.