oidclogin

README

oidclogin

OpenID Connect Login SDK written in Go for Gin.

The following environment variables are expected to be set:

OIDC_CLIENT_ID=<client id>
OIDC_CLIENT_SECRET=<client secret>
OIDC_ISSUE=<issuer url>

If these env vars are not present, then depending on configuration, stubs will be used for the endpoints or the program will crash

Usage

package main

import (
	"os"

	"github.com/gin-contrib/sessions"
	"github.com/gin-contrib/sessions/memstore"
	"github.com/gin-gonic/gin"
	"github.com/janishutz/oidclogin"
)

func main() {
	r := gin.Default()

	// TODO: Better secret
	store := memstore.NewStore([]byte("secret"))
	r.Use(sessions.Sessions("jhid", store))

	oidclogin.Configure(r, os.Getenv("APP_BASE_URL"), "/account", false)
	r.LoadHTMLGlob("public/*")

	r.GET("/account", oidclogin.EnsureLogin(false), func(ctx *gin.Context) {
		ctx.HTML(200, "main.tmpl", gin.H{})
	})

	r.Run()
}

This example further needs the environment variable APP_BASE_URL set to something like https://app.example.org. Further, you should create a template file called main.tmpl and also copy over the template files in the public directory here and edit them.

Documentation

Index

• func Configure(r *gin.Engine, app_url string, default_redirect string, user_function UserFunc, ...)
• func EnsureLogin(redirectFail bool) func(c *gin.Context)
• func ErrorHandler() gin.HandlerFunc
• type UserFunc

Functions

func Configure

func Configure(r *gin.Engine, app_url string, default_redirect string, user_function UserFunc, stubs_on_unconfigured bool)

Configure and set up the login SDK. The user_function is used to create or update a user

func EnsureLogin

func EnsureLogin(redirectFail bool) func(c *gin.Context)

Ensure that a user is currently logged in. If redirectFail is set, then if not, the user is redirected.

func ErrorHandler

func ErrorHandler() gin.HandlerFunc

Types

type UserFunc

type UserFunc func(userid string, name string, email string)