LNS Registration

Register each Fence Shield on your LoRaWAN Network Server (LNS), then connect it to the Safora platform so devices appear on the dashboard.

This guide assumes you already have a working LoRaWAN network (gateway + LNS). If you are using a Safora-provided gateway, device registration on ChirpStack is handled for you. Use this page only when connecting to your own LNS.

Before you start

Item	Where to find it
Device EUI, Join EUI, Application Key	Paper included with your shipment, and the shipment email
Safora integration token (HTTP_TOKEN)	Paper included with your shipment, and the shipment email

If you are adding your first device, create an application on your LNS, then add each device with its EUIs. Some LNS platforms also require a Safora Fence Shield device profile before adding devices. We've included step-by-step instructions for the most popular LNS options below.

Use this naming pattern for every device:

Field	Value
Device name	FS-{device number} (example: FS-0001)
Activation	OTAA
LoRaWAN version	1.0.3

1. Register devices on your LNS

ChirpStack v4

Create the device profile

1. Select the correct Tenant (top-left).
2. Go to Tenant → Device Profiles and click Add device profile.
3. Enter:

Field	Value
Name	Safora Fence Shield
Region	EU868
MAC version	LoRaWAN 1.0.3
Regional parameters version	A
ADR algorithm	Default ADR Algorithm (LoRa only)

4. Leave remaining fields at default and click Submit.

Create the application

1. Go to Tenant → Applications and click Add application.
2. Choose a name and click Submit.

Add each device

1. In the same application, click Add device.
2. Enter:

Field	Value
Name	FS-{device number} (example: FS-0001)
Device EUI	From shipment paperwork or shipment email
Join EUI	From shipment paperwork or shipment email
Device profile	Tenant → Safora Fence Shield

3. On the next screen, add the Application Key and click Submit.
4. If you see “Please enter a valid Application key”, ignore it and click Submit again.

Verify connection

After powering on the device, check Events:

• A join message should appear first.
• An up message should follow about 20 seconds later.

TTN v3

Register the end device

Follow the TTN v3 device setup guide, selecting Register end device → Manually with these values:

Field	Value
Activation mode	OTAA
LoRaWAN version	1.0.3
End device ID	FS-{device number} (example: FS-0001)
DevEUI, AppEUI, AppKey	From shipment paperwork or shipment email
Frequency plan	Europe 863-870 MHz (SF9 for RX2, recommended)

Verify connection

After powering on the device, open the application Live Data tab:

• A Join message should appear first.
• An uplink message should follow about 20 seconds later.

Actility ThingPark

Set up routing (required first)

Before adding devices, create a data destination: Connections → Create and configure routing for device data.

Add each device

Follow the Actility ThingPark integration guide, then go to Devices → Create and enter:

Field	Value
Manufacturer	Generic
Model	LoRaWAN 1.0.3
Name	FS-{device number} (example: FS-0001)
Device EUI, Join EUI (App EUI), AppKey	From shipment paperwork or shipment email
Activation mode	OTAA
Connections	The connection created in the routing step

Verify connection

After powering on the device, open the device status page:

• Status should change to Active.
• A first data uplink should appear about 20 seconds later.

2. Connect to the Safora platform

Configure your LNS so Fence Shield uplinks reach the Safora platform. Your LNS sends them securely to:

https://api.safora-tech.com/api/uplink

Every integration needs an Authorization header. The token (HTTP_TOKEN) is included on paper with your shipment and in the shipment email.

⚠ Security: Treat your integration token like a password. Do not share it publicly or commit it to version control.

Example header value:

Bearer 7f8a2b3c4d5e6f7a8b9c0d1e2f3a4b5c

ChirpStack v4

1. Select the correct Tenant.
2. Go to Tenant → Applications and open your Fence Shield application.
3. Open the Integrations tab and click + under HTTP.
4. Enter:

Field	Value
Payload encoding	JSON
Event endpoint URL(s)	https://api.safora-tech.com/api/uplink

5. Click Add header:

Key	Value
Authorization	Bearer {HTTP_TOKEN}

6. Save the integration.

TTN v3

1. Go to Applications and select your Fence Shield application.
2. Open Integrations → Webhooks and click + Add webhook.
3. Select the Custom webhook template.
4. Enter:

Field	Value
Webhook ID	safora-integration (or any name you prefer)
Webhook format	JSON
Base URL	https://api.safora-tech.com/api/uplink

5. Under Headers, add:

Key	Value
Authorization	Bearer {HTTP_TOKEN}

6. Under Enabled messages, enable Uplink message (path can stay blank).
7. Click Add webhook to save.

Actility ThingPark

1. Go to Connections → Create.
2. Select HTTPS as the connection type.
3. Enter:

Field	Value
Name	Safora Integration (or any name you prefer)
URL	https://api.safora-tech.com/api/uplink

4. Under Custom HTTP Headers, add:

Name	Value
Authorization	Bearer {HTTP_TOKEN}

5. Click Create.

Important: assign each Fence Shield device to this connection. Go to Devices, select your device(s), and set Connections to the Safora Integration you just created.

Need payload decoding or remote parameter control? See LoRaWAN Parameters.