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
12961296
  1. From the Application Type drop-down menu, select the application type.
  2. Click Download CSV Template.
35163516

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.
34803480
  1. Enter the information as shown in the following table.

📘

Note:

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

Field

Description

Example

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.
30023002
  1. Enter the information as shown in the following table.

📘

Note:

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

Field

Description

Example

Name*

Enter a name for the application

Acme SSH 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: 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.
28782878
  1. Enter the information as shown in the following table. 

📘

Note:

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

Field

Description

Example

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 RDP

3389

Server type (optional)

Enter one of the following server types:

  • DEFAULT
  • OLD
  • XRDP

OLD

AD Domain (optional)

Enter an Active Directory Domain

mydomain

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 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 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.
27262726
  1. Enter the information as shown in the following table. 

📘

Note:

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

Field

Description

Example

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 name

Axis 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.
12961296
  1. From the Application Type drop-down menu, select the application type. 
  2. Click Upload CSV File.
35163516
  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 Type

Error Message

Troubleshooting

General validation errors

Invalid CSV file

  1. 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 large

The maximum file size is 1 MB.

CSV file is empty

Make sure there is at least one filled row

Missing headers

Make sure all of the headers from the downloaded template are included.

Missing information - Name field can’t be empty

Make sure you have populated the Name field.

An application with the same name () already exists in the system

Remove the new entry

Application appears in the CSV more than once with the same name- First appearance will be used

The new entry will not be imported. Change the new application's name.

Self-Hosted Web Application

Missing information - Local Address field can't be empty

Specify the address (domain or IP).

Local Address () is invalid

The value is not a valid hostname or IP address.

Missing information - Port field can't be empty

Make 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- 65535

Make 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-65535

Make 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 empty

Make 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 exist

Make 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 empty

Make 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 exist

Make 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 empty

Make sure to specify a protocol (HTTP or HTTPS).

Invalid protocol-  Specify HTTP or HTTPS

Make sure the Protocol field contains either HTTP or HTTPS.

Missing information - Remote Address field can't be empty

Make sure to add a URL to access applications from outside the internal network

Remote Address () is invalid - Invalid domain

Make 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 domain

For 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 system

If 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 name

Make sure to use a remote address that is not already in use.

Root Path () is invalid

Make sure the value entered is a valid root path.

At least one of the additional domains is invalid

One of the additional domains is not in the format <http/s>://: OR the domain is not a valid hostname

SSH Server Application

Missing information - Local Address field can't be empty

Specify the address (domain or IP)

Local Address () is invalid

The value is not a valid hostname or IP address

Missing information - Port field can't be empty

Make 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- 65535

Make 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-65535

Make 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 empty

Make 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 exist

Make 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 empty

Make 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 exist

Make 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 Application

Missing information - Local Address field can't be empty

Specify the address (domain or IP)

Local Address () is invalid

The value is not a valid hostname or IP address

Missing information - Port field can't be empty

Make 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- 65535

Make 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-65535

Make 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 empty

Make 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 exist

Make 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 empty

Make 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 exist

Make 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 invalid

Make sure the value is DEFAULT / OLD / XRDP

AD Domain () is invalid

The 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 Application

Missing information - at least one of the fields (IP Ranges or DNS Searches) must be filled

Enter address ranges in your local network. You can add a DNS wildcard or IP ranges.

At least one of the IP ranges is invalid

Make sure to enter a valid IP range. Example: 10.0.0.2/24

At least one of the DNS searches is invalid

Make sure to enter a valid DNS search or wildcard. 
Example: *acme.com

At least one of the excluded DNS searches is invalid

If 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 empty

Specify the ports and protocols for accessing this application.

At least one of the Allowed Ports and Protocols is invalid

Make sure the value is “:<tcp/udp>” or “


Did this page help you?