Namebase Learning Center
HomeHelp & Support
English
English
  • Introduction
  • How to
    • Use Handshake names
    • Create Handshake websites
    • Handshake DNS
    • Access Handshake names
    • Get Handshake names
    • Buy Handshake coins (HNS)
    • Transferring HNS & Names
  • Handshake
    • About Handshake
    • Name minting auction
    • HNS coin economics
  • Namebase
    • Vision and mission
    • Private naming
    • Verifying
    • Security
    • Revenue streams
  • Development
    • Developer Guides
      • Traditional website
      • Decentralized website
      • Decentralized blog
      • Decentralized login
        • Handshake-based OIDC Authentication Protocol
        • Using Handshake Login
        • Handshake Login Implementation Guide
    • Resolving Handshake
      • HNS.to
      • HNSDoH
      • Resolving Handshake locally
        • Setting up the light client
        • Setting your Operating System DNS
    • Namebase Record Assistant
Powered by GitBook
LogoLogo

Connect

  • Twitter
  • Discord
  • Github

© 2022 Namebase, Inc

On this page
  • Set up the TXT record manually
  • Set up a custom identity manager

Was this helpful?

Edit on GitHub
  1. Development
  2. Developer Guides
  3. Decentralized login

Using Handshake Login

Tutorial on how to login with your Handshake name as an end-user

PreviousHandshake-based OIDC Authentication ProtocolNextHandshake Login Implementation Guide

Last updated 2 years ago

Was this helpful?

Set up the TXT record manually

Open the identity manager:

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:

Domain
Type
Host
Value
TTL

TLD

TXT

{prefix}._auth

v=0;fingerprint=<hash>

60

Sudomain

TXT

{prefix}._auth.subdomain

v=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>
https://id.namebase.io