Golang SDK Integration Guide

NOTE: not up-to-date. Please contact [email protected] if you'd like us to build this.
Overview
1.​Requirements​
2.​Steps​
3.​Sample​
Requirements
"encoding/json"
"io"
"net/http"
"bytes"
Steps
1.​Installation​
2.Sample Codes using "net/http" library
1.​main.go​
2.​app.go​
3.​handler.go​
3.​Contributing​
1. Installation
go get github.com/bluenumberfoundation/humanid-golang-sdk
For the latest version of the SDK:
go get -u github.com/bluenumberfoundation/humanid-golang-sdk
2. Sample Codes using "net/http" library
main.go
package main
​
import (
	app "[PATH_TO_APP.GO]"
)
​
func main() {
	app := &app.App{}
	app.Initialize()
​
	app.Run(":[PORT_NUMBER]")
}
app.go
import (
	"net/http"
	"os"
​
	_handler "[PATH_TO_YOUR_HTTP_HANDLER]"
​
	"github.com/gorilla/handlers"
	mux "github.com/gorilla/mux"
	_humanID "github.com/bluenumberfoundation/humanid-golang-sdk"
)
​
type App struct {
	Router  *mux.Router
}
​
func (app *App) Initialize() {
	app.Router = mux.NewRouter()
​
	humanID := _humanID.New(
    os.Getenv("SERVER_ID"),
    os.Getenv("SERVER_SECRET"),
  )
​
	_handler.NewHandler(app.Router, humanID)
}
​
​
func (app *App) Run(addr string) {
	headers := handlers.AllowedHeaders([]string{"X-Requested-With", "Content-Type", "Authorization"})
	methods := handlers.AllowedHeaders([]string{"GET", "POST", "PUT", "DELETE"})
	origins := handlers.AllowedOrigins([]string{"*"})
}
handler.go
package http
​
import (
	"encoding/json"
	"net/http"
	"fmt"
​
	"github.com/gorilla/mux"
	_humanID "github.com/bluenumberfoundation/humanid-golang-sdk"
)
​
type HTTPHandler struct {
	humanID _humanID.HumanID
}
​
func RespondJSON(w http.ResponseWriter, status int, payload interface{}) {
	response, err := json.Marshal(payload)
	if err != nil {
		w.WriteHeader(http.StatusInternalServerError)
		w.Write([]byte(err.Error()))
		return
	}
	w.Header().Set("Content-Type", "application/json")
	w.WriteHeader(status)
	w.Write([]byte(response))
}
​
func (handler HTTPHandler) Authenticate(w http.ResponseWriter, r *http.Request) {
	tokenArr, ok := r.URL.Query()["et"]
	if !ok {
		code, ok := r.URL.Query()["code"]
		if !ok {
			redirectSuccessURL := "[YOUR_FAIL_REDIRECT_URL]"
			http.Redirect(w, r, redirectSuccessURL, 301)
			return
		}
	}
	token := tokenArr[0]
​
	verifyTokenResp, err := handler.humanID.VerifyToken(token)
	if err != nil {
		fmt.Println(err.Error())
		return
	}
​
	if verifyTokenResp.Code == "OK" {
		redirectSuccessURL := "[YOUR_SUCCCESS_REDIRECT_URL]"
		http.Redirect(w, r, redirectSuccessURL, 301)
		return
	} else {
		redirectSuccessURL := "[YOUR_FAIL_REDIRECT_URL]"
		http.Redirect(w, r, redirectSuccessURL, 301)
		return
	}
}
​
func (handler HTTPHandler) RequestLoginURL(w http.ResponseWriter, r *http.Request) {
	loginResp, err := handler.humanID.Login("ID", "")
	if err != nil {
		payload := AuthenticateResponse{
			Success: false,
			Code: "500",
			Message: "Internal Server Error",
		}
		RespondJSON(w, http.StatusInternalServerError, payload)
		return
	}
	if loginResp.Code == "OK" {
		loginURL := loginResp.Data.WebLoginUrl
		http.Redirect(w, r, loginURL, 301)
		return
	}
	payload := AuthenticateResponse{
		Success: false,
		Code: "500",
		Message: "Internal Server Error",
	}
	RespondJSON(w, http.StatusInternalServerError, payload)
	return
}
​
​
func NewHandler(publicRouter *mux.Router, humanID _humanID.HumanID) {
	handler := &HTTPHandler{
		humanID: humanID,
	}
​
	publicRouter.HandleFunc("/authenticate", handler.Authenticate).Methods("GET")
	publicRouter.HandleFunc("/request", handler.RequestLoginURL).Methods("GET")
}
Environment Variables
These variables can be found in the Human ID Developer Console
SERVER_ID=[REPLACE_ME]
SERVER_SECRET=[REPLACE_ME]
CLIENT_ID=[REPLACE_ME]
CLIENT_SECRET=[REPLACE_ME]
3. Contributing
Run Tests
Pre-requisites (only for testing):
docker
docker-compose
Run tests:
docker-compose up
Sample
See our Github for a full sample to learn more!

Example Web SDK Integration

React Native SDK Integration Guide

Last modified 1mo ago