Command-line interface only
The instructions below use the command-line interface (CLI).
This guide explains the process of making a gateway claimable. When a gateway is claimable, someone else can claim it securely.
Prerequisites
- An gateway registered in a The Things Stack Cloud or The Things Stack Enterprise cluster See instructions.
Authorize Claiming
In order for anyone to claim a gateway that is owned by you, you need to authorize claiming. This is needed for The Things Stack to move the gateway to the other user. This needs to be done separately for each gateway.
Replace <gateway-id>
with the Gateway ID of the gateway that you created in prerequisites, and run the following command in the CLI:
ttn-lw-cli gateways claim authorize <gateway-id>
To undo the action:
ttn-lw-cli gateways claim unauthorize <gateway-id>
Claiming Settings
When a gateway is added in The Things Stack, its claiming settings can be configured.
This is comprised of a claim authentication code and a validity window. The claim authentication code is a secret value. The validity window is an optional start and end date on which the claim authentication code can be used.
The claim authentication code value should be in hex while updating the gateway. Refer to the following example.
CAC=ABCD
CAC_IN_HEX=$(echo -n "$CAC" | xxd -ps -u -c 8192)
ttn-lw-cli gateways update <gateway-id> --claim-authentication-code.secret.value $CAC_IN_HEX \
--claim-authentication-code.valid-from 2021-03-01T00:00:00Z \
--claim-authentication-code.valid-to 2021-03-31T23:59:59Z
This sets the secret claim authentication code secret value to ABCD
, that can be used in March 2021. Please adapt these values for your specific case.