Creating Applications in Bulk

To accelerate the onboarding process, applications can be created and imported in bulk using a CSV (comma-separated values) file for the following application types: 

  • Network Range 
  • Remote Desktop Server (RDP)
  • Self-Hosted Web Application
  • SSH Server

Each application type has its own CSV file.

To create and import applications in bulk:

  1. Download and modify the CSV file for each application type
  2. Upload the CSV file to Axis Security

Step 1: Downloading and Modifying the CSV File

Download and modify the CSV file for each application type.
To download a CSV file:

  1. In the Management Console, go to Settings > Applications
  2. Click Import
1296
  1. From the Application Type drop-down menu, select the application type.
  2. Click Download CSV Template.
3516

Importing Self-Hosted Web Applications

To import self-hosted web applications:

  1. Select the Web Application Type.
  2. Click Download CSV Template.
  3. Open the downloaded CSV file.
  4. Delete the explanation and example row as shown in the following screenshot.
3480
  1. Enter the information as shown in the following table.

📘

Note:

Headers marked with an asterisk (*) are required for importing the applications.

FieldDescriptionExample
Name*Enter a name for the application.Acme web app
Local Address*Enter the primary domain or an IP.acme.com
Protocol*Enter a protocol: HTTP or HTTPS HTTP
Port*Specify the application’s Local Domain/FQDN/IP address that is visible to the connector from the network segment:  
80 for HTTP or 443 for HTTPS
80
Connector Zone*Enter a connector zone name.Default connector zone
Identity Provider*Enter an Identity provider name.Axis IdP
Tags (optional)Enter tags separated by a semicolon ";"Tag1;Tag2

Importing SSH Server Applications

To import SSH applications:

  1. Select the SSH Application Type.
  2. Click Download CSV Template.
  3. Open the downloaded CSV file.
  4. Delete the explanation and example row as shown in the following screenshot.
3002
  1. Enter the information as shown in the following table.

📘

Note:

Headers marked with an asterisk (*) are required for importing the applications.

FieldDescriptionExample
Name*Enter a name for the applicationAcme SSH app
Local Address*Enter the primary domain or an IPacme.com
Port*Specify the application’s Local Domain/FQDN/IP address that is visible to the connector from the network segment: 22 for SSH.22
Server username (optional)When the server username and password fields are defined, users will not be prompted to enter their personal credentials when accessing the application. 
Note: if you define a server username, you must define a password as well.
Bjones
Server password (optional)When the server username and password fields are defined, users will not be prompted to enter their personal credentials when accessing the application. 
Note: if you define a server username, you must define a password as well. 
Password1
Connector Zone*Enter a connector zone name.Default connector zone
Identity Provider*Enter an Identity provider name.Axis IdP
Tags (optional)Enter tags separated by a semicolon ";"Tag1;Tag2

📘

Note:

When accessing the application users will be prompted to enter their credentials.

Importing Remote Desktop Server Applications

To import remote desktop server applications:

  1. Select the RDP Application Type.
  2. Click Download CSV Template.
  3. Open the downloaded CSV file.
  4. Delete the explanation and example row as shown in the following screenshot.
2878
  1. Enter the information as shown in the following table. 

📘

Note:

Headers marked with an asterisk (*) are required for importing the applications

FieldDescriptionExample
Name*Enter a name for the application.Acme RDP app
Local Address*Enter the primary domain or an IP.acme.com
Port*Specify the application’s Local Domain/FQDN/IP address that is visible to the connector from the network segment: 3389 for RDP3389
Server type (optional)Enter one of the following server types:
DEFAULT
OLD
* XRDP
OLD
AD Domain (optional)Enter an Active Directory Domainmydomain
Allow users to save credentials (optional)Enter "TRUE" to allow the Axis Cloud to remember the users' credentials when they connect to the RDP.TRUE
Connector Zone*Enter a connector zone nameDefault connector zone
Identity Provider*Enter an Identity provider name.Axis IdP
Tags (optional)Enter tags separated by a semicolon ";"Tag1;Tag2

