Join the SkyInclude & OwnTheDot LearnHNS Competition! Learn more & Submit

Archive Notice: This documentation was originally published by Namebase and has been preserved by the LearnHNS community.

Edit this page on GitHub

Using Handshake Login

Set up the TXT record manually

Open the identity manager: https://id.namebase.io

Create a new identity by entering a name you own. Click on “Copy my record”.

This will copy the key fingerprint in your clipboard.

Set a new TXT record on subdomain domain {prefix}_auth with a short TTL:

v=0;fingerprint=<hash>

The prefix is generated with a hash function SHA-256 of the concatenated targeted name and the randomly generated deviceId:

const prefix = hash(name + deviceId, 'SHA-256');

TLD or subdomain records will look like this:

DomainTypeHostValueTTL
TLDTXT{prefix}._authv=0;fingerprint=<hash>60
SudomainTXT{prefix}._auth.subdomainv=0;fingerprint=<hash>60

Set up a custom identity manager

You have the possibility to configure your own application to carry your identity. In order to configure your name to point to your custom identity manager, you will need to add a TXT record on the subdomain _idmanager of your name.

_idmanager.<handshake>

v=0;url=<https://your application>