mystiq/dex
Archived
4
0
Fork 1
Code Issues Pull requests Projects Releases Packages Wiki Activity

connector: document Connector and ConnectorConfig interfaces

Browse source 
closes #203
This commit is contained in:
Eric Chiang 2015-12-09 15:19:39 -08:00
parent cec3cd4451
commit a5feafc80d
1 changed files with 25 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
connector/interface.go
View file

@ -14,8 +14,18 @@ import (
var ErrorNotFound = errors.New("connector not found in repository") var ErrorNotFound = errors.New("connector not found in repository")
type Connector interface { type Connector interface {
// ID returns the ID of the ConnectorConfig used to create the Connector.
ID() string ID() string
// LoginURL returns the backend's authorization URL for a sessionKey
// and OAuth2 prompt type.
LoginURL(sessionKey, prompt string) (string, error) LoginURL(sessionKey, prompt string) (string, error)
// Register allows connectors to register a callback handler with the
// dex server.
//
// Connectors should register with a path that extends the namespace
// URL provided when the Connector is instantiated.
Register(mux *http.ServeMux, errorURL url.URL) Register(mux *http.ServeMux, errorURL url.URL)
// Sync triggers any long-running tasks needed to maintain the // Sync triggers any long-running tasks needed to maintain the
@ -23,7 +33,8 @@ type Connector interface {
// repeatedly caching any remote resources for local use. // repeatedly caching any remote resources for local use.
Sync() chan struct{} Sync() chan struct{}
// TrustedEmailProvider indicates whether or not we can trust that email claims coming from this provider. // TrustedEmailProvider indicates whether or not we can trust that email
// claims coming from this provider.
TrustedEmailProvider() bool TrustedEmailProvider() bool
health.Checkable health.Checkable
@ -31,8 +42,21 @@ type Connector interface {
//go:generate genconfig -o config.go connector Connector //go:generate genconfig -o config.go connector Connector
type ConnectorConfig interface { type ConnectorConfig interface {
// ConnectorID returns a unique end user facing identifier. For example "google".
ConnectorID() string ConnectorID() string
// ConnectorType returns an implementation specific identifier. For example "oidc".
ConnectorType() string ConnectorType() string
// Connector is invoked by the dex server and returns a Connector configured
// to use the provided arguments. URL namespace is used to register callbacks.
// loginFunc is used to associate remote identies with dex session keys.
//
// The returned Connector must call loginFunc once upon successful
// identification of a user.
//
// Additional templates are passed for connectors that require rendering HTML
// pages, such as the "local" connector.
Connector(ns url.URL, loginFunc oidc.LoginFunc, tpls *template.Template) (Connector, error) Connector(ns url.URL, loginFunc oidc.LoginFunc, tpls *template.Template) (Connector, error)
} }