Device Registration - ONES Now Documentation

This guide provides detailed instructions for registering a new server with OnesID, enabling secure device authentication and registration. It covers the process of installing the `px-device-identity` package, registering the server, and verifying the registration.

Table of content

1.0 Register

To register a new server, you need to have px-device-identity. To install it:

make sure you have at least Python 3.10
are logged in as root

pip3 install https://source.pantherx.org/px-device-identity_latest.tgz

# on some systems, you need to add a flag --break-system-packages, or install in a venv
# pip3 install https://source.pantherx.org/px-device-identity_latest.tgz --break-system-packages

After everything is installed, register the server.

Adjust “ServerName” easy to recognize
Adjust “Bangkok” to the server location; for ex. City

px-device-identity -o INIT -a https://idp-server.ones-now.com -dn onesid1.com -t "ServerName" -l "Bangkok" -r SERVER

Someone from the OnesID team will need to approve this request this request within 300s.

Schedule a time

2.0 Update

To update px-device-identity to the latest version, run:

pip3 install https://source.pantherx.org/px-device-identity_latest.tgz

3.0 Run Identity Service

Depending on your use case, you might need to run the device identity service. Find out more about it here.