File upload (csv) format

The system accepts file uploads in UTF8 encoded comma seperated values format. All uploaded should include a header line which contains the titles to each of the columns. For example:

employeeID,firstname,lastname,mobilephone,officephone,homephone,workemail,personalemail,department,city,country

The above is an example of a file that will provide full functionality of the alerting platforms. The absolute minimum information required is:

name,mobilephone,email

JSON

The API service has a simple JSON structure to stream data into NGS.

[
	{
		"employeeid":"xxxx",
		"firstname":"First",
		"lastname":"Last",
		"mobilephone":"0015551231232",
		"officephone":"00441940111111",
		"home":"00441940111111",
		"workemail":"firstname.lastname@work.tld",
		"personalemail":"firstname.lastname@home.tld",
		"department":"TSG Support & End-user Engineering Department",
		"city":"Boston",
		"country":"United States of America"
	}
]

The API is authenicated through one of two methods, API key or bearer token. Either of these can be requested from your account manager.

Phone number format

Badly formatted phone numbers are the most common issue. Ideally, all phone numbers within the upload files will be in the correct international format. Acceptable phone number formats are as follows:

• 00447734211611
• +447734211611
• 447734211611

While the system will do its best to handle most errors, it is unable to take a number without an international prefix.

Data Security

Data Security is important to everyone. We have put in place a number of controls to ensure that your information remains safe while on our systems.

Data Transport:

- We only accept https connections at TLSv1.2 with strong ciphers.
- For file transfer, we use SFTP with sandboxed accounts and AES256 encryption.

Data Encryption:

- We support PGP/GPG file encryption.
- Data at rest is protected with AES-256 encyrption.

Database Security:

- All records are protected with an encryption key unique to each client and each upload.
- Only the current dataset is retained.

Deleting my Data:

We provide you with a singular way of deleting your data, should you wish to do that. On the main page is a "Delete" button in the Global Options. Clicking and confirming the action will result in the encryption keys for your current dataset being deleted from memory and the data within your areas of the database being purged. This is 100% unrecoverable."