123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201 |
- // Copyright 2012-2018 Oliver Eilhard. All rights reserved.
- // Use of this source code is governed by a MIT-license.
- // See http://olivere.mit-license.org/license.txt for details.
-
- package elastic
-
- import (
- "context"
- "encoding/json"
- "fmt"
- "net/http"
- "net/url"
- "strings"
-
- "github.com/olivere/elastic/v7/uritemplates"
- )
-
- // XPackSecurityChangePasswordService changes a native user's password.
- //
- // See https://www.elastic.co/guide/en/elasticsearch/reference/7.1/security-api-change-password.html.
- type XPackSecurityChangePasswordService struct {
- client *Client
-
- pretty *bool // pretty format the returned JSON response
- human *bool // return human readable values for statistics
- errorTrace *bool // include the stack trace of returned errors
- filterPath []string // list of filters used to reduce the response
- headers http.Header // custom request-level HTTP headers
-
- username string
- password string
- refresh string
- body interface{}
- }
-
- // NewXPackSecurityChangePasswordService creates a new XPackSecurityChangePasswordService.
- func NewXPackSecurityChangePasswordService(client *Client) *XPackSecurityChangePasswordService {
- return &XPackSecurityChangePasswordService{
- client: client,
- }
- }
-
- // Pretty tells Elasticsearch whether to return a formatted JSON response.
- func (s *XPackSecurityChangePasswordService) Pretty(pretty bool) *XPackSecurityChangePasswordService {
- s.pretty = &pretty
- return s
- }
-
- // Human specifies whether human readable values should be returned in
- // the JSON response, e.g. "7.5mb".
- func (s *XPackSecurityChangePasswordService) Human(human bool) *XPackSecurityChangePasswordService {
- s.human = &human
- return s
- }
-
- // ErrorTrace specifies whether to include the stack trace of returned errors.
- func (s *XPackSecurityChangePasswordService) ErrorTrace(errorTrace bool) *XPackSecurityChangePasswordService {
- s.errorTrace = &errorTrace
- return s
- }
-
- // FilterPath specifies a list of filters used to reduce the response.
- func (s *XPackSecurityChangePasswordService) FilterPath(filterPath ...string) *XPackSecurityChangePasswordService {
- s.filterPath = filterPath
- return s
- }
-
- // Header adds a header to the request.
- func (s *XPackSecurityChangePasswordService) Header(name string, value string) *XPackSecurityChangePasswordService {
- if s.headers == nil {
- s.headers = http.Header{}
- }
- s.headers.Add(name, value)
- return s
- }
-
- // Headers specifies the headers of the request.
- func (s *XPackSecurityChangePasswordService) Headers(headers http.Header) *XPackSecurityChangePasswordService {
- s.headers = headers
- return s
- }
-
- // Username is name of the user to change.
- func (s *XPackSecurityChangePasswordService) Username(username string) *XPackSecurityChangePasswordService {
- s.username = username
- return s
- }
-
- // Password is the new value of the password.
- func (s *XPackSecurityChangePasswordService) Password(password string) *XPackSecurityChangePasswordService {
- s.password = password
- return s
- }
-
- // Refresh, if "true" (the default), refreshes the affected shards to make this operation
- // visible to search, if "wait_for" then wait for a refresh to make this operation visible
- // to search, if "false" then do nothing with refreshes.
- func (s *XPackSecurityChangePasswordService) Refresh(refresh string) *XPackSecurityChangePasswordService {
- s.refresh = refresh
- return s
- }
-
- // Body specifies the password. Use a string or a type that will get serialized as JSON.
- func (s *XPackSecurityChangePasswordService) Body(body interface{}) *XPackSecurityChangePasswordService {
- s.body = body
- return s
- }
-
- // buildURL builds the URL for the operation.
- func (s *XPackSecurityChangePasswordService) buildURL() (string, url.Values, error) {
- // Build URL
- path, err := uritemplates.Expand("/_xpack/security/user/{username}/_password", map[string]string{
- "username": s.username,
- })
- if err != nil {
- return "", url.Values{}, err
- }
-
- // Add query string parameters
- params := url.Values{}
- if v := s.pretty; v != nil {
- params.Set("pretty", fmt.Sprint(*v))
- }
- if v := s.human; v != nil {
- params.Set("human", fmt.Sprint(*v))
- }
- if v := s.errorTrace; v != nil {
- params.Set("error_trace", fmt.Sprint(*v))
- }
- if len(s.filterPath) > 0 {
- params.Set("filter_path", strings.Join(s.filterPath, ","))
- }
- if v := s.refresh; v != "" {
- params.Set("refresh", v)
- }
- return path, params, nil
- }
-
- // Validate checks if the operation is valid.
- func (s *XPackSecurityChangePasswordService) Validate() error {
- var invalid []string
- if s.username == "" {
- invalid = append(invalid, "Userame")
- }
- if s.password == "" && s.body == nil {
- invalid = append(invalid, "Body")
- }
- if len(invalid) > 0 {
- return fmt.Errorf("missing required fields: %v", invalid)
- }
- return nil
- }
-
- // Do executes the operation.
- func (s *XPackSecurityChangePasswordService) Do(ctx context.Context) (*XPackSecurityChangeUserPasswordResponse, error) {
- // Check pre-conditions
- if err := s.Validate(); err != nil {
- return nil, err
- }
-
- // Get URL for request
- path, params, err := s.buildURL()
- if err != nil {
- return nil, err
- }
-
- var body interface{}
- if s.body != nil {
- body = s.body
- } else {
- body = map[string]interface{}{
- "password": s.password,
- }
- }
-
- // Get HTTP response
- res, err := s.client.PerformRequest(ctx, PerformRequestOptions{
- Method: "POST",
- Path: path,
- Params: params,
- Body: body,
- Headers: s.headers,
- })
- if err != nil {
- return nil, err
- }
-
- // Return operation response
- ret := new(XPackSecurityChangeUserPasswordResponse)
- if err := json.Unmarshal(res.Body, ret); err != nil {
- return nil, err
- }
- return ret, nil
- }
-
- // XPackSecurityChangeUserPasswordResponse is the response of
- // XPackSecurityChangePasswordService.Do.
- //
- // A successful call returns an empty JSON structure: {}.
- type XPackSecurityChangeUserPasswordResponse struct {
- }
|