connector

Documentation

Overview

Package connector defines interfaces for federated identity strategies.

Index

• type CallbackConnector
• type Connector
• type GroupsConnector
• type Identity
• type PasswordConnector

Types

type CallbackConnector

type CallbackConnector interface {
	LoginURL(callbackURL, state string) (string, error)
	HandleCallback(r *http.Request) (identity Identity, err error)
}

CallbackConnector is an optional interface for callback based connectors.

type Connector

type Connector interface {
	Close() error
}

Connector is a mechanism for federating login to a remote identity service.

Implementations are expected to implement either the PasswordConnector or CallbackConnector interface.

type GroupsConnector

type GroupsConnector interface {
	Groups(identity Identity) ([]string, error)
}

GroupsConnector is an optional interface for connectors which can map a user to groups.

type Identity

type Identity struct {
	UserID        string
	Username      string
	Email         string
	EmailVerified bool

	// ConnectorData holds data used by the connector for subsequent requests after initial
	// authentication, such as access tokens for upstream provides.
	//
	// This data is never shared with end users, OAuth clients, or through the API.
	ConnectorData []byte
}

Identity represents the ID Token claims supported by the server.

type PasswordConnector

type PasswordConnector interface {
	Login(username, password string) (identity Identity, validPassword bool, err error)
}

PasswordConnector is an optional interface for password based connectors.