user.go 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146
  1. // Copyright 2014 The Gogs Authors. All rights reserved.
  2. // Use of this source code is governed by a MIT-style
  3. // license that can be found in the LICENSE file.
  4. package models
  5. import (
  6. "bytes"
  7. "container/list"
  8. "crypto/sha256"
  9. "crypto/subtle"
  10. "encoding/hex"
  11. "fmt"
  12. "image"
  13. _ "image/jpeg"
  14. "image/png"
  15. "os"
  16. "path/filepath"
  17. "strings"
  18. "time"
  19. "unicode/utf8"
  20. "github.com/Unknwon/com"
  21. "github.com/go-xorm/xorm"
  22. "github.com/nfnt/resize"
  23. "golang.org/x/crypto/pbkdf2"
  24. log "gopkg.in/clog.v1"
  25. "github.com/gogs/git-module"
  26. api "github.com/gogs/go-gogs-client"
  27. "github.com/gogs/gogs/models/errors"
  28. "github.com/gogs/gogs/pkg/avatar"
  29. "github.com/gogs/gogs/pkg/setting"
  30. "github.com/gogs/gogs/pkg/tool"
  31. )
  32. // USER_AVATAR_URL_PREFIX is used to identify a URL is to access user avatar.
  33. const USER_AVATAR_URL_PREFIX = "avatars"
  34. type UserType int
  35. const (
  36. USER_TYPE_INDIVIDUAL UserType = iota // Historic reason to make it starts at 0.
  37. USER_TYPE_ORGANIZATION
  38. )
  39. // User represents the object of individual and member of organization.
  40. type User struct {
  41. ID int64
  42. LowerName string `xorm:"UNIQUE NOT NULL"`
  43. Name string `xorm:"UNIQUE NOT NULL"`
  44. FullName string
  45. // Email is the primary email address (to be used for communication)
  46. Email string `xorm:"NOT NULL"`
  47. Passwd string `xorm:"NOT NULL"`
  48. LoginType LoginType
  49. LoginSource int64 `xorm:"NOT NULL DEFAULT 0"`
  50. LoginName string
  51. Type UserType
  52. OwnedOrgs []*User `xorm:"-" json:"-"`
  53. Orgs []*User `xorm:"-" json:"-"`
  54. Repos []*Repository `xorm:"-" json:"-"`
  55. Location string
  56. Website string
  57. Rands string `xorm:"VARCHAR(10)"`
  58. Salt string `xorm:"VARCHAR(10)"`
  59. Created time.Time `xorm:"-" json:"-"`
  60. CreatedUnix int64
  61. Updated time.Time `xorm:"-" json:"-"`
  62. UpdatedUnix int64
  63. // Remember visibility choice for convenience, true for private
  64. LastRepoVisibility bool
  65. // Maximum repository creation limit, -1 means use gloabl default
  66. MaxRepoCreation int `xorm:"NOT NULL DEFAULT -1"`
  67. // Permissions
  68. IsActive bool // Activate primary email
  69. IsAdmin bool
  70. AllowGitHook bool
  71. AllowImportLocal bool // Allow migrate repository by local path
  72. ProhibitLogin bool
  73. // Avatar
  74. Avatar string `xorm:"VARCHAR(2048) NOT NULL"`
  75. AvatarEmail string `xorm:"NOT NULL"`
  76. UseCustomAvatar bool
  77. // Counters
  78. NumFollowers int
  79. NumFollowing int `xorm:"NOT NULL DEFAULT 0"`
  80. NumStars int
  81. NumRepos int
  82. // For organization
  83. Description string
  84. NumTeams int
  85. NumMembers int
  86. Teams []*Team `xorm:"-" json:"-"`
  87. Members []*User `xorm:"-" json:"-"`
  88. }
  89. func (u *User) BeforeInsert() {
  90. u.CreatedUnix = time.Now().Unix()
  91. u.UpdatedUnix = u.CreatedUnix
  92. }
  93. func (u *User) BeforeUpdate() {
  94. if u.MaxRepoCreation < -1 {
  95. u.MaxRepoCreation = -1
  96. }
  97. u.UpdatedUnix = time.Now().Unix()
  98. }
  99. func (u *User) AfterSet(colName string, _ xorm.Cell) {
  100. switch colName {
  101. case "created_unix":
  102. u.Created = time.Unix(u.CreatedUnix, 0).Local()
  103. case "updated_unix":
  104. u.Updated = time.Unix(u.UpdatedUnix, 0).Local()
  105. }
  106. }
  107. // IDStr returns string representation of user's ID.
  108. func (u *User) IDStr() string {
  109. return com.ToStr(u.ID)
  110. }
  111. func (u *User) APIFormat() *api.User {
  112. return &api.User{
  113. ID: u.ID,
  114. UserName: u.Name,
  115. Login: u.Name,
  116. FullName: u.FullName,
  117. Email: u.Email,
  118. AvatarUrl: u.AvatarLink(),
  119. }
  120. }
  121. // returns true if user login type is LOGIN_PLAIN.
  122. func (u *User) IsLocal() bool {
  123. return u.LoginType <= LOGIN_PLAIN
  124. }
  125. // HasForkedRepo checks if user has already forked a repository with given ID.
  126. func (u *User) HasForkedRepo(repoID int64) bool {
  127. _, has, _ := HasForkedRepo(u.ID, repoID)
  128. return has
  129. }
  130. func (u *User) RepoCreationNum() int {
  131. if u.MaxRepoCreation <= -1 {
  132. return setting.Repository.MaxCreationLimit
  133. }
  134. return u.MaxRepoCreation
  135. }
  136. func (u *User) CanCreateRepo() bool {
  137. if u.MaxRepoCreation <= -1 {
  138. if setting.Repository.MaxCreationLimit <= -1 {
  139. return true
  140. }
  141. return u.NumRepos < setting.Repository.MaxCreationLimit
  142. }
  143. return u.NumRepos < u.MaxRepoCreation
  144. }
  145. func (u *User) CanCreateOrganization() bool {
  146. return !setting.Admin.DisableRegularOrgCreation || u.IsAdmin
  147. }
  148. // CanEditGitHook returns true if user can edit Git hooks.
  149. func (u *User) CanEditGitHook() bool {
  150. return u.IsAdmin || u.AllowGitHook
  151. }
  152. // CanImportLocal returns true if user can migrate repository by local path.
  153. func (u *User) CanImportLocal() bool {
  154. return setting.Repository.EnableLocalPathMigration && (u.IsAdmin || u.AllowImportLocal)
  155. }
  156. // DashboardLink returns the user dashboard page link.
  157. func (u *User) DashboardLink() string {
  158. if u.IsOrganization() {
  159. return setting.AppSubURL + "/org/" + u.Name + "/dashboard/"
  160. }
  161. return setting.AppSubURL + "/"
  162. }
  163. // HomeLink returns the user or organization home page link.
  164. func (u *User) HomeLink() string {
  165. return setting.AppSubURL + "/" + u.Name
  166. }
  167. func (u *User) HTMLURL() string {
  168. return setting.AppURL + u.Name
  169. }
  170. // GenerateEmailActivateCode generates an activate code based on user information and given e-mail.
  171. func (u *User) GenerateEmailActivateCode(email string) string {
  172. code := tool.CreateTimeLimitCode(
  173. com.ToStr(u.ID)+email+u.LowerName+u.Passwd+u.Rands,
  174. setting.Service.ActiveCodeLives, nil)
  175. // Add tail hex username
  176. code += hex.EncodeToString([]byte(u.LowerName))
  177. return code
  178. }
  179. // GenerateActivateCode generates an activate code based on user information.
  180. func (u *User) GenerateActivateCode() string {
  181. return u.GenerateEmailActivateCode(u.Email)
  182. }
  183. // CustomAvatarPath returns user custom avatar file path.
  184. func (u *User) CustomAvatarPath() string {
  185. return filepath.Join(setting.AvatarUploadPath, com.ToStr(u.ID))
  186. }
  187. // GenerateRandomAvatar generates a random avatar for user.
  188. func (u *User) GenerateRandomAvatar() error {
  189. seed := u.Email
  190. if len(seed) == 0 {
  191. seed = u.Name
  192. }
  193. img, err := avatar.RandomImage([]byte(seed))
  194. if err != nil {
  195. return fmt.Errorf("RandomImage: %v", err)
  196. }
  197. if err = os.MkdirAll(filepath.Dir(u.CustomAvatarPath()), os.ModePerm); err != nil {
  198. return fmt.Errorf("MkdirAll: %v", err)
  199. }
  200. fw, err := os.Create(u.CustomAvatarPath())
  201. if err != nil {
  202. return fmt.Errorf("Create: %v", err)
  203. }
  204. defer fw.Close()
  205. if err = png.Encode(fw, img); err != nil {
  206. return fmt.Errorf("Encode: %v", err)
  207. }
  208. log.Info("New random avatar created: %d", u.ID)
  209. return nil
  210. }
  211. // RelAvatarLink returns relative avatar link to the site domain,
  212. // which includes app sub-url as prefix. However, it is possible
  213. // to return full URL if user enables Gravatar-like service.
  214. func (u *User) RelAvatarLink() string {
  215. defaultImgUrl := setting.AppSubURL + "/img/avatar_default.png"
  216. if u.ID == -1 {
  217. return defaultImgUrl
  218. }
  219. switch {
  220. case u.UseCustomAvatar:
  221. if !com.IsExist(u.CustomAvatarPath()) {
  222. return defaultImgUrl
  223. }
  224. return fmt.Sprintf("%s/%s/%d", setting.AppSubURL, USER_AVATAR_URL_PREFIX, u.ID)
  225. case setting.DisableGravatar, setting.OfflineMode:
  226. if !com.IsExist(u.CustomAvatarPath()) {
  227. if err := u.GenerateRandomAvatar(); err != nil {
  228. log.Error(3, "GenerateRandomAvatar: %v", err)
  229. }
  230. }
  231. return fmt.Sprintf("%s/%s/%d", setting.AppSubURL, USER_AVATAR_URL_PREFIX, u.ID)
  232. }
  233. return tool.AvatarLink(u.AvatarEmail)
  234. }
  235. // AvatarLink returns user avatar absolute link.
  236. func (u *User) AvatarLink() string {
  237. link := u.RelAvatarLink()
  238. if link[0] == '/' && link[1] != '/' {
  239. return setting.AppURL + strings.TrimPrefix(link, setting.AppSubURL)[1:]
  240. }
  241. return link
  242. }
  243. // User.GetFollwoers returns range of user's followers.
  244. func (u *User) GetFollowers(page int) ([]*User, error) {
  245. users := make([]*User, 0, ItemsPerPage)
  246. sess := x.Limit(ItemsPerPage, (page-1)*ItemsPerPage).Where("follow.follow_id=?", u.ID)
  247. if setting.UsePostgreSQL {
  248. sess = sess.Join("LEFT", "follow", `"user".id=follow.user_id`)
  249. } else {
  250. sess = sess.Join("LEFT", "follow", "user.id=follow.user_id")
  251. }
  252. return users, sess.Find(&users)
  253. }
  254. func (u *User) IsFollowing(followID int64) bool {
  255. return IsFollowing(u.ID, followID)
  256. }
  257. // GetFollowing returns range of user's following.
  258. func (u *User) GetFollowing(page int) ([]*User, error) {
  259. users := make([]*User, 0, ItemsPerPage)
  260. sess := x.Limit(ItemsPerPage, (page-1)*ItemsPerPage).Where("follow.user_id=?", u.ID)
  261. if setting.UsePostgreSQL {
  262. sess = sess.Join("LEFT", "follow", `"user".id=follow.follow_id`)
  263. } else {
  264. sess = sess.Join("LEFT", "follow", "user.id=follow.follow_id")
  265. }
  266. return users, sess.Find(&users)
  267. }
  268. // NewGitSig generates and returns the signature of given user.
  269. func (u *User) NewGitSig() *git.Signature {
  270. return &git.Signature{
  271. Name: u.DisplayName(),
  272. Email: u.Email,
  273. When: time.Now(),
  274. }
  275. }
  276. // EncodePasswd encodes password to safe format.
  277. func (u *User) EncodePasswd() {
  278. newPasswd := pbkdf2.Key([]byte(u.Passwd), []byte(u.Salt), 10000, 50, sha256.New)
  279. u.Passwd = fmt.Sprintf("%x", newPasswd)
  280. }
  281. // ValidatePassword checks if given password matches the one belongs to the user.
  282. func (u *User) ValidatePassword(passwd string) bool {
  283. newUser := &User{Passwd: passwd, Salt: u.Salt}
  284. newUser.EncodePasswd()
  285. return subtle.ConstantTimeCompare([]byte(u.Passwd), []byte(newUser.Passwd)) == 1
  286. }
  287. // UploadAvatar saves custom avatar for user.
  288. // FIXME: split uploads to different subdirs in case we have massive number of users.
  289. func (u *User) UploadAvatar(data []byte) error {
  290. img, _, err := image.Decode(bytes.NewReader(data))
  291. if err != nil {
  292. return fmt.Errorf("decode image: %v", err)
  293. }
  294. os.MkdirAll(setting.AvatarUploadPath, os.ModePerm)
  295. fw, err := os.Create(u.CustomAvatarPath())
  296. if err != nil {
  297. return fmt.Errorf("create custom avatar directory: %v", err)
  298. }
  299. defer fw.Close()
  300. m := resize.Resize(avatar.AVATAR_SIZE, avatar.AVATAR_SIZE, img, resize.NearestNeighbor)
  301. if err = png.Encode(fw, m); err != nil {
  302. return fmt.Errorf("encode image: %v", err)
  303. }
  304. return nil
  305. }
  306. // DeleteAvatar deletes the user's custom avatar.
  307. func (u *User) DeleteAvatar() error {
  308. log.Trace("DeleteAvatar [%d]: %s", u.ID, u.CustomAvatarPath())
  309. if err := os.Remove(u.CustomAvatarPath()); err != nil {
  310. return err
  311. }
  312. u.UseCustomAvatar = false
  313. return UpdateUser(u)
  314. }
  315. // IsAdminOfRepo returns true if user has admin or higher access of repository.
  316. func (u *User) IsAdminOfRepo(repo *Repository) bool {
  317. has, err := HasAccess(u.ID, repo, ACCESS_MODE_ADMIN)
  318. if err != nil {
  319. log.Error(2, "HasAccess: %v", err)
  320. }
  321. return has
  322. }
  323. // IsWriterOfRepo returns true if user has write access to given repository.
  324. func (u *User) IsWriterOfRepo(repo *Repository) bool {
  325. has, err := HasAccess(u.ID, repo, ACCESS_MODE_WRITE)
  326. if err != nil {
  327. log.Error(2, "HasAccess: %v", err)
  328. }
  329. return has
  330. }
  331. // IsOrganization returns true if user is actually a organization.
  332. func (u *User) IsOrganization() bool {
  333. return u.Type == USER_TYPE_ORGANIZATION
  334. }
  335. // IsUserOrgOwner returns true if user is in the owner team of given organization.
  336. func (u *User) IsUserOrgOwner(orgId int64) bool {
  337. return IsOrganizationOwner(orgId, u.ID)
  338. }
  339. // IsPublicMember returns true if user public his/her membership in give organization.
  340. func (u *User) IsPublicMember(orgId int64) bool {
  341. return IsPublicMembership(orgId, u.ID)
  342. }
  343. // IsEnabledTwoFactor returns true if user has enabled two-factor authentication.
  344. func (u *User) IsEnabledTwoFactor() bool {
  345. return IsUserEnabledTwoFactor(u.ID)
  346. }
  347. func (u *User) getOrganizationCount(e Engine) (int64, error) {
  348. return e.Where("uid=?", u.ID).Count(new(OrgUser))
  349. }
  350. // GetOrganizationCount returns count of membership of organization of user.
  351. func (u *User) GetOrganizationCount() (int64, error) {
  352. return u.getOrganizationCount(x)
  353. }
  354. // GetRepositories returns repositories that user owns, including private repositories.
  355. func (u *User) GetRepositories(page, pageSize int) (err error) {
  356. u.Repos, err = GetUserRepositories(&UserRepoOptions{
  357. UserID: u.ID,
  358. Private: true,
  359. Page: page,
  360. PageSize: pageSize,
  361. })
  362. return err
  363. }
  364. // GetRepositories returns mirror repositories that user owns, including private repositories.
  365. func (u *User) GetMirrorRepositories() ([]*Repository, error) {
  366. return GetUserMirrorRepositories(u.ID)
  367. }
  368. // GetOwnedOrganizations returns all organizations that user owns.
  369. func (u *User) GetOwnedOrganizations() (err error) {
  370. u.OwnedOrgs, err = GetOwnedOrgsByUserID(u.ID)
  371. return err
  372. }
  373. // GetOrganizations returns all organizations that user belongs to.
  374. func (u *User) GetOrganizations(showPrivate bool) error {
  375. orgIDs, err := GetOrgIDsByUserID(u.ID, showPrivate)
  376. if err != nil {
  377. return fmt.Errorf("GetOrgIDsByUserID: %v", err)
  378. }
  379. if len(orgIDs) == 0 {
  380. return nil
  381. }
  382. u.Orgs = make([]*User, 0, len(orgIDs))
  383. if err = x.Where("type = ?", USER_TYPE_ORGANIZATION).In("id", orgIDs).Find(&u.Orgs); err != nil {
  384. return err
  385. }
  386. return nil
  387. }
  388. // DisplayName returns full name if it's not empty,
  389. // returns username otherwise.
  390. func (u *User) DisplayName() string {
  391. if len(u.FullName) > 0 {
  392. return u.FullName
  393. }
  394. return u.Name
  395. }
  396. func (u *User) ShortName(length int) string {
  397. return tool.EllipsisString(u.Name, length)
  398. }
  399. // IsMailable checks if a user is elegible
  400. // to receive emails.
  401. func (u *User) IsMailable() bool {
  402. return u.IsActive
  403. }
  404. // IsUserExist checks if given user name exist,
  405. // the user name should be noncased unique.
  406. // If uid is presented, then check will rule out that one,
  407. // it is used when update a user name in settings page.
  408. func IsUserExist(uid int64, name string) (bool, error) {
  409. if len(name) == 0 {
  410. return false, nil
  411. }
  412. return x.Where("id != ?", uid).Get(&User{LowerName: strings.ToLower(name)})
  413. }
  414. // GetUserSalt returns a ramdom user salt token.
  415. func GetUserSalt() (string, error) {
  416. return tool.RandomString(10)
  417. }
  418. // NewGhostUser creates and returns a fake user for someone who has deleted his/her account.
  419. func NewGhostUser() *User {
  420. return &User{
  421. ID: -1,
  422. Name: "Ghost",
  423. LowerName: "ghost",
  424. }
  425. }
  426. var (
  427. reservedUsernames = []string{"explore", "create", "assets", "css", "img", "js", "less", "plugins", "debug", "raw", "install", "api", "avatar", "user", "org", "help", "stars", "issues", "pulls", "commits", "repo", "template", "admin", "new", ".", ".."}
  428. reservedUserPatterns = []string{"*.keys"}
  429. )
  430. // isUsableName checks if name is reserved or pattern of name is not allowed
  431. // based on given reserved names and patterns.
  432. // Names are exact match, patterns can be prefix or suffix match with placeholder '*'.
  433. func isUsableName(names, patterns []string, name string) error {
  434. name = strings.TrimSpace(strings.ToLower(name))
  435. if utf8.RuneCountInString(name) == 0 {
  436. return errors.EmptyName{}
  437. }
  438. for i := range names {
  439. if name == names[i] {
  440. return ErrNameReserved{name}
  441. }
  442. }
  443. for _, pat := range patterns {
  444. if pat[0] == '*' && strings.HasSuffix(name, pat[1:]) ||
  445. (pat[len(pat)-1] == '*' && strings.HasPrefix(name, pat[:len(pat)-1])) {
  446. return ErrNamePatternNotAllowed{pat}
  447. }
  448. }
  449. return nil
  450. }
  451. func IsUsableUsername(name string) error {
  452. return isUsableName(reservedUsernames, reservedUserPatterns, name)
  453. }
  454. // CreateUser creates record of a new user.
  455. func CreateUser(u *User) (err error) {
  456. if err = IsUsableUsername(u.Name); err != nil {
  457. return err
  458. }
  459. isExist, err := IsUserExist(0, u.Name)
  460. if err != nil {
  461. return err
  462. } else if isExist {
  463. return ErrUserAlreadyExist{u.Name}
  464. }
  465. u.Email = strings.ToLower(u.Email)
  466. isExist, err = IsEmailUsed(u.Email)
  467. if err != nil {
  468. return err
  469. } else if isExist {
  470. return ErrEmailAlreadyUsed{u.Email}
  471. }
  472. u.LowerName = strings.ToLower(u.Name)
  473. u.AvatarEmail = u.Email
  474. u.Avatar = tool.HashEmail(u.AvatarEmail)
  475. if u.Rands, err = GetUserSalt(); err != nil {
  476. return err
  477. }
  478. if u.Salt, err = GetUserSalt(); err != nil {
  479. return err
  480. }
  481. u.EncodePasswd()
  482. u.MaxRepoCreation = -1
  483. sess := x.NewSession()
  484. defer sess.Close()
  485. if err = sess.Begin(); err != nil {
  486. return err
  487. }
  488. if _, err = sess.Insert(u); err != nil {
  489. return err
  490. } else if err = os.MkdirAll(UserPath(u.Name), os.ModePerm); err != nil {
  491. return err
  492. }
  493. return sess.Commit()
  494. }
  495. func countUsers(e Engine) int64 {
  496. count, _ := e.Where("type=0").Count(new(User))
  497. return count
  498. }
  499. // CountUsers returns number of users.
  500. func CountUsers() int64 {
  501. return countUsers(x)
  502. }
  503. // Users returns number of users in given page.
  504. func Users(page, pageSize int) ([]*User, error) {
  505. users := make([]*User, 0, pageSize)
  506. return users, x.Limit(pageSize, (page-1)*pageSize).Where("type=0").Asc("id").Find(&users)
  507. }
  508. // parseUserFromCode returns user by username encoded in code.
  509. // It returns nil if code or username is invalid.
  510. func parseUserFromCode(code string) (user *User) {
  511. if len(code) <= tool.TIME_LIMIT_CODE_LENGTH {
  512. return nil
  513. }
  514. // Use tail hex username to query user
  515. hexStr := code[tool.TIME_LIMIT_CODE_LENGTH:]
  516. if b, err := hex.DecodeString(hexStr); err == nil {
  517. if user, err = GetUserByName(string(b)); user != nil {
  518. return user
  519. } else if !errors.IsUserNotExist(err) {
  520. log.Error(2, "GetUserByName: %v", err)
  521. }
  522. }
  523. return nil
  524. }
  525. // verify active code when active account
  526. func VerifyUserActiveCode(code string) (user *User) {
  527. minutes := setting.Service.ActiveCodeLives
  528. if user = parseUserFromCode(code); user != nil {
  529. // time limit code
  530. prefix := code[:tool.TIME_LIMIT_CODE_LENGTH]
  531. data := com.ToStr(user.ID) + user.Email + user.LowerName + user.Passwd + user.Rands
  532. if tool.VerifyTimeLimitCode(data, minutes, prefix) {
  533. return user
  534. }
  535. }
  536. return nil
  537. }
  538. // verify active code when active account
  539. func VerifyActiveEmailCode(code, email string) *EmailAddress {
  540. minutes := setting.Service.ActiveCodeLives
  541. if user := parseUserFromCode(code); user != nil {
  542. // time limit code
  543. prefix := code[:tool.TIME_LIMIT_CODE_LENGTH]
  544. data := com.ToStr(user.ID) + email + user.LowerName + user.Passwd + user.Rands
  545. if tool.VerifyTimeLimitCode(data, minutes, prefix) {
  546. emailAddress := &EmailAddress{Email: email}
  547. if has, _ := x.Get(emailAddress); has {
  548. return emailAddress
  549. }
  550. }
  551. }
  552. return nil
  553. }
  554. // ChangeUserName changes all corresponding setting from old user name to new one.
  555. func ChangeUserName(u *User, newUserName string) (err error) {
  556. if err = IsUsableUsername(newUserName); err != nil {
  557. return err
  558. }
  559. isExist, err := IsUserExist(0, newUserName)
  560. if err != nil {
  561. return err
  562. } else if isExist {
  563. return ErrUserAlreadyExist{newUserName}
  564. }
  565. if err = ChangeUsernameInPullRequests(u.Name, newUserName); err != nil {
  566. return fmt.Errorf("ChangeUsernameInPullRequests: %v", err)
  567. }
  568. // Delete all local copies of repository wiki that user owns.
  569. if err = x.Where("owner_id=?", u.ID).Iterate(new(Repository), func(idx int, bean interface{}) error {
  570. repo := bean.(*Repository)
  571. RemoveAllWithNotice("Delete repository wiki local copy", repo.LocalWikiPath())
  572. return nil
  573. }); err != nil {
  574. return fmt.Errorf("Delete repository wiki local copy: %v", err)
  575. }
  576. // Rename or create user base directory
  577. baseDir := UserPath(u.Name)
  578. newBaseDir := UserPath(newUserName)
  579. if com.IsExist(baseDir) {
  580. return os.Rename(baseDir, newBaseDir)
  581. }
  582. return os.MkdirAll(newBaseDir, os.ModePerm)
  583. }
  584. func updateUser(e Engine, u *User) error {
  585. // Organization does not need email
  586. if !u.IsOrganization() {
  587. u.Email = strings.ToLower(u.Email)
  588. has, err := e.Where("id!=?", u.ID).And("type=?", u.Type).And("email=?", u.Email).Get(new(User))
  589. if err != nil {
  590. return err
  591. } else if has {
  592. return ErrEmailAlreadyUsed{u.Email}
  593. }
  594. if len(u.AvatarEmail) == 0 {
  595. u.AvatarEmail = u.Email
  596. }
  597. u.Avatar = tool.HashEmail(u.AvatarEmail)
  598. }
  599. u.LowerName = strings.ToLower(u.Name)
  600. u.Location = tool.TruncateString(u.Location, 255)
  601. u.Website = tool.TruncateString(u.Website, 255)
  602. u.Description = tool.TruncateString(u.Description, 255)
  603. _, err := e.ID(u.ID).AllCols().Update(u)
  604. return err
  605. }
  606. // UpdateUser updates user's information.
  607. func UpdateUser(u *User) error {
  608. return updateUser(x, u)
  609. }
  610. // deleteBeans deletes all given beans, beans should contain delete conditions.
  611. func deleteBeans(e Engine, beans ...interface{}) (err error) {
  612. for i := range beans {
  613. if _, err = e.Delete(beans[i]); err != nil {
  614. return err
  615. }
  616. }
  617. return nil
  618. }
  619. // FIXME: need some kind of mechanism to record failure. HINT: system notice
  620. func deleteUser(e *xorm.Session, u *User) error {
  621. // Note: A user owns any repository or belongs to any organization
  622. // cannot perform delete operation.
  623. // Check ownership of repository.
  624. count, err := getRepositoryCount(e, u)
  625. if err != nil {
  626. return fmt.Errorf("GetRepositoryCount: %v", err)
  627. } else if count > 0 {
  628. return ErrUserOwnRepos{UID: u.ID}
  629. }
  630. // Check membership of organization.
  631. count, err = u.getOrganizationCount(e)
  632. if err != nil {
  633. return fmt.Errorf("GetOrganizationCount: %v", err)
  634. } else if count > 0 {
  635. return ErrUserHasOrgs{UID: u.ID}
  636. }
  637. // ***** START: Watch *****
  638. watches := make([]*Watch, 0, 10)
  639. if err = e.Find(&watches, &Watch{UserID: u.ID}); err != nil {
  640. return fmt.Errorf("get all watches: %v", err)
  641. }
  642. for i := range watches {
  643. if _, err = e.Exec("UPDATE `repository` SET num_watches=num_watches-1 WHERE id=?", watches[i].RepoID); err != nil {
  644. return fmt.Errorf("decrease repository watch number[%d]: %v", watches[i].RepoID, err)
  645. }
  646. }
  647. // ***** END: Watch *****
  648. // ***** START: Star *****
  649. stars := make([]*Star, 0, 10)
  650. if err = e.Find(&stars, &Star{UID: u.ID}); err != nil {
  651. return fmt.Errorf("get all stars: %v", err)
  652. }
  653. for i := range stars {
  654. if _, err = e.Exec("UPDATE `repository` SET num_stars=num_stars-1 WHERE id=?", stars[i].RepoID); err != nil {
  655. return fmt.Errorf("decrease repository star number[%d]: %v", stars[i].RepoID, err)
  656. }
  657. }
  658. // ***** END: Star *****
  659. // ***** START: Follow *****
  660. followers := make([]*Follow, 0, 10)
  661. if err = e.Find(&followers, &Follow{UserID: u.ID}); err != nil {
  662. return fmt.Errorf("get all followers: %v", err)
  663. }
  664. for i := range followers {
  665. if _, err = e.Exec("UPDATE `user` SET num_followers=num_followers-1 WHERE id=?", followers[i].UserID); err != nil {
  666. return fmt.Errorf("decrease user follower number[%d]: %v", followers[i].UserID, err)
  667. }
  668. }
  669. // ***** END: Follow *****
  670. if err = deleteBeans(e,
  671. &AccessToken{UID: u.ID},
  672. &Collaboration{UserID: u.ID},
  673. &Access{UserID: u.ID},
  674. &Watch{UserID: u.ID},
  675. &Star{UID: u.ID},
  676. &Follow{FollowID: u.ID},
  677. &Action{UserID: u.ID},
  678. &IssueUser{UID: u.ID},
  679. &EmailAddress{UID: u.ID},
  680. ); err != nil {
  681. return fmt.Errorf("deleteBeans: %v", err)
  682. }
  683. // ***** START: PublicKey *****
  684. keys := make([]*PublicKey, 0, 10)
  685. if err = e.Find(&keys, &PublicKey{OwnerID: u.ID}); err != nil {
  686. return fmt.Errorf("get all public keys: %v", err)
  687. }
  688. keyIDs := make([]int64, len(keys))
  689. for i := range keys {
  690. keyIDs[i] = keys[i].ID
  691. }
  692. if err = deletePublicKeys(e, keyIDs...); err != nil {
  693. return fmt.Errorf("deletePublicKeys: %v", err)
  694. }
  695. // ***** END: PublicKey *****
  696. // Clear assignee.
  697. if _, err = e.Exec("UPDATE `issue` SET assignee_id=0 WHERE assignee_id=?", u.ID); err != nil {
  698. return fmt.Errorf("clear assignee: %v", err)
  699. }
  700. if _, err = e.Id(u.ID).Delete(new(User)); err != nil {
  701. return fmt.Errorf("Delete: %v", err)
  702. }
  703. // FIXME: system notice
  704. // Note: There are something just cannot be roll back,
  705. // so just keep error logs of those operations.
  706. os.RemoveAll(UserPath(u.Name))
  707. os.Remove(u.CustomAvatarPath())
  708. return nil
  709. }
  710. // DeleteUser completely and permanently deletes everything of a user,
  711. // but issues/comments/pulls will be kept and shown as someone has been deleted.
  712. func DeleteUser(u *User) (err error) {
  713. sess := x.NewSession()
  714. defer sess.Close()
  715. if err = sess.Begin(); err != nil {
  716. return err
  717. }
  718. if err = deleteUser(sess, u); err != nil {
  719. // Note: don't wrapper error here.
  720. return err
  721. }
  722. if err = sess.Commit(); err != nil {
  723. return err
  724. }
  725. return RewriteAuthorizedKeys()
  726. }
  727. // DeleteInactivateUsers deletes all inactivate users and email addresses.
  728. func DeleteInactivateUsers() (err error) {
  729. users := make([]*User, 0, 10)
  730. if err = x.Where("is_active = ?", false).Find(&users); err != nil {
  731. return fmt.Errorf("get all inactive users: %v", err)
  732. }
  733. // FIXME: should only update authorized_keys file once after all deletions.
  734. for _, u := range users {
  735. if err = DeleteUser(u); err != nil {
  736. // Ignore users that were set inactive by admin.
  737. if IsErrUserOwnRepos(err) || IsErrUserHasOrgs(err) {
  738. continue
  739. }
  740. return err
  741. }
  742. }
  743. _, err = x.Where("is_activated = ?", false).Delete(new(EmailAddress))
  744. return err
  745. }
  746. // UserPath returns the path absolute path of user repositories.
  747. func UserPath(userName string) string {
  748. return filepath.Join(setting.RepoRootPath, strings.ToLower(userName))
  749. }
  750. func GetUserByKeyID(keyID int64) (*User, error) {
  751. user := new(User)
  752. has, err := x.SQL("SELECT a.* FROM `user` AS a, public_key AS b WHERE a.id = b.owner_id AND b.id=?", keyID).Get(user)
  753. if err != nil {
  754. return nil, err
  755. } else if !has {
  756. return nil, errors.UserNotKeyOwner{keyID}
  757. }
  758. return user, nil
  759. }
  760. func getUserByID(e Engine, id int64) (*User, error) {
  761. u := new(User)
  762. has, err := e.ID(id).Get(u)
  763. if err != nil {
  764. return nil, err
  765. } else if !has {
  766. return nil, errors.UserNotExist{id, ""}
  767. }
  768. return u, nil
  769. }
  770. // GetUserByID returns the user object by given ID if exists.
  771. func GetUserByID(id int64) (*User, error) {
  772. return getUserByID(x, id)
  773. }
  774. // GetAssigneeByID returns the user with write access of repository by given ID.
  775. func GetAssigneeByID(repo *Repository, userID int64) (*User, error) {
  776. has, err := HasAccess(userID, repo, ACCESS_MODE_READ)
  777. if err != nil {
  778. return nil, err
  779. } else if !has {
  780. return nil, errors.UserNotExist{userID, ""}
  781. }
  782. return GetUserByID(userID)
  783. }
  784. // GetUserByName returns a user by given name.
  785. func GetUserByName(name string) (*User, error) {
  786. if len(name) == 0 {
  787. return nil, errors.UserNotExist{0, name}
  788. }
  789. u := &User{LowerName: strings.ToLower(name)}
  790. has, err := x.Get(u)
  791. if err != nil {
  792. return nil, err
  793. } else if !has {
  794. return nil, errors.UserNotExist{0, name}
  795. }
  796. return u, nil
  797. }
  798. // GetUserEmailsByNames returns a list of e-mails corresponds to names.
  799. func GetUserEmailsByNames(names []string) []string {
  800. mails := make([]string, 0, len(names))
  801. for _, name := range names {
  802. u, err := GetUserByName(name)
  803. if err != nil {
  804. continue
  805. }
  806. if u.IsMailable() {
  807. mails = append(mails, u.Email)
  808. }
  809. }
  810. return mails
  811. }
  812. // GetUserIDsByNames returns a slice of ids corresponds to names.
  813. func GetUserIDsByNames(names []string) []int64 {
  814. ids := make([]int64, 0, len(names))
  815. for _, name := range names {
  816. u, err := GetUserByName(name)
  817. if err != nil {
  818. continue
  819. }
  820. ids = append(ids, u.ID)
  821. }
  822. return ids
  823. }
  824. // UserCommit represents a commit with validation of user.
  825. type UserCommit struct {
  826. User *User
  827. *git.Commit
  828. }
  829. // ValidateCommitWithEmail chceck if author's e-mail of commit is corresponsind to a user.
  830. func ValidateCommitWithEmail(c *git.Commit) *User {
  831. u, err := GetUserByEmail(c.Author.Email)
  832. if err != nil {
  833. return nil
  834. }
  835. return u
  836. }
  837. // ValidateCommitsWithEmails checks if authors' e-mails of commits are corresponding to users.
  838. func ValidateCommitsWithEmails(oldCommits *list.List) *list.List {
  839. var (
  840. u *User
  841. emails = map[string]*User{}
  842. newCommits = list.New()
  843. e = oldCommits.Front()
  844. )
  845. for e != nil {
  846. c := e.Value.(*git.Commit)
  847. if v, ok := emails[c.Author.Email]; !ok {
  848. u, _ = GetUserByEmail(c.Author.Email)
  849. emails[c.Author.Email] = u
  850. } else {
  851. u = v
  852. }
  853. newCommits.PushBack(UserCommit{
  854. User: u,
  855. Commit: c,
  856. })
  857. e = e.Next()
  858. }
  859. return newCommits
  860. }
  861. // GetUserByEmail returns the user object by given e-mail if exists.
  862. func GetUserByEmail(email string) (*User, error) {
  863. if len(email) == 0 {
  864. return nil, errors.UserNotExist{0, "email"}
  865. }
  866. email = strings.ToLower(email)
  867. // First try to find the user by primary email
  868. user := &User{Email: email}
  869. has, err := x.Get(user)
  870. if err != nil {
  871. return nil, err
  872. }
  873. if has {
  874. return user, nil
  875. }
  876. // Otherwise, check in alternative list for activated email addresses
  877. emailAddress := &EmailAddress{Email: email, IsActivated: true}
  878. has, err = x.Get(emailAddress)
  879. if err != nil {
  880. return nil, err
  881. }
  882. if has {
  883. return GetUserByID(emailAddress.UID)
  884. }
  885. return nil, errors.UserNotExist{0, email}
  886. }
  887. type SearchUserOptions struct {
  888. Keyword string
  889. Type UserType
  890. OrderBy string
  891. Page int
  892. PageSize int // Can be smaller than or equal to setting.UI.ExplorePagingNum
  893. }
  894. // SearchUserByName takes keyword and part of user name to search,
  895. // it returns results in given range and number of total results.
  896. func SearchUserByName(opts *SearchUserOptions) (users []*User, _ int64, _ error) {
  897. if len(opts.Keyword) == 0 {
  898. return users, 0, nil
  899. }
  900. opts.Keyword = strings.ToLower(opts.Keyword)
  901. if opts.PageSize <= 0 || opts.PageSize > setting.UI.ExplorePagingNum {
  902. opts.PageSize = setting.UI.ExplorePagingNum
  903. }
  904. if opts.Page <= 0 {
  905. opts.Page = 1
  906. }
  907. searchQuery := "%" + opts.Keyword + "%"
  908. users = make([]*User, 0, opts.PageSize)
  909. // Append conditions
  910. sess := x.Where("LOWER(lower_name) LIKE ?", searchQuery).
  911. Or("LOWER(full_name) LIKE ?", searchQuery).
  912. And("type = ?", opts.Type)
  913. var countSess xorm.Session
  914. countSess = *sess
  915. count, err := countSess.Count(new(User))
  916. if err != nil {
  917. return nil, 0, fmt.Errorf("Count: %v", err)
  918. }
  919. if len(opts.OrderBy) > 0 {
  920. sess.OrderBy(opts.OrderBy)
  921. }
  922. return users, count, sess.Limit(opts.PageSize, (opts.Page-1)*opts.PageSize).Find(&users)
  923. }
  924. // ___________ .__ .__
  925. // \_ _____/___ | | | | ______ _ __
  926. // | __)/ _ \| | | | / _ \ \/ \/ /
  927. // | \( <_> ) |_| |_( <_> ) /
  928. // \___ / \____/|____/____/\____/ \/\_/
  929. // \/
  930. // Follow represents relations of user and his/her followers.
  931. type Follow struct {
  932. ID int64
  933. UserID int64 `xorm:"UNIQUE(follow)"`
  934. FollowID int64 `xorm:"UNIQUE(follow)"`
  935. }
  936. func IsFollowing(userID, followID int64) bool {
  937. has, _ := x.Get(&Follow{UserID: userID, FollowID: followID})
  938. return has
  939. }
  940. // FollowUser marks someone be another's follower.
  941. func FollowUser(userID, followID int64) (err error) {
  942. if userID == followID || IsFollowing(userID, followID) {
  943. return nil
  944. }
  945. sess := x.NewSession()
  946. defer sess.Close()
  947. if err = sess.Begin(); err != nil {
  948. return err
  949. }
  950. if _, err = sess.Insert(&Follow{UserID: userID, FollowID: followID}); err != nil {
  951. return err
  952. }
  953. if _, err = sess.Exec("UPDATE `user` SET num_followers = num_followers + 1 WHERE id = ?", followID); err != nil {
  954. return err
  955. }
  956. if _, err = sess.Exec("UPDATE `user` SET num_following = num_following + 1 WHERE id = ?", userID); err != nil {
  957. return err
  958. }
  959. return sess.Commit()
  960. }
  961. // UnfollowUser unmarks someone be another's follower.
  962. func UnfollowUser(userID, followID int64) (err error) {
  963. if userID == followID || !IsFollowing(userID, followID) {
  964. return nil
  965. }
  966. sess := x.NewSession()
  967. defer sess.Close()
  968. if err = sess.Begin(); err != nil {
  969. return err
  970. }
  971. if _, err = sess.Delete(&Follow{UserID: userID, FollowID: followID}); err != nil {
  972. return err
  973. }
  974. if _, err = sess.Exec("UPDATE `user` SET num_followers = num_followers - 1 WHERE id = ?", followID); err != nil {
  975. return err
  976. }
  977. if _, err = sess.Exec("UPDATE `user` SET num_following = num_following - 1 WHERE id = ?", userID); err != nil {
  978. return err
  979. }
  980. return sess.Commit()
  981. }