// Copyright 2015 The Gogs Authors. All rights reserved. // Copyright 2019 The Gitea Authors. All rights reserved. // Use of this source code is governed by a MIT-style // license that can be found in the LICENSE file. package gitea import ( "bytes" "encoding/json" "fmt" ) // AdminListUsersOptions options for listing admin users type AdminListUsersOptions struct { ListOptions SourceID int64 LoginName string Query string Sort string // "name", "created", "updated", "id" Order string // "asc", "desc" Visibility string IsActive *bool IsAdmin *bool IsRestricted *bool Is2FAEnabled *bool IsProhibitLogin *bool } // QueryEncode turns options into querystring argument func (opt *AdminListUsersOptions) QueryEncode() string { query := opt.getURLQuery() if opt.SourceID > 0 { query.Add("source_id", fmt.Sprintf("%d", opt.SourceID)) } if opt.LoginName != "" { query.Add("login_name", opt.LoginName) } if opt.Query != "" { query.Add("q", opt.Query) } if opt.Sort != "" { query.Add("sort", opt.Sort) } if opt.Order != "" { query.Add("order", opt.Order) } if opt.Visibility != "" { query.Add("visibility", opt.Visibility) } if opt.IsActive != nil { query.Add("is_active", fmt.Sprintf("%t", *opt.IsActive)) } if opt.IsAdmin != nil { query.Add("is_admin", fmt.Sprintf("%t", *opt.IsAdmin)) } if opt.IsRestricted != nil { query.Add("is_restricted", fmt.Sprintf("%t", *opt.IsRestricted)) } if opt.Is2FAEnabled != nil { query.Add("is_2fa_enabled", fmt.Sprintf("%t", *opt.Is2FAEnabled)) } if opt.IsProhibitLogin != nil { query.Add("is_prohibit_login", fmt.Sprintf("%t", *opt.IsProhibitLogin)) } return query.Encode() } // AdminListUsers lists all users func (c *Client) AdminListUsers(opt AdminListUsersOptions) ([]*User, *Response, error) { opt.setDefaults() users := make([]*User, 0, opt.PageSize) resp, err := c.getParsedResponse("GET", fmt.Sprintf("/admin/users?%s", opt.QueryEncode()), nil, nil, &users) return users, resp, err } // CreateUserOption create user options type CreateUserOption struct { SourceID int64 `json:"source_id"` LoginName string `json:"login_name"` Username string `json:"username"` FullName string `json:"full_name"` Email string `json:"email"` Password string `json:"password"` MustChangePassword *bool `json:"must_change_password"` SendNotify bool `json:"send_notify"` Visibility *VisibleType `json:"visibility"` } // Validate the CreateUserOption struct func (opt CreateUserOption) Validate() error { if len(opt.Email) == 0 { return fmt.Errorf("email is empty") } if len(opt.Username) == 0 { return fmt.Errorf("username is empty") } return nil } // AdminCreateUser create a user func (c *Client) AdminCreateUser(opt CreateUserOption) (*User, *Response, error) { if err := opt.Validate(); err != nil { return nil, nil, err } body, err := json.Marshal(&opt) if err != nil { return nil, nil, err } user := new(User) resp, err := c.getParsedResponse("POST", "/admin/users", jsonHeader, bytes.NewReader(body), user) return user, resp, err } // EditUserOption edit user options type EditUserOption struct { SourceID int64 `json:"source_id"` LoginName string `json:"login_name"` Email *string `json:"email"` FullName *string `json:"full_name"` Password string `json:"password"` Description *string `json:"description"` MustChangePassword *bool `json:"must_change_password"` Website *string `json:"website"` Location *string `json:"location"` Active *bool `json:"active"` Admin *bool `json:"admin"` AllowGitHook *bool `json:"allow_git_hook"` AllowImportLocal *bool `json:"allow_import_local"` MaxRepoCreation *int `json:"max_repo_creation"` ProhibitLogin *bool `json:"prohibit_login"` AllowCreateOrganization *bool `json:"allow_create_organization"` Restricted *bool `json:"restricted"` Visibility *VisibleType `json:"visibility"` } // AdminEditUser modify user informations func (c *Client) AdminEditUser(user string, opt EditUserOption) (*Response, error) { if err := escapeValidatePathSegments(&user); err != nil { return nil, err } body, err := json.Marshal(&opt) if err != nil { return nil, err } return c.doRequestWithStatusHandle("PATCH", fmt.Sprintf("/admin/users/%s", user), jsonHeader, bytes.NewReader(body)) } // AdminDeleteUser delete one user according name func (c *Client) AdminDeleteUser(user string) (*Response, error) { if err := escapeValidatePathSegments(&user); err != nil { return nil, err } return c.doRequestWithStatusHandle("DELETE", fmt.Sprintf("/admin/users/%s", user), nil, nil) } // AdminCreateUserPublicKey adds a public key for the user func (c *Client) AdminCreateUserPublicKey(user string, opt CreateKeyOption) (*PublicKey, *Response, error) { if err := escapeValidatePathSegments(&user); err != nil { return nil, nil, err } body, err := json.Marshal(&opt) if err != nil { return nil, nil, err } key := new(PublicKey) resp, err := c.getParsedResponse("POST", fmt.Sprintf("/admin/users/%s/keys", user), jsonHeader, bytes.NewReader(body), key) return key, resp, err } // AdminDeleteUserPublicKey deletes a user's public key func (c *Client) AdminDeleteUserPublicKey(user string, keyID int) (*Response, error) { if err := escapeValidatePathSegments(&user); err != nil { return nil, err } return c.doRequestWithStatusHandle("DELETE", fmt.Sprintf("/admin/users/%s/keys/%d", user, keyID), nil, nil) } // RenameUserOption options for renaming a user type RenameUserOption struct { NewUsername string `json:"new_username"` } // AdminRenameUser renames a user func (c *Client) AdminRenameUser(username string, opt RenameUserOption) (*Response, error) { if err := escapeValidatePathSegments(&username); err != nil { return nil, err } body, err := json.Marshal(&opt) if err != nil { return nil, err } return c.doRequestWithStatusHandle("POST", fmt.Sprintf("/admin/users/%s/rename", username), jsonHeader, bytes.NewReader(body)) }