Client identities

A client identity tells Dinio how to recognise one of your clients, so that sinkhole lists can be applied to it. Part of DNS filtering; needs a personal key.

dinio client create 203.0.113.10 --name office
dinio client create --type path --name phone
dinio client list
dinio client show phone
dinio client delete phone

CLIENT is the client’s name, its identifying value (203.0.113.10, k3x7q2mzr5tvb4wa) or its uuid. Names are matched ignoring case; when one is ambiguous, use the value or the uuid.

Command
client list	Your client identities.
client show CLIENT	One identity, with the sinkhole lists linked to it.
client create [IDENTIFY] [--type ip|hostname|path] [--name NAME]	Register a client.
client update CLIENT [options]	Change it; see below.
client new-identify CLIENT	Replace the generated value of a hostname or path client. Asks for confirmation.
client delete CLIENT	Delete it. Asks for confirmation.

Types

--type	The client is recognised by	IDENTIFY
ip	its source IP address — plain DNS over UDP/TCP	The IP address; you give it.
hostname	the hostname it connects to — DNS over TLS	Generated by Dinio.
path	part of the request path — DNS over HTTPS	Generated by Dinio.

For an IP address you can leave --type out. For DoT and DoH leave IDENTIFY out: Dinio generates it, and client create prints it — that is the hostname label or path part to configure on the device.

client new-identify replaces that value, for example when a device is lost. The old value stops working at once, so reconfigure the client’s other devices.

client update

Option
--name NAME / --clear-name	Set or remove the label.
--disable / --enable	Stop recognising the client — its lists stop applying — or start again.
--identify ADDRESS	A new IP address, for ip clients.
--type ip|hostname|path	A new type. Changing to hostname or path generates a new value.

A client with linked lists can’t be deleted. client show lists them, and dinio sinkhole link rm CLIENT LIST removes a link.