samlprepareauthentication

Documentation

Overview

Prepare SAML authentication.

Creates a SAML authentication request (`<AuthnRequest>`) as a URL string, based on the configuration of the respective SAML realm in Elasticsearch.

Index

• Variables
• type NewSamlPrepareAuthentication
  • func NewSamlPrepareAuthenticationFunc(tp elastictransport.Interface) NewSamlPrepareAuthentication
• type Request
  • func NewRequest() *Request
  • func (r *Request) FromJSON(data string) (*Request, error)
• type Response
  • func NewResponse() *Response
• type SamlPrepareAuthentication
  • func New(tp elastictransport.Interface) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) Acs(acs string) *SamlPrepareAuthentication
  • func (r SamlPrepareAuthentication) Do(providedCtx context.Context) (*Response, error)
  • func (r *SamlPrepareAuthentication) ErrorTrace(errortrace bool) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) FilterPath(filterpaths ...string) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) Header(key, value string) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) HttpRequest(ctx context.Context) (*http.Request, error)
  • func (r *SamlPrepareAuthentication) Human(human bool) *SamlPrepareAuthentication
  • func (r SamlPrepareAuthentication) Perform(providedCtx context.Context) (*http.Response, error)
  • func (r *SamlPrepareAuthentication) Pretty(pretty bool) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) Raw(raw io.Reader) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) Realm(realm string) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) RelayState(relaystate string) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) Request(req *Request) *SamlPrepareAuthentication

Variables

var ErrBuildPath = errors.New("cannot build path, check for missing path parameters")

ErrBuildPath is returned in case of missing parameters within the build of the request.

Types

type NewSamlPrepareAuthentication

type NewSamlPrepareAuthentication func() *SamlPrepareAuthentication

NewSamlPrepareAuthentication type alias for index.

func NewSamlPrepareAuthenticationFunc

func NewSamlPrepareAuthenticationFunc(tp elastictransport.Interface) NewSamlPrepareAuthentication

NewSamlPrepareAuthenticationFunc returns a new instance of SamlPrepareAuthentication with the provided transport. Used in the index of the library this allows to retrieve every apis in once place.

type Request

type Request struct {

	// Acs The Assertion Consumer Service URL that matches the one of the SAML realms in
	// Elasticsearch.
	// The realm is used to generate the authentication request. You must specify
	// either this parameter or the realm parameter.
	Acs *string `json:"acs,omitempty"`
	// Realm The name of the SAML realm in Elasticsearch for which the configuration is
	// used to generate the authentication request.
	// You must specify either this parameter or the acs parameter.
	Realm *string `json:"realm,omitempty"`
	// RelayState A string that will be included in the redirect URL that this API returns as
	// the RelayState query parameter.
	// If the Authentication Request is signed, this value is used as part of the
	// signature computation.
	RelayState *string `json:"relay_state,omitempty"`
}

Request holds the request body struct for the package samlprepareauthentication

https://github.com/elastic/elasticsearch-specification/blob/4fcf747dfafc951e1dcf3077327e3dcee9107db3/specification/security/saml_prepare_authentication/Request.ts#L22-L48

func NewRequest

func NewRequest() *Request

NewRequest returns a Request

func (*Request) FromJSON

func (r *Request) FromJSON(data string) (*Request, error)

FromJSON allows to load an arbitrary json into the request structure

type Response

type Response struct {
	Id       string `json:"id"`
	Realm    string `json:"realm"`
	Redirect string `json:"redirect"`
}

Response holds the response body struct for the package samlprepareauthentication

https://github.com/elastic/elasticsearch-specification/blob/4fcf747dfafc951e1dcf3077327e3dcee9107db3/specification/security/saml_prepare_authentication/Response.ts#L22-L28

func NewResponse

func NewResponse() *Response

NewResponse returns a Response

type SamlPrepareAuthentication

type SamlPrepareAuthentication struct {
	// contains filtered or unexported fields
}

func New

func New(tp elastictransport.Interface) *SamlPrepareAuthentication

Prepare SAML authentication.

Creates a SAML authentication request (`<AuthnRequest>`) as a URL string, based on the configuration of the respective SAML realm in Elasticsearch.

https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-saml-prepare-authentication.html

func (*SamlPrepareAuthentication) Acs

func (r *SamlPrepareAuthentication) Acs(acs string) *SamlPrepareAuthentication

Acs The Assertion Consumer Service URL that matches the one of the SAML realms in Elasticsearch. The realm is used to generate the authentication request. You must specify either this parameter or the realm parameter. API name: acs

func (SamlPrepareAuthentication) Do

func (r SamlPrepareAuthentication) Do(providedCtx context.Context) (*Response, error)

Do runs the request through the transport, handle the response and returns a samlprepareauthentication.Response

func (*SamlPrepareAuthentication) ErrorTrace

func (r *SamlPrepareAuthentication) ErrorTrace(errortrace bool) *SamlPrepareAuthentication

ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errors when they occur. API name: error_trace

func (*SamlPrepareAuthentication) FilterPath

func (r *SamlPrepareAuthentication) FilterPath(filterpaths ...string) *SamlPrepareAuthentication

FilterPath Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch. API name: filter_path

func (*SamlPrepareAuthentication) Header

func (r *SamlPrepareAuthentication) Header(key, value string) *SamlPrepareAuthentication

Header set a key, value pair in the SamlPrepareAuthentication headers map.

func (*SamlPrepareAuthentication) HttpRequest

func (r *SamlPrepareAuthentication) HttpRequest(ctx context.Context) (*http.Request, error)

HttpRequest returns the http.Request object built from the given parameters.

func (*SamlPrepareAuthentication) Human

func (r *SamlPrepareAuthentication) Human(human bool) *SamlPrepareAuthentication

Human When set to `true` will return statistics in a format suitable for humans. For example `"exists_time": "1h"` for humans and `"eixsts_time_in_millis": 3600000` for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines. API name: human

func (SamlPrepareAuthentication) Perform

func (r SamlPrepareAuthentication) Perform(providedCtx context.Context) (*http.Response, error)

Perform runs the http.Request through the provided transport and returns an http.Response.

func (*SamlPrepareAuthentication) Pretty

func (r *SamlPrepareAuthentication) Pretty(pretty bool) *SamlPrepareAuthentication

Pretty If set to `true` the returned JSON will be "pretty-formatted". Only use this option for debugging only. API name: pretty

func (*SamlPrepareAuthentication) Raw

func (r *SamlPrepareAuthentication) Raw(raw io.Reader) *SamlPrepareAuthentication

Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.

func (*SamlPrepareAuthentication) Realm

func (r *SamlPrepareAuthentication) Realm(realm string) *SamlPrepareAuthentication

Realm The name of the SAML realm in Elasticsearch for which the configuration is used to generate the authentication request. You must specify either this parameter or the acs parameter. API name: realm

func (*SamlPrepareAuthentication) RelayState

func (r *SamlPrepareAuthentication) RelayState(relaystate string) *SamlPrepareAuthentication

RelayState A string that will be included in the redirect URL that this API returns as the RelayState query parameter. If the Authentication Request is signed, this value is used as part of the signature computation. API name: relay_state

func (*SamlPrepareAuthentication) Request

func (r *SamlPrepareAuthentication) Request(req *Request) *SamlPrepareAuthentication

Request allows to set the request property with the appropriate payload.