auth0

Documentation

• Godoc - explore the Go SDK documentation.
• Docs site — explore our docs site and learn more about Auth0.
• Examples - Further examples around usage of the SDK.
• API Reference - Complete API reference documentation.

Getting started

Requirements

This library follows the same support policy as Go. The last two major Go releases are actively supported and compatibility issues will be fixed. While you may find that older versions of Go may work, we will not actively test and fix compatibility issues with these versions.

• Go 1.24+

Installation

go get github.com/auth0/go-auth0/v2

Usage

Authentication API Client

This client can be used to access Auth0's Authentication API.

package main

import (
	"context"
	"log"

	"github.com/auth0/go-auth0/v2/authentication"
	"github.com/auth0/go-auth0/v2/authentication/database"
	"github.com/auth0/go-auth0/v2/authentication/oauth"
)

func main() {
	// Get these from your Auth0 Application Dashboard.
	domain := "example.us.auth0.com"
	clientID := "EXAMPLE_16L9d34h0qe4NVE6SaHxZEid"
	clientSecret := "EXAMPLE_XSQGmnt8JdXs23407hrK6XXXXXXX"

	// Initialize a new client using a domain, client ID and client secret.
	authAPI, err := authentication.New(
		context.TODO(), // Replace with a Context that better suits your usage
		domain,
		authentication.WithClientID(clientID),
		authentication.WithClientSecret(clientSecret), // Optional depending on the grants used
	)
	if err != nil {
		log.Fatalf("failed to initialize the auth0 authentication API client: %+v", err)
	}

	// Now we can interact with the Auth0 Authentication API.
	// Sign up a user
	userData := database.SignupRequest{
		Connection: "Username-Password-Authentication",
		Username:   "mytestaccount",
		Password:   "mypassword",
		Email:      "mytestaccount@example.com",
	}

	createdUser, err := authAPI.Database.Signup(context.Background(), userData)
	if err != nil {
		log.Fatalf("failed to sign user up: %+v", err)
	}

	// Login using OAuth grants
	tokenSet, err := authAPI.OAuth.LoginWithAuthCodeWithPKCE(context.Background(), oauth.LoginWithAuthCodeWithPKCERequest{
		Code:         "test-code",
		CodeVerifier: "test-code-verifier",
	}, oauth.IDTokenValidationOptions{})
	if err != nil {
		log.Fatalf("failed to retrieve tokens: %+v", err)
	}
}

Note The context package can be used to pass cancellation signals and deadlines to the Client for handling a request. If there is no context available then context.Background() can be used.

Management API Client

The Auth0 Management API is meant to be used by back-end servers or trusted parties performing administrative tasks. Generally speaking, anything that can be done through the Auth0 dashboard (and more) can also be done through this API.

Initialize your client class with a domain and token:

package main

import (
	"context"
	"log"

	"github.com/auth0/go-auth0/v2/management/option"
	management "github.com/auth0/go-auth0/v2/management/client"
)

func main() {
	mgmt, err := management.New(
		"{YOUR_TENANT_AND_REGION}.auth0.com",
		option.WithToken("{YOUR_API_V2_TOKEN}"),  // Replace with a Context that better suits your usage
	)
}

Or use client credentials:

package main

import (
	"context"
	"log"

	"github.com/auth0/go-auth0/v2/management/option"
	management "github.com/auth0/go-auth0/v2/management/client"
)

func main() {
	mgmt, err := management.New(
		"{YOUR_TENANT_AND_REGION}.auth0.com",
		option.WithClientCredentials(context.TODO(), clientID, clientSecret),  // Replace with a Context that better suits your usage
	)
}

Or use a custom token source for advanced token management (e.g., shared caching across services):

package main

import (
	"github.com/auth0/go-auth0/v2/management/option"
	management "github.com/auth0/go-auth0/v2/management/client"
	"golang.org/x/oauth2"
)

func main() {
	mgmt, err := management.New(
		"{YOUR_TENANT_AND_REGION}.auth0.com",
		option.WithTokenSource(oauth2.ReuseTokenSource(nil, myCustomTokenSource)),
	)
}

Feedback

Contributing

We appreciate feedback and contribution to this repo! Before you get started, please see the following:

• Contribution Guide
• Auth0's General Contribution Guidelines
• Auth0's Code of Conduct Guidelines

Raise an issue

To provide feedback or report a bug, please raise an issue on our issue tracker.

Vulnerability Reporting

Please do not report security vulnerabilities on the public Github issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.

Auth0 is an easy to implement, adaptable authentication and authorization platform.
To learn more checkout Why Auth0?

This project is licensed under the MIT license. See the LICENSE file for more info.