Configuration

1NCE Services Configuration and Setup

Network Settings

The network settings contain the basic information to get the SIM Cards connected to the 1NCE network.

Parameter

1NCE APN

Needs to be set in the very first step to set up a connection to the network.

SMSC Number

Is generally needed to aim all Mobile Originated SMS in the network, although this setting is rarely needed for manual configuration.

Internet Breakout

Shows the IP addresses used for all 1NCE SIMs to access the public internet through a NAT.

IP Address Space

Shows the IP spaces assigned to SIMs in the given organization. Each SIM has a static IP address which can to be used for direct access via the VPN Service. Additional IP spaces will be assigned for new SIM orders if the remaining IP space is not large enough.

IP Addresses

Shows the availability of the IP address spaces assigned to the organization.

11221122

Network Settings in the Configuration tab.


Monthly Limits

By using "Monthly Limits" a customer can set an individual monthly data and SMS limit. The SMS limit can be configured separately for Mobile Originated (MO) and Mobile Terminated (MT) SMS. These limits will be applied to all of the customer's SIMs. By checking or unchecking the boxes these options can be set or cancelled easily at any time.

Exceeding the Limits

When the self-set limits are exceeded, error or warning messages are triggered based on the type of limit.

Data Session

When the limit is reached, new PDP data sessions will be rejected: PDP Context Request rejected, because endpoint is currently blocked due to exceeded traffic limit. However, some devices might retry indefinitely to reconnect in such a case. 1NCE strongly advices to use a back-off approach in this rejection case to not flood the network with PDP session requests.

MT-SMS

Using the 1NCE API, if the self-set limit for MT-SMS is reached, Traffic limit of X SMS per month exceeded is returned as error.
In the 1NCE Portal Set monthly limit of SMS exceeded is shown, when the MT-SMS limit was reached and a new SMS is issued.

MO-SMS

For MO-SMS no notification will be shown in the 1NCE Portal or Data Stream. The SMS will be rejected by the network resulting in an error return code from the device modem.

12311231

Monthly Limits configuration for Data and MO-/MT-SMS.


Global IMEI Lock

A global IMEI Lock can be set for all SIM Cards of the organization. The IMEI lock works by saving the IMEI of the device the SIM is installed in. With the feature enabled, the 1NCE network will only accept the saved device IMEI - SIM card combination to access the network resource. Any other IMEI - SIM combination will be refused. If this feature is activated, the IMEI lock will be set during the next network attach. Consequently the SIM card can only be used with the current device. For new SIM Card orders a checkbox can be selected to enable the IMEI lock by default. This way newly ordered SIMs will have the IMEI Lock set automatically. A separate IMEI lock for individual cards of the organization can be set either via the 1NCE API or in the "My SIMs" tab.

14991499

Global IMEI SIM lock settings.


Auto Top-Up

Automatic Top-Ups can be configured globally for all SIMs of an organization. The top-up will be automatically booked once a SIM card has <20 % data and/or SMS volume. To use this feature customers have to add their credit card details in the "Account" tab. By ticking the check-box it is possible to activate the auto-top-up for all future SIM orders by default. This feature can also be individually (de-)activated for a single SIM card via the Management API or the tab "My SIMs" and then the SIM-Detail page.

13391339

Auto Top-Up configuration for enabling global SIM top up.


Data Streams

The 1NCE Data Streaming Service allows customers to subscribe to real-time event and usage data for all SIM Cards by pushing data directly to the customer's server or an already integrated cloud service such as AWS Kinesis, S3, DataDog or Keen.io.

The Data Streams configuration shows a list of all currently configured streams including the name, API type, stream type, URL, status indicator and controls for each stream. Each stream can be controlled individually. Besides basic stop, start and delete, a stream integration can be restarted. A restart needs to be performed if the stream enters a error state and needs to be recovered.

To create a new data stream integration click on the New Data Stream button. Further details on how to setup a stream integration can be found in the Data Streamer Setup Guides section of the Developer Hub.

12181218

Overview of the current Data Streamer integrations.


SMS Forwarding Configuration

The SMS Forwarding configuration allows for receiving Mobile Originated (MO) SMS with a custom HTTP endpoint integration. For the configuration, the customer needs to insert the URL of the server, which shall receive the SMS. Further necessary details on configuration of SMS forwarding can be found in the SMS Forwarding Service section of the Developer Hub.

12111211

Configuration of the SMS Forwarding Service.


OpenVPN Configuration

The OpenVPN configuration provides a short introduction to setting up the 1NCE VPN Service. OpenVPN is the recommended application setup by 1NCE to establish a secure data connection between the 1NCE network and the customer server.
The OpenVPN client needs to be installed on the customer server to which the SIMs should access via the VPN client IP. For the OpenVPN connection to the 1NCE network a configuration file and credentials file is needed. These files can be downloaded in this section of the 1NCE Customer Portal. There are two different versions for Windows and for Linux/MacOS available. For more details about the VPN Service, its setup and operation users can proceed to the VPN Service section of the Developer Hub.

12351235

Download section for the OpenVPN configuration and credential files.


Did this page help you?