Go

Authenticate requests and manage Passage users with Go.

Prerequisites

Passage App ID and API Key from Passage Console

Install

Install the passage-go package.

go get github.com/passageidentity/passage-go/v2

Initialize

import (
  "os"
 
  "github.com/passageidentity/passage-go/v2"
)
 
psg, err := passage.New(os.Getenv("PASSAGE_APP_ID"), os.Getenv("PASSAGE_API_KEY"))

Authenticating requests

The Passkey Complete Go SDK provides a way to validate JWT-authenticated requests. To learn more, see our full guide on JWTs.

func protectedRouteHandler(w http.ResponseWriter, r *http.Request) {
  // Get Passage JWT from the request's Authorization header
  authHeader := r.Header.Get("Authorization")
  token := strings.TrimPrefix(authHeader, "Bearer ")
 
  // Validate JWT using Passage
  var userID string
  var err error
  userID, err = psg.Auth.ValidateJWT(token)
  if err != nil {
    // Token is invalid
  }
 
  // Token is valid
  var user *passage.PassageUser
  user, err = psg.User.Get(userID)
 
  fmt.Printf("%+v", user)
}

User management

In addition to authenticating requests, the Passkey Complete Go SDK also provides a way to securely manage users. These functions require authentication using a Passage API key. API keys can be managed in the Passage Console.

The functionality currently available on a user is:

• Get a user’s information (including any defined user metadata fields)
• Activate or deactivate a user (a deactivated user will not be able to log in)
• Update a user’s information (email address or phone number)
• Revoke a user’s refresh tokens
• Delete a user
• Create a user

// userID is the Passage user ID
var user *passage.PassageUser
var err error
user, err = psg.User.Get(userID)
 
fmt.Printf("%+v", user)

User device management

The functionality currently available for a webauthn device is:

• List all devices for a user
• Revoke a particular device from a user

var webAuthnDevices *[]passage.WebAuthnDevices
var err error
webAuthnDevices, err = psg.User.ListDevices(userID)
 
for _, device := range webAuthnDevices {
  fmt.Printf("%+v", device)
}

Creating Magic Links

The Passkey Complete Go SDK can be used to generate custom Magic Links for users, that can be embedded into any content medium. To learn more, see our full guide on Embedded Magic Links.

var magicLink *passage.MagicLink
var err error
 
magicLink, err = psg.Auth.CreateMagicLinkWithEmail(
  "test.email@mail.com",
  passage.LoginType,
  true,
)
 
// or include some configuration options
options := passage.MagicLinkOptions{
  Language: passage.Es,
  MagicLinkPath: "/some/path",
  RedirectURL: "/redirect/to/dashboard/path",
  TTL: 20, // minutes
}
magicLink, err = psg.Auth.CreateMagicLinkWithEmail(
  "test.email@mail.com",
  passage.LoginType,
  true,
  options,
)
 
println(magicLink.URL)

Go reference

For complete documentation on passage-go functions and types, check out the Go documentation.