How to integrate with KPN Things Network

How to integrate with KPN Things Network

This guide will walk you through the process of integrating a LoRaWan device with the KPN Network and TagoIO. By following the steps outlined below, you will be able to set up your device for both uplink and downlink operations, enabling seamless data exchange.


Uplink Configuration
To configure uplink communication, follow these three main steps:

1) TagoIO Setup
  1. Access Authorizations:
    1. Go to Devices.
    2. Click on Authorizations at the top of the page.
  2. Create a New Authorization:
    1. Click the Create Authorization button.
    2. Provide a meaningful name for the authorization (e.g., KPN-Integration).
    3. Click Save.
  3. Copy the Authorization Token:
    1. After creation, copy the authorization token. You will need this in later steps.
Alert
Note: you need to create only one Authorization for all your devices.

2) Setting up KPN Things
Access your KPN Things portal, log in, and follow the steps:
  1. Select the "Things Management" tab.
  2. Choose "Add new Destination."
  3. Select "HTTPS" as the destination type.
  4. Fill in the required fields:
    1. Name (Required)
    2. Description (Optional)
    3. URL: Use the endpoint format https://kpn.middleware.REGION.tago.io/uplink.
      1. Replace REGION with your deployment region (e.g., us-e1, eu-w1).
        For a list of available regions, visit TagoIO Network Integration.
    4. Shared secret (Required)
    5. Click on Advanced Configuration and insert in Headers the token you have generated on step one.
      1. { Authorization: your_authorization_token }
    6. HTTP method - POST
    7. Expected response code -  200
  5. Click on Add HTTPS endpoint

3) Add Device in TagoIO
To integrate your device with the TagoIO Platform, follow these guidelines:
  1. Ensure Device EUI Consistency:
    1. When creating the device in TagoIO, use the exact same Device EUI that is configured in WiTTRA.
    2. The Device EUI must match exactly to establish a successful connection between WiTTRA and TagoIO.
  2. Select the Appropriate Network and Device Type:
    1. Choose the WiTTRA Network during the device setup process.
    2. Select the correct device type from the available options. If your device is not listed, you can add support through connectors.
  3. Add Device Support via Connectors (If Necessary):
    1. If your device type is not available in the default list, enhance its compatibility by utilizing connectors.
    2. For more information on available connectors and how to use them, refer to the Connector Overview.
For detailed instructions on adding devices, visit the Adding Devices page.


Downlink Configuration
After you have setup the Uplink properly, you can then configure the downlinks for being capable of transmitting data from TagoIO to your devices.

For this step, you need to create API Keys at KPN Grip Portal. For that you need to be an administrator in the GRIP Portal. More information here.

1) Setting up KPN Things

  1. Access your customer account to obtain the Grip tenant ID.
    1. For detailed instructions, refer to the guidance provided in this link.
    2. Save this information as it will be needed later.
  1. Access your GRIP portal and enable API keys for downlink as follows:
    1. Click on "Identity and API Keys" on the left side.
    2. Click "+ Add."
    3. Fill in the required fields:
    4. Name (Mandatory)
    5. Description (Optional)
    6. Click "Add" to obtain your Client ID and Client Secret.
  2. Copy the have the Client ID and Client Secret
  3. Enable permission for the API key follows:
    1. Access the tab Services and roles.
    2. Click on + Add service
    3. Select the option KPN Things Portal
    4. Click "Add" and Save


2) TagoIO Setup
In the Authorization you previously added, edit the parameter to include the client id, client secret and grip tenant id, separated by a semicolon, like so:

your_client_id;your_client_secret;grip_tenant_id

3) Sending Downlinks
Now you can use TagoIO built-in functionalities to send downlinks to your devices. Read more about it at Downlink for LoRaWAN™.