samlprepareauthentication

Documentation

Overview

Creates a SAML authentication request

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(ctx context.Context) (*Response, error)
  • func (r *SamlPrepareAuthentication) Header(key, value string) *SamlPrepareAuthentication
  • func (r *SamlPrepareAuthentication) HttpRequest(ctx context.Context) (*http.Request, error)
  • func (r SamlPrepareAuthentication) Perform(ctx context.Context) (*http.Response, error)
  • 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/3b09f9d8e90178243f8a340a7bc324aab152c602/specification/security/saml_prepare_authentication/Request.ts#L22-L46

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"`
}

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

Creates a SAML authentication request

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(ctx context.Context) (*Response, error)

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

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) Perform

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

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

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.