Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ( // ContextOAuth2 takes a oauth2.TokenSource as authentication for the request. ContextOAuth2 = contextKey("token") // ContextBasicAuth takes BasicAuth as authentication for the request. ContextBasicAuth = contextKey("basic") // ContextAccessToken takes a string oauth2 access token as authentication for the request. ContextAccessToken = contextKey("accesstoken") // ContextAPIKey takes an APIKey as authentication for the request ContextAPIKey = contextKey("apikey") )
Functions ¶
Types ¶
type APIClient ¶
type APIClient struct {
AuthApi *AuthApiService
// contains filtered or unexported fields
}
APIClient manages communication with the authproxy OpenAPI API v1.0 In most cases there should be only one, shared, APIClient.
func NewAPIClient ¶
func NewAPIClient(cfg *Configuration) *APIClient
NewAPIClient creates a new API client. Requires a userAgent string describing your application. optionally a custom http.Client to allow for advanced features such as caching.
func (*APIClient) ChangeBasePath ¶
Change base path to allow switching to mocks
type APIKey ¶
APIKey provides API key based authentication to a request passed via context using ContextAPIKey
type APIResponse ¶
type APIResponse struct {
*http.Response `json:"-"`
Message string `json:"message,omitempty"`
// Operation is the name of the swagger operation.
Operation string `json:"operation,omitempty"`
// RequestURL is the request URL. This value is always available, even if the
// embedded *http.Response is nil.
RequestURL string `json:"url,omitempty"`
// Method is the HTTP method used for the request. This value is always
// available, even if the embedded *http.Response is nil.
Method string `json:"method,omitempty"`
// Payload holds the contents of the response body (which may be nil or empty).
// This is provided here as the raw response.Body() reader will have already
// been drained.
Payload []byte `json:"-"`
}
func NewAPIResponse ¶
func NewAPIResponse(r *http.Response) *APIResponse
func NewAPIResponseWithError ¶
func NewAPIResponseWithError(errorMessage string) *APIResponse
type AuthApiService ¶
type AuthApiService service
func (*AuthApiService) Authenticate ¶
func (a *AuthApiService) Authenticate(ctx context.Context, body TokenReviewRequest) (TokenReviewRequest, *http.Response, error)
AuthApiService verifies user credentials authenticates users
- @param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
- @param body TokenReviewRequest object that needs to be verified
@return TokenReviewRequest
func (*AuthApiService) Login ¶
func (a *AuthApiService) Login(ctx context.Context) (TokenReviewRequest, *http.Response, error)
AuthApiService issues tokens for cluster access login users
- @param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return TokenReviewRequest
type BasicAuth ¶
type BasicAuth struct {
UserName string `json:"userName,omitempty"`
Password string `json:"password,omitempty"`
}
BasicAuth provides basic http authentication to a request passed via context using ContextBasicAuth
type Configuration ¶
type Configuration struct {
BasePath string `json:"basePath,omitempty"`
Host string `json:"host,omitempty"`
Scheme string `json:"scheme,omitempty"`
DefaultHeader map[string]string `json:"defaultHeader,omitempty"`
UserAgent string `json:"userAgent,omitempty"`
HTTPClient *http.Client
}
func NewConfiguration ¶
func NewConfiguration() *Configuration
func (*Configuration) AddDefaultHeader ¶
func (c *Configuration) AddDefaultHeader(key string, value string)
type GenericSwaggerError ¶
type GenericSwaggerError struct {
// contains filtered or unexported fields
}
GenericSwaggerError Provides access to the body, error and model on returned errors.
func (GenericSwaggerError) Body ¶
func (e GenericSwaggerError) Body() []byte
Body returns the raw bytes of the response
func (GenericSwaggerError) Error ¶
func (e GenericSwaggerError) Error() string
Error returns non-empty string if there was an error.
func (GenericSwaggerError) Model ¶
func (e GenericSwaggerError) Model() interface{}
Model returns the unpacked model of the error
type Principal ¶
type Principal struct {
// The name that uniquely identifies this user among all active users
Username string `json:"Username,omitempty"`
// The pasword of the user
Password string `json:"Password,omitempty"`
}
Principal contains information about the user
type TokenReviewRequest ¶
type TokenReviewRequest struct {
Kind string `json:"kind,omitempty"`
ApiVersion string `json:"apiVersion,omitempty"`
Spec *TokenReviewSpec `json:"spec,omitempty"`
Status *TokenReviewStatus `json:"status,omitempty"`
}
TokenReviewRequest is issued by K8s to this service
type TokenReviewSpec ¶
type TokenReviewSpec struct {
Token string `json:"token,omitempty"`
}
TokenReviewSpec contains the token being reviewed
type TokenReviewStatus ¶
type TokenReviewStatus struct {
// Authenticated is true if the token is valid
Authenticated bool `json:"authenticated,omitempty"`
User *UserInfo `json:"user,omitempty"`
}
TokenReviewStatus is the result of the token authentication request
type UserInfo ¶
type UserInfo struct {
// The name that uniquely identifies this user among all active users
Username string `json:"username,omitempty"`
// A unique value that identifies this user across time. If this user is deleted and another user by the same name is added, they will have different UIDs
Uid string `json:"uid,omitempty"`
// The names of groups this user is a part of
Groups []string `json:"groups,omitempty"`
// Any additional information provided by the authenticator
Extra *interface{} `json:"extra,omitempty"`
}
UserInfo contains information about the user