Introducing our Go SDK for license activation and self-updating binaries

[ezekg]

We're excited to release our first official SDK, written in Go. The keygen package allows Go programs to offer license activation and self-updating functionality using our licensing and distribution API. The SDK features a limited interface that enforces our recommended machine activation flow, so check out the source code if you're curious! We have plans to add similar SDKs for other languages soon, so let us know what languages you think we should support next!

Activation example

import "github.com/keygen-sh/keygen-go"

func activate() error {
  keygen.Account = os.Getenv("KEYGEN_ACCOUNT")
  keygen.Product = os.Getenv("KEYGEN_PRODUCT")
  keygen.Token = os.Getenv("KEYGEN_TOKEN")

  // The current device's fingerprint (could be e.g. MAC, mobo ID, GUID, etc.)
  fingerprint := uuid.New().String()

  // Validate the license for the current fingerprint
  license, err := keygen.Validate(fingerprint)
  switch {
  case err == keygen.ErrLicenseNotActivated:
    // Activate the current fingerprint
    machine, err := license.Activate(fingerprint)
    switch {
    case err == keygen.ErrMachineLimitExceeded:
      fmt.Println("Machine limit has been exceeded!")

      return err
    case err != nil:
      fmt.Println("Machine activation failed!")

      return err
    }
  case err == keygen.ErrLicenseExpired:
    fmt.Println("License is expired!")

    return err
  case err != nil:
    fmt.Println("License is invalid!")

    return err
  }

  fmt.Println("License is activated!")
}

Auto-update example

import "github.com/keygen-sh/keygen-go"

func upgrade() error {
  keygen.Account = os.Getenv("KEYGEN_ACCOUNT")
  keygen.Product = os.Getenv("KEYGEN_PRODUCT")
  keygen.Token = os.Getenv("KEYGEN_TOKEN")

  // The current version of the program
  currentVersion := "1.0.0"

  // Check for upgrade
  release, err := keygen.Upgrade(currentVersion)
  switch {
  case err == keygen.ErrUpgradeNotAvailable:
    fmt.Println("No upgrade available, already at the latest version!")

    return nil
  case err != nil:
    fmt.Println("Upgrade check failed!")

    return err
  }

  // Download the upgrade and install it
  err = release.Install()
  if err != nil {
    return err
  }

  fmt.Println("Upgrade complete! Please restart.")
}

Up next, we'll be releasing a CLI to make publishing new releases a breeze!

Link: https://github.com/keygen-sh/keygen-go