Onomondo app features
Learn how to use the Onomondo app.
By Jakub and 6 others7 authors77 articles
Network Insight Tools
Network Logs, Signaling Logs and Traffic Monitor
- How to use Network LogsNetwork Logs show when your device tries to connect to Onomondo's network. Understanding them helps debug device connectivity issues.
- How to use Signaling LogsSignaling Logs are a way to see all communications between the local Radio Access Network (RAN) and Onomondo.
- What is the Traffic Monitor?Traffic Monitor captures all traffic packets sent to / from the device in real time.
- Is it possible to get traffic logs outside of the Onomondo App?Yes. You just have to install the Onomondo Live desktop app.
- What does the "network_whitelist" error in the Network Logs mean?The network_whitelist error occurs when the SIM tries to access a network that is not included in the network list assigned to that SIM.
- Can I visualize the trackers on a map?Onomondo does not support real-time mapping; use tracker data with a third-party mapping tool.
SMS
Sending SMS via the Onomondo network
- Can I send an SMS to my device?Using our API or the SMS Console on the Onomondo Platform enables you to send SMSs to any of your devices.
- How do I send SMS to my device using the API?You can use our API to send an SMS to any or all of your devices
- How do I send SMS to a device using the Onomondo Platform?You can send an SMS to individual SIMs using the SMS Console on Onomondo Platform
- Where can I see SMS sent by my device?You can capture SMS sent by the device in the SMS console and through webhooks.
- Does Onomondo support device-to-device SMS?No. SMS to the device can only be sent via the Onomondo app / API.
- What number would it be safe to use as a destination address from a device?Any number as long as it is recognized as a telephone number
- What happens if an SMS is not successfully delivered?The SMS will be re-tried up to 10 times.
- Is there a cost associated with sending and receiving SMS using Onomondo?MO SMS is charged per network-specific rates; MT SMS is free of charge.
- Does Onomondo support SMS over SGs/NAS or SMS over IP?Onomondo does not support SMS over SGs or NAS protocols.
- What is the maximum length of an SMS?160 characters for plain text, or 140 bytes for binary SMS.
- Is APN required for SMS to work?No, APN is not required for SMS functionality.
Usage
See your data consumption across SIMs
- Where can I see total data consumed per SIM in a given month?Download a monthly CSV report from the Usage page.
- How to retrieve individual SIM costs in a given month?Get the monthly CSV report from the Usage tab in the Onomondo app.
- How do I know which networks my SIMs have been using?Download a monthly usage report via the Usage tab.
- Can I download usage reports older than 3 months?No. Historic usage records are maintained for approximately 14 weeks.
- What happens when you update the data limit on the SIM?When you update the SIM’s data limit, the SIM’s usage period resets.
- Does the Dashboard display total consumed bytes or billable bytes?The "MB Usage [Month]" indicates last month's total consumed bytes across your whole fleet.
- Can I see data usage split by country?See the map in the Usage tab and download the monthly CSV report for additional insights.
- How can I check data usage or remaining data for a SIM?Check Data Limits on the individual SIM page for real-time and historical data usage.
Network Lists
Control the networks your devices can connect to
- How to use Network ListsLearn more about Network Lists, the Network Marketplace, how to view available networks and how to create new Network Lists.
- How do I create a new Network List?You can do it in the Network Lists tab.
- Can I export Network Lists from the app?No, but you can do this with the Onomondo API.
- When does Network List update take effect?The change takes effect when the device requests permission to attach to a network.
- How to update my Networks Lists?Update your Network List(s) via the Network Lists tab in our app or via our API.
Users and Access Management
Collaborate with colleagues and set access permissions
- How to set up user access control using Tags?Once you have created your Tags and attached them to the desired SIMs, you can start to use Tags for access control for Member-level users.
- What does 'write access' on a tag mean/do?Write access controls whether SIMs and Network Lists can be edited by Member-level users.
- I cannot access my authenticator app anymore. Can I reset MFA on my account?Ask the Owner of your organization account to contact Onomondo.
- Understand User Levels and How To Manage ThemOnomondo classifies users as Owner, Admin, or Member. Owners have full access; Admins and Members have limited access. Learn more below.
- Can I have a member user with read-only access?Yes. You need to make sure that the Tags allocated to the member have write acess set to false.
- I am getting an error trying to add a userA user can only add users with lower access level. An owner can create admin or member users but a admin user can only create members.
- How to set up 2FA / MFA in the Onomondo app?Go to your Account Settings and add two-step verification.
Webhooks
Connectivity insights delivered to you
- What are Onomondo webhooks?Webhooks offer real-time connectivity insights, tailored to specific events and delivered to your designated endpoint.
- How do I set up a webhook on my account?Create your first webhook and tailor it to your needs.
- How to set up a webhook to receive SMS from device and send an automated SMS response with the APIDevices sending SMS must use Onomondo’s secure platform/API. Use Webhooks to catch SMS if you're not on the platform.
- How long does Onomondo webhook wait for an answer when sending SMS?The webhook endpoint has 1 second to respond.
- Can I have two different webhooks receiving the same data?Yes. You can set up two different webhooks with the same event.
- What are Onomondo Signature Headers?Signature headers verify Webhook authenticity and integrity using HMAC-SHA256.
- Is it possible to create a webhook to trigger when a connector is added or removed from a SIM?No, this is not currently possible with Onomondo's platform.
Connectors
Increased efficiency and cost savings
- What are Onomondo Connectors?Connectors add encryption and headers before data reaches the public domain, shifting this responsibility away from the device.
- How do I setup Connectors?Setting up connectors allows you to send data to a server without logic and SDKs installed to devices.
- Defining passthrough rules for a ConnectorHow do I allow some traffic to get routed to the Internet instead of the Connector.
- How to set up an HTTPS ConnectorAn HTTPS Connector allows you to securely send data from your device to a specified HTTPS endpoint.
- How to set up an AWS IoT Core ConnectorLearn how to set up an AWS IoT Core Connector to communicate with a device via AWS IoT Core, without the device being aware of it.
- How to set up an Azure ConnectorUse an Azure Connector to send data from your device to Azure IoT Hub. Here’s a short guide on how to create it and add it to a SIM.
- How to set up an Azure DPS ConnectorAn Azure DPS Connector will help send data directly from your device to your Azure IoT Hub. Here's a simple way to set it up.
- How to set up a TLS ConnectorA TLS Connector allows you to have a secure TCP socket without having any encryption or SDK's on the device.
- How to go from MQTT to MQTTS with a TLS ConnectorWe will look into using MQTT to save on data and power, while still keeping it as secure as if it was MQTTS.
- Can I use wildmasks for passing through traffic?Yes, you can specify wildmask protocols or wildmask IPs in passthrough rules during connector setup.
- Can I have more than one endpoint set on a connector for redundancy?No. Each connector can have only one endpoint.
- Can I transfer data from Azure IoT Hub to the device?No. This Connector only supports device-to-cloud messages. Consider Azure DPS Connector instead.
- Which version of TLS is used by the Cloud Connectors?Cloud Connectors use TLS 1.3 and negotiate the highest supported cipher with the server.
OpenVPN
Connect to your devices remotely through a secure point-to-point connection
- Can I remotely connect to my devices?You are able to connect to your devices remotely using our VPN and private IP addresses.
- How do I set up my OpenVPN client on my computer?You can access your device through Onomondo by setting up an OpenVPN client.
- Where can I find the .ovpn configuration file?Click the link to download.
- What's Onomondo's IP range for OpenVPN clients?VPN IP range is 10.0.0.0/16
- Are all Onomondo SIMs ping-able throughout the entire platform among all users?Only you can ping your SIMs, as long as you have VPN access.
- When I try to enable myself for OpenVPN I get a 403 errorCurrent User Access only allows you to edit users with lower access then yourself. Have someone with higher access enable it.
- Can I get a public static IP address?For security reasons, the VPN IP address for each user is static and private.
- Is VPN traffic routed via Connectors?No, OpenVPN connections are not routed via Connector on the SIM.
- One gateway is being given the same IP as the gateway of another deviceThe only IP that is provided by Onomondo's Core is related to the IP assigned of the SIM, which is unique. Check router configuration.
- Does Onomondo's VPN server have a pre-set connection timeout?There is no server-enforced timeout. However, OpenVPN performs a soft reset and generates new encryption keys once every 60 minutes.
- I get an error when trying to remotely access my Teltonika device via HTTP/HTTPSUpdate access control settings on the router.
- My VPN connection is slow and I am experiencing severe latencySet the MTU for VPN connections to 1280 bytes.
IPSec
Set up a secure site-to-site connection
- How to set up an IPSec connectionCreating the IPSec Connector with the API and adding the Connector to SIMs.
- Can I ping public IPs with IPSec?Yes, but the NATing and routing has to happen on yours side of the IPSec connection.
- Can I debug the IPSec tunnel myself from the Onomondo app?No. Onomondo app does not offer debugging tools for IPSec yet.
- How is Dead Peer Detection (DPD) configured on Onomondo’s end?The connection is configured to restart upon dead peer detection, with a 10 second delay and a 30 second timeout.
- What are the IPSec phase 1 and phase 2 integrity algorithms supported by Onomondo?All algorithms listed in IKEv2 Cipher Suites are supported. It is up to you to decide which ones you want to use.
- Can we monitor a IPSec tunnel?We don’t provide an in-tunnel probe IP/URL. Use DPD, a private /32 you control, or probe one of your device IPs.
Audit Logs & Error Logs
Keep an overview of actions in the Onomondo app