📘

Note:

When accessing the application, users will be prompted to log in with their personal desktop credentials.

Importing Network Range Applications

To import network range applications:

  1. Select the Network Range Application Type.
  2. Click Download CSV Template.
  3. Open the downloaded CSV file.
  4. Delete the explanation and example row as shown in the following screenshot.
2726
  1. Enter the information as shown in the following table. 

📘

Note:

Headers marked with an asterisk (*) are required for importing the applications

FieldDescriptionExample
Name*Enter a name for the application.Acme Network Range app
Address Range*Enter the address ranges in your local network. You can add a DNS wildcard or IP ranges.*acme.com; 10.0.0.1/24
ICMP Enabled (optional)Enter "TRUE" to enable ICMP in the network range.TRUE
Allowed ports and protocols*Enter port range and protocol (TCP/UDP) as follows: "range:protocol".1-10:TCP
Connector Zone*Enter a connector zone name.Default connector zone
Identity Provider*Enter an Identity provider nameAxis IdP
Tags (optional)Enter tags separated by a semicolon ";"Tag1;Tag2

Step 2: Uploading the CSV file to Axis Security

To upload the CSV file: 

  1. In the Management Console, go to Settings > Applications
  2. Click Import.
1296
  1. From the Application Type drop-down menu, select the application type. 
  2. Click Upload CSV File.
3516
  1. Click Submit.

CSV Validation Errors and Troubleshooting

The following table includes possible errors and how to troubleshoot them. 
For additional assistance, contact Axis support: [email protected] 

