sso

Documentation

Overview

Package sso provides the ability to authenticate characters with the Eve Online SSO API for desktop apps. It implements OAuth 2.0 with the PKCE protocol.

Index

• Variables
• type SSOService
  • func New(clientID string, client *http.Client) *SSOService
  • func (s *SSOService) Authenticate(ctx context.Context, scopes []string) (*Token, error)
  • func (s *SSOService) RefreshToken(ctx context.Context, refreshToken string) (*Token, error)
• type Token

Variables

var (
	ErrAborted             = errors.New("auth process canceled prematurely")
	ErrTokenError          = errors.New("token error")
	ErrMissingRefreshToken = errors.New("missing refresh token")
)

Types

type SSOService

type SSOService struct {
	// Function to open the default browser. This must to be configured.
	OpenURL func(*url.URL) error
	// contains filtered or unexported fields
}

SSOService is a service for authentication Eve Online characters.

func New

func New(clientID string, client *http.Client) *SSOService

New returns a new SSO service.

Important: The OpenURL function must be configured.

func (*SSOService) Authenticate

func (s *SSOService) Authenticate(ctx context.Context, scopes []string) (*Token, error)

Authenticate an Eve Online character via OAuth 2.0 PKCE and return the new SSO token. Will open a new browser tab on the desktop and run a web server for the OAuth process.

func (*SSOService) RefreshToken

func (s *SSOService) RefreshToken(ctx context.Context, refreshToken string) (*Token, error)

Update given token with new instance from SSO API

type Token

type Token struct {
	AccessToken   string
	CharacterID   int32
	CharacterName string
	ExpiresAt     time.Time
	RefreshToken  string
	Scopes        []string
	TokenType     string
}

OAuth Token for a character in Eve Online.