Admission #
A tenant starts with a name, and the operator admitting it. That is the only thing the operator does for you; everything after it you do yourself.
Pick a name #
- 1 to 8 characters, lowercase letters and digits, starting with a letter β
^[a-z][a-z0-9]{0,7}$ - It becomes your DNS zone (
<name>.mobile.deevnet.net), your MQTT topic prefix (<name>/β¦) and the name of your network. Pick something you will not mind seeing everywhere sensors,bench1,ptvare fine;Pico-Demoandmeetupprojectare not
Ask the operator #
Tell the operator the name. They run one API call ( Tenant Admission) and hand you three things:
- an enrollment token (it looks like
s.β¦) - the API endpoint,
https://api.mobile.deevnet.net:8080 - the site CA,
site-ca.pem
What the token is #
| Single use | your first terraform apply spends it, and hands you your own long-lived token in exchange |
| Bound to your name | presenting it for any other name spends it and fails with 401 β a typo costs a new admission |
| Expires | after 72 hours. Admit close to when you will apply |
Treat it like a password until it is spent. Once it is spent it is worthless, and from then on your credential is the tenant token in your Terraform state.
If the operator gets 409, the name is already taken β by someone else, or by you last time. A
tenant that already exists does not need admitting again; it needs its own token.