Application TypeError MessageTroubleshooting
General validation errorsInvalid CSV file1. Make sure that multiple values in a field are separated, using a semicolon ";"
2. Make sure the header names are correct.
File size is too largeThe maximum file size is 1 MB.
CSV file is emptyMake sure there is at least one filled row
Missing headersMake sure all of the headers from the downloaded template are included.
Missing information - Name field can’t be emptyMake sure you have populated the Name field.
An application with the same name () already exists in the systemRemove the new entry
Application appears in the CSV more than once with the same name- First appearance will be usedThe new entry will not be imported. Change the new application's name.
Self-Hosted Web ApplicationMissing information - Local Address field can't be emptySpecify the address (domain or IP).
Local Address () is invalidThe value is not a valid hostname or IP address.
Missing information - Port field can't be emptyMake sure to enter a port for the application. The common ports used for web applications are:
80 for HTTP
443 for HTTPS
Port () is not in range- Value must be within the following range: 1- 65535Make sure the port is within the range 1- 65535, and is relevant for a web application. The common ports used for web applications are:
80 for HTTP
443 for HTTPS
Port () is invalid- Input must be a number within the following range: 1-65535Make sure the value entered in the port column is an integer between 1-65535.
The common ports used for web applications are:
80 for HTTP
443 for HTTPS
Missing information - Connector Zone field can't be emptyMake sure to fill out the relevant connector zone name. 
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Connector Zone () does not existMake sure to add an existing connector zone. 
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Missing information - Identity Provider column can't be emptyMake sure to add the Identity Provider through which the users will authenticate before accessing the application. 
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Identity Provider () does not existMake sure to add an existing Identity Provider. 
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Missing information - Protocol field can't be emptyMake sure to specify a protocol (HTTP or HTTPS).
Invalid protocol-  Specify HTTP or HTTPSMake sure the Protocol field contains either HTTP or HTTPS.
Missing information - Remote Address field can't be emptyMake sure to add a URL to access applications from outside the internal network
Remote Address () is invalid - Invalid domainMake sure the hostname is a valid domain. 
Example: www.acme.com
Remote Address () is already in use by another application- ()Specify a remote address that is not already in use in your tenant
Remote Address () is invalid Axis domainFor an Axis domain, make sure the remote address ends with "axisapps.io"
No certificates found to match the domain- Remote domain (x) doesn’t match any of the certificates uploaded to the systemIf you are using a custom domain, make sure to upload a domain certificate to your tenant. 
To view a list of certificates go to Settings-> Certificates.
Remote Address ()  appears more than once with the same nameMake sure to use a remote address that is not already in use.
Root Path () is invalidMake sure the value entered is a valid root path.
At least one of the additional domains is invalidOne of the additional domains is not in the format <http/s>://: OR the domain is not a valid hostname
SSH Server ApplicationMissing information - Local Address field can't be emptySpecify the address (domain or IP)
Local Address () is invalidThe value is not a valid hostname or IP address
Missing information - Port field can't be emptyMake sure to enter a port for the application. The common port used for SSH applications is 22.
Port () is not in range- Value must be within the following range: 1- 65535Make sure the port is within the range 1- 65535, and is relevant for SSH applications. The common port used for SSH applications is 22
Port () is invalid- Input must be a number within the following range: 1-65535Make sure the value entered in the port column is an integer between 1-65535 and is relevant for your SSH application. The common port used for SSH applications is 22.
Missing information - Connector Zone field can't be emptyMake sure to fill out the relevant connector zone name. 
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Connector Zone () does not existMake sure to add an existing connector zone.
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Missing information - Identity Provider column can't be emptyMake sure to add the Identity Provider through which the users will authenticate before accessing the application.
To view a list of Identity Providers for your tenant go to Settings-> Identity Providers
Identity Provider () does not existMake sure to add an existing Identity Provider.
To view a list of Identity Providers for your tenant go to Settings-> Identity Providers
Remote Desktop Server ApplicationMissing information - Local Address field can't be emptySpecify the address (domain or IP)
Local Address () is invalidThe value is not a valid hostname or IP address
Missing information - Port field can't be emptyMake sure to enter a port for the application. The common port used for RDP applications is 3389.
Port () is not in range- Value must be within the following range: 1- 65535Make sure the port is within the range 1- 65535, and is relevant for your RDP application. The common port used for RDP applications is 3389.
Port () is invalid- Input must be a number within the following range: 1-65535Make sure the value entered in the port column is an integer between 1-65535 and is relevant for an RDP application. The common port used for RDP applications is 3389.
Missing information - Connector Zone field can't be emptyMake sure to fill out the relevant connector zone name. 
To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Connector Zone () does not existMake sure to add an existing connector zone. To view a list of connector zones go to Settings-> Connectors-> Connector Zones.
Missing information - Identity Provider column can't be emptyMake sure to add the Identity Provider through which the users will authenticate before accessing the application. To view a list of Identity Providers for your tenant go to Settings-> Identity Providers
Identity Provider () does not existMake sure to add an existing Identity Provider. 
To view a list of Identity Providers for your tenant go to Settings-> Identity Providers
Server type () is invalidMake sure the value is DEFAULT / OLD / XRDP
AD Domain () is invalidThe specified AD Domain is invalid. Enter a valid AD Domain.
Allow Users Save Credentials input  () is invalid- Specify “true” or “false”Make sure to enter "true" if you want to allow users to save their credentials, or "false" if you do not.
Network Range ApplicationMissing information - at least one of the fields (IP Ranges or DNS Searches) must be filledEnter address ranges in your local network. You can add a DNS wildcard or IP ranges.
At least one of the IP ranges is invalidMake sure to enter a valid IP range. Example: 10.0.0.2/24
At least one of the DNS searches is invalidMake sure to enter a valid DNS search or wildcard. 
Example: *acme.com
At least one of the excluded DNS searches is invalidIf you choose to exclude a DNS search, make sure the address is valid.
Enable ICMP () is invalid- Specify “true” or “false”Enter "true" if you want to enable ICMP, or "false" if you do not.
Missing information - Allowed Ports and Protocols can't be emptySpecify the ports and protocols for accessing this application.
At least one of the Allowed Ports and Protocols is invalidMake sure the value is “:<tcp/udp>” or “