Demo
See an example of Nuggets authentication integrated with Google’s A2A protocol
demo.
Getting Started
1
Create an AI Agent
Go to the Nuggets Account Portal and navigate to the AI Agents page to create your first agent.

AI Agent - Menu Item
2
Download Private Key and Save Client ID
Once created, you will be prompted to download the private key for this client. It is important you save this file.
This key is only available once and is needed to successfully authenticate your AI Agent.

AI Agent - Private Key Download
3
(Optional) Add Verified Information
Within Nuggets, you can build greater trust by adding verified information—such as a validated social media account for either the AI Agent or its creator.


AI Agent - Menu Item

Advanced Check - Invite Verifications
Authenticating The Agent
Now you have created the Agent inside the Accounts Portal, we can use the created details to authenticate the agent.1. Install the authentication package.
To get started, firstly install the authentication package on theagent
and server
.agent
environment:2. Expose an authentication endpoint on the Agent.
Expose an endpoint on your agent which allows for the JWT token to be generated (viacreateAuthenticationToken
). Under the hood, this uses your downloaded private key and assigns the DID to the payload.Create the authentication token on the agent (express example).
3. Verify the token
Once the requestingserver
receives the token, you are then able to verify it using the verifyToken
function. If successful, this will return the DID Document for the client. If unsuccessful, the agent is potentially a bad actor.You can get the details from your clients DID Document by extracting the
client ID from your DID and navigating to` `
https://auth.nuggets.life/{CLIENT_ID}/.well-known/did.json
Authenticate the agents token.
Verify token response
The DID Document resolved from the DID in the token.
4. Additional Information
Once a successful connection is made, you’re then able to retrieve more information about theagent
via the verifiedDetails
call. This calls the service
s that are returned as part of the client’s DID Document.You can get the verified information about your client by extracting the
client ID from your DID and navigating to` `
https://auth.nuggets.life/verified-info/{CLIENT_ID}/json
Get Verified Information