model.go 17 KB
Newer Older
ale's avatar
ale committed
1
2
3
4
package backend

import (
	"context"
ale's avatar
ale committed
5
6
7
	"fmt"
	"math/rand"
	"strconv"
ale's avatar
ale committed
8
9
10
	"strings"

	ldaputil "git.autistici.org/ai3/go-common/ldap"
11
	"github.com/tstranex/u2f"
ale's avatar
ale committed
12
13
14
15
16
	"gopkg.in/ldap.v2"

	"git.autistici.org/ai3/accountserver"
)

17
18
19
20
const (
	// Names of some well-known LDAP attributes.
	totpSecretLDAPAttr        = "totpSecret"
	preferredLanguageLDAPAttr = "preferredLanguage"
ale's avatar
ale committed
21
22
	recoveryHintLDAPAttr      = "recoverQuestion"
	recoveryResponseLDAPAttr  = "recoverAnswer"
23
24
25
26
	aspLDAPAttr               = "appSpecificPassword"
	storagePublicKeyLDAPAttr  = "storagePublicKey"
	storagePrivateKeyLDAPAttr = "storageEncryptedSecretKey"
	passwordLDAPAttr          = "userPassword"
27
	u2fRegistrationsLDAPAttr  = "u2fRegistration"
ale's avatar
ale committed
28
	uidNumberLDAPAttr         = "uidNumber"
29
30
)

31
// backend is the interface to an LDAP-backed user database.
ale's avatar
ale committed
32
33
34
35
36
//
// We keep a set of LDAP queries for each resource type, each having a
// "resource" query to return a specific resource belonging to a user,
// and a "presence" query that checks for existence of a resource for
// all users.
37
type backend struct {
ale's avatar
ale committed
38
	conn                ldapConn
ale's avatar
ale committed
39
	baseDN              string
40
41
	userQuery           *queryTemplate
	userResourceQueries []*queryTemplate
ale's avatar
ale committed
42
	resources           *resourceRegistry
ale's avatar
ale committed
43
44
45

	// Range for new user IDs.
	minUID, maxUID int
ale's avatar
ale committed
46
47
}

ale's avatar
ale committed
48
49
50
51
52
const (
	defaultMinUID = 10000
	defaultMaxUID = 1000000
)

ale's avatar
ale committed
53
54
// backendTX holds the business logic (that runs within a single
// transaction).
55
56
57
58
59
type backendTX struct {
	*ldapTX
	backend *backend
}

ale's avatar
ale committed
60
61
const ldapPoolSize = 20

62
63
64
65
66
67
68
func (b *backend) NewTransaction() (accountserver.TX, error) {
	return &backendTX{
		ldapTX:  newLDAPTX(b.conn),
		backend: b,
	}, nil
}

ale's avatar
ale committed
69
70
// NewLDAPBackend initializes an LDAPBackend object with the given LDAP
// connection pool.
71
func NewLDAPBackend(uri, bindDN, bindPw, base string) (accountserver.Backend, error) {
ale's avatar
ale committed
72
73
74
75
	pool, err := ldaputil.NewConnectionPool(uri, bindDN, bindPw, ldapPoolSize)
	if err != nil {
		return nil, err
	}
76
77
	return newLDAPBackendWithConn(pool, base)
}
ale's avatar
ale committed
78

79
func newLDAPBackendWithConn(conn ldapConn, base string) (*backend, error) {
ale's avatar
ale committed
80
81
82
83
84
85
86
87
	rsrc := newResourceRegistry()
	rsrc.register(accountserver.ResourceTypeEmail, &emailResourceHandler{baseDN: base})
	rsrc.register(accountserver.ResourceTypeMailingList, &mailingListResourceHandler{baseDN: base})
	rsrc.register(accountserver.ResourceTypeDAV, &webdavResourceHandler{baseDN: base})
	rsrc.register(accountserver.ResourceTypeWebsite, &websiteResourceHandler{baseDN: base})
	rsrc.register(accountserver.ResourceTypeDomain, &domainResourceHandler{baseDN: base})
	rsrc.register(accountserver.ResourceTypeDatabase, &databaseResourceHandler{baseDN: base})

88
	return &backend{
ale's avatar
ale committed
89
90
		conn:   conn,
		baseDN: base,
91
92
93
94
95
96
		userQuery: &queryTemplate{
			Base:   joinDN("uid=${user}", "ou=People", base),
			Filter: "(objectClass=*)",
			Scope:  ldap.ScopeBaseObject,
		},
		userResourceQueries: []*queryTemplate{
ale's avatar
ale committed
97
			// Find all resources that are children of the main uid object.
98
99
100
101
			&queryTemplate{
				Base:  joinDN("uid=${user}", "ou=People", base),
				Scope: ldap.ScopeWholeSubtree,
			},
ale's avatar
ale committed
102
			// Find mailing lists, which are nested under a different root.
103
104
			&queryTemplate{
				Base:   joinDN("ou=Lists", base),
ale's avatar
ale committed
105
				Filter: "(&(objectClass=mailingList)(listOwner=${user}))",
106
107
				Scope:  ldap.ScopeSingleLevel,
			},
ale's avatar
ale committed
108
		},
ale's avatar
ale committed
109
		resources: rsrc,
ale's avatar
ale committed
110
111
		minUID:    defaultMinUID,
		maxUID:    defaultMaxUID,
ale's avatar
ale committed
112
	}, nil
ale's avatar
ale committed
113
114
115
}

func newUser(entry *ldap.Entry) (*accountserver.User, error) {
116
117
118
119
120
121
122
123
	// Note that some user-level attributes related to
	// authentication are stored on the uid= object, while others
	// are on the email= object. We set the latter in the GetUser
	// function later.
	//
	// The case of password recovery attributes is more complex:
	// the current schema has those on email=, but we'd like to
	// move them to uid=, so we currently have to support both.
ale's avatar
ale committed
124
	uidNumber, _ := strconv.Atoi(entry.GetAttributeValue(uidNumberLDAPAttr))
ale's avatar
ale committed
125
	user := &accountserver.User{
126
127
		Name:                 entry.GetAttributeValue("uid"),
		Lang:                 entry.GetAttributeValue(preferredLanguageLDAPAttr),
ale's avatar
ale committed
128
		UID:                  uidNumber,
129
130
		PasswordRecoveryHint: entry.GetAttributeValue(recoveryHintLDAPAttr),
		U2FRegistrations:     decodeU2FRegistrations(entry.GetAttributeValues(u2fRegistrationsLDAPAttr)),
131
		HasOTP:               entry.GetAttributeValue(totpSecretLDAPAttr) != "",
ale's avatar
ale committed
132
	}
133
134

	// The user has 2FA enabled if it has a TOTP secret or U2F keys.
135
	user.Has2FA = (user.HasOTP || (len(user.U2FRegistrations) > 0))
136

ale's avatar
ale committed
137
138
139
140
141
142
	if user.Lang == "" {
		user.Lang = "en"
	}
	return user, nil
}

ale's avatar
ale committed
143
144
145
146
147
148
func userToLDAP(user *accountserver.User) (attrs []ldap.PartialAttribute) {
	// Most attributes are read-only and have specialized methods to set them.
	attrs = append(attrs, []ldap.PartialAttribute{
		{Type: "objectClass", Vals: []string{"top", "person", "posixAccount", "shadowAccount", "organizationalPerson", "inetOrgPerson", "totpAccount"}},
		{Type: "uid", Vals: s2l(user.Name)},
		{Type: "cn", Vals: s2l(user.Name)},
ale's avatar
ale committed
149
		{Type: uidNumberLDAPAttr, Vals: s2l(strconv.Itoa(user.UID))},
ale's avatar
ale committed
150
151
152
153
154
155
156
157
158
		{Type: "givenName", Vals: []string{"Private"}},
		{Type: "sn", Vals: []string{"Private"}},
		{Type: "gecos", Vals: s2l(user.Name)},
		{Type: "loginShell", Vals: []string{"/bin/false"}},
		{Type: "homeDirectory", Vals: []string{"/var/empty"}},
		{Type: "shadowLastChange", Vals: []string{"12345"}},
		{Type: "shadowWarning", Vals: []string{"7"}},
		{Type: "shadowMax", Vals: []string{"99999"}},
		{Type: preferredLanguageLDAPAttr, Vals: s2l(user.Lang)},
159
		{Type: u2fRegistrationsLDAPAttr, Vals: encodeU2FRegistrations(user.U2FRegistrations)},
ale's avatar
ale committed
160
161
162
163
	}...)
	return
}

164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
func decodeU2FRegistration(enc string) (*u2f.Registration, error) {
	var reg u2f.Registration
	if err := reg.UnmarshalBinary([]byte(enc)); err != nil {
		return nil, err
	}
	return &reg, nil
}

func encodeU2FRegistration(r *u2f.Registration) string {
	b, _ := r.MarshalBinary()
	return string(b)
}

func decodeU2FRegistrations(encRegs []string) []*u2f.Registration {
	var out []*u2f.Registration
	for _, enc := range encRegs {
		if r, err := decodeU2FRegistration(enc); err == nil {
			out = append(out, r)
		}
	}
	return out
}

func encodeU2FRegistrations(regs []*u2f.Registration) []string {
	var out []string
	for _, r := range regs {
		out = append(out, encodeU2FRegistration(r))
	}
	return out
}

ale's avatar
ale committed
195
196
func (tx *backendTX) getUserDN(user *accountserver.User) string {
	return joinDN("uid="+user.Name, "ou=People", tx.backend.baseDN)
ale's avatar
ale committed
197
198
}

ale's avatar
ale committed
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
// CreateUser creates a new user.
func (tx *backendTX) CreateUser(ctx context.Context, user *accountserver.User) error {
	dn := tx.getUserDN(user)

	tx.create(dn)
	for _, attr := range userToLDAP(user) {
		tx.setAttr(dn, attr.Type, attr.Vals...)
	}

	// Create all resources.
	for _, r := range user.Resources {
		if err := tx.CreateResource(ctx, r); err != nil {
			return err
		}
	}

	return nil
}

218
219
220
221
222
223
224
225
226
// UpdateUser updates values for the user only (not the resources).
func (tx *backendTX) UpdateUser(ctx context.Context, user *accountserver.User) error {
	dn := tx.getUserDN(user)
	for _, attr := range userToLDAP(user) {
		tx.setAttr(dn, attr.Type, attr.Vals...)
	}
	return nil
}

ale's avatar
ale committed
227
// GetUser returns a user.
228
func (tx *backendTX) GetUser(ctx context.Context, username string) (*accountserver.User, error) {
ale's avatar
ale committed
229
230
	// First of all, find the main user object, and just that one.
	vars := map[string]string{"user": username}
231
	result, err := tx.search(ctx, tx.backend.userQuery.query(vars))
ale's avatar
ale committed
232
233
234
235
236
237
	if err != nil {
		if ldap.IsErrorWithCode(err, ldap.LDAPResultNoSuchObject) {
			return nil, nil
		}
		return nil, err
	}
238
239
240
	if len(result.Entries) == 0 {
		return nil, nil
	}
ale's avatar
ale committed
241
242
243
244
245
246
247
248
249
250

	user, err := newUser(result.Entries[0])
	if err != nil {
		return nil, err
	}

	// Now run the resource queries, and accumulate results on the User
	// object we just created.
	// TODO: parallelize.
	// TODO: add support for non-LDAP resource queries.
251
252
	for _, tpl := range tx.backend.userResourceQueries {
		result, err = tx.search(ctx, tpl.query(vars))
ale's avatar
ale committed
253
254
255
256
257
258
259
260
261
		if err != nil {
			continue
		}

		for _, entry := range result.Entries {
			// Some user-level attributes are actually stored on the email
			// object, a shortcoming of the legacy A/I database model. Set
			// them on the main User object.
			if isObjectClass(entry, "virtualMailUser") {
262
263
264
				if s := entry.GetAttributeValue(recoveryHintLDAPAttr); s != "" {
					user.PasswordRecoveryHint = s
				}
265
266
				user.AppSpecificPasswords = getASPInfo(decodeAppSpecificPasswords(entry.GetAttributeValues(aspLDAPAttr)))
				user.HasEncryptionKeys = (entry.GetAttributeValue(storagePublicKeyLDAPAttr) != "")
ale's avatar
ale committed
267
			}
ale's avatar
ale committed
268

ale's avatar
ale committed
269
			// Parse the resource and add it to the User.
ale's avatar
ale committed
270
			if r, err := tx.backend.resources.FromLDAP(entry); err == nil {
ale's avatar
ale committed
271
272
273
274
275
276
277
278
				user.Resources = append(user.Resources, r)
			}
		}
	}

	return user, nil
}

279
func (tx *backendTX) SetUserPassword(ctx context.Context, user *accountserver.User, encryptedPassword string) error {
280
281
282
283
284
285
	dn := tx.getUserDN(user)
	tx.setAttr(dn, passwordLDAPAttr, encryptedPassword)
	for _, r := range user.GetResourcesByType(accountserver.ResourceTypeEmail) {
		dn, _ = tx.backend.resources.GetDN(r.ID)
		tx.setAttr(dn, passwordLDAPAttr, encryptedPassword)
	}
286
	return nil
ale's avatar
ale committed
287
288
}

289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
func (tx *backendTX) GetUserEncryptedPassword(ctx context.Context, user *accountserver.User) string {
	values := tx.readAttributeValues(ctx, tx.getUserDN(user), passwordLDAPAttr)
	if len(values) > 0 {
		// Remove legacy LDAP encryption prefix.
		return strings.TrimPrefix(values[0], "{crypt}")
	}
	return ""
}

func (tx *backendTX) GetUserRecoveryEncryptedPassword(ctx context.Context, user *accountserver.User) string {
	values := tx.readAttributeValues(ctx, tx.getUserDN(user), recoveryResponseLDAPAttr)
	if len(values) > 0 {
		// Remove legacy LDAP encryption prefix.
		return strings.TrimPrefix(values[0], "{crypt}")
	}
	return ""
}

ale's avatar
ale committed
307
func (tx *backendTX) SetPasswordRecoveryHint(ctx context.Context, user *accountserver.User, hint, response string) error {
308
309
	// Write the password recovery attributes on the uid= object,
	// as per the new schema.
ale's avatar
ale committed
310
311
312
313
314
315
	dn := tx.getUserDN(user)
	tx.setAttr(dn, recoveryHintLDAPAttr, hint)
	tx.setAttr(dn, recoveryResponseLDAPAttr, response)
	return nil
}

316
func (tx *backendTX) GetUserEncryptionKeys(ctx context.Context, user *accountserver.User) ([]*accountserver.UserEncryptionKey, error) {
317
318
319
	r := user.GetSingleResourceByType(accountserver.ResourceTypeEmail)
	dn, _ := tx.backend.resources.GetDN(r.ID)
	rawKeys := tx.readAttributeValues(ctx, dn, storagePrivateKeyLDAPAttr)
320
	return decodeUserEncryptionKeys(rawKeys), nil
ale's avatar
ale committed
321
322
}

323
func (tx *backendTX) SetUserEncryptionKeys(ctx context.Context, user *accountserver.User, keys []*accountserver.UserEncryptionKey) error {
324
	encKeys := encodeUserEncryptionKeys(keys)
325
326
327
328
	for _, r := range user.GetResourcesByType(accountserver.ResourceTypeEmail) {
		dn, _ := tx.backend.resources.GetDN(r.ID)
		tx.setAttr(dn, storagePrivateKeyLDAPAttr, encKeys...)
	}
329
	return nil
ale's avatar
ale committed
330
331
}

332
func (tx *backendTX) SetUserEncryptionPublicKey(ctx context.Context, user *accountserver.User, pub []byte) error {
333
334
335
336
	for _, r := range user.GetResourcesByType(accountserver.ResourceTypeEmail) {
		dn, _ := tx.backend.resources.GetDN(r.ID)
		tx.setAttr(dn, storagePublicKeyLDAPAttr, string(pub))
	}
337
338
339
340
341
342
343
344
345
	return nil
}

func excludeASPFromList(asps []*appSpecificPassword, id string) []*appSpecificPassword {
	var out []*appSpecificPassword
	for _, asp := range asps {
		if asp.ID != id {
			out = append(out, asp)
		}
346
	}
347
	return out
348
349
}

350
351
func (tx *backendTX) setASPOnResource(ctx context.Context, r *accountserver.Resource, info *accountserver.AppSpecificPasswordInfo, encryptedPassword string) {
	dn, _ := tx.backend.resources.GetDN(r.ID)
ale's avatar
ale committed
352

353
	// Obtain the full list of ASPs from the backend and replace/append the new one.
354
	asps := decodeAppSpecificPasswords(tx.readAttributeValues(ctx, dn, aspLDAPAttr))
355
356
	asps = append(excludeASPFromList(asps, info.ID), newAppSpecificPassword(*info, encryptedPassword))
	outASPs := encodeAppSpecificPasswords(asps)
357
	tx.setAttr(dn, aspLDAPAttr, outASPs...)
ale's avatar
ale committed
358
359
}

360
361
362
func (tx *backendTX) SetApplicationSpecificPassword(ctx context.Context, user *accountserver.User, info *accountserver.AppSpecificPasswordInfo, encryptedPassword string) error {
	for _, r := range user.GetResourcesByType(accountserver.ResourceTypeEmail) {
		tx.setASPOnResource(ctx, r, info, encryptedPassword)
ale's avatar
ale committed
363
	}
364
365
	return nil
}
ale's avatar
ale committed
366

367
368
369
func (tx *backendTX) deleteASPOnResource(ctx context.Context, r *accountserver.Resource, id string) {
	dn, _ := tx.backend.resources.GetDN(r.ID)
	asps := decodeAppSpecificPasswords(tx.readAttributeValues(ctx, dn, aspLDAPAttr))
370
371
	asps = excludeASPFromList(asps, id)
	outASPs := encodeAppSpecificPasswords(asps)
372
373
	tx.setAttr(dn, aspLDAPAttr, outASPs...)
}
ale's avatar
ale committed
374

375
376
377
378
func (tx *backendTX) DeleteApplicationSpecificPassword(ctx context.Context, user *accountserver.User, id string) error {
	for _, r := range user.GetResourcesByType(accountserver.ResourceTypeEmail) {
		tx.deleteASPOnResource(ctx, r, id)
	}
379
	return nil
ale's avatar
ale committed
380
381
}

382
func (tx *backendTX) SetUserTOTPSecret(ctx context.Context, user *accountserver.User, secret string) error {
383
	tx.setAttr(tx.getUserDN(user), totpSecretLDAPAttr, secret)
384
	return nil
ale's avatar
ale committed
385
386
}

387
func (tx *backendTX) DeleteUserTOTPSecret(ctx context.Context, user *accountserver.User) error {
388
	tx.setAttr(tx.getUserDN(user), totpSecretLDAPAttr)
389
	return nil
ale's avatar
ale committed
390
391
}

392
func (tx *backendTX) SetResourcePassword(ctx context.Context, r *accountserver.Resource, encryptedPassword string) error {
ale's avatar
ale committed
393
	dn, _ := tx.backend.resources.GetDN(r.ID)
394
	tx.setAttr(dn, passwordLDAPAttr, encryptedPassword)
395
	return nil
ale's avatar
ale committed
396
397
}

ale's avatar
ale committed
398
func (tx *backendTX) hasResource(ctx context.Context, resourceType, resourceName string) (bool, error) {
399
	tpl, err := tx.backend.resources.SearchQuery(resourceType)
ale's avatar
ale committed
400
401
	if err != nil {
		return false, err
ale's avatar
ale committed
402
403
404
	}

	// Make a quick LDAP search that only fetches the DN attribute.
405
406
	tpl.Attrs = []string{"dn"}
	result, err := tx.search(ctx, tpl.query(map[string]string{
ale's avatar
ale committed
407
408
		"resource": resourceName,
		"type":     resourceType,
409
	}))
ale's avatar
ale committed
410
411
412
413
414
415
416
417
418
419
420
421
422
	if err != nil {
		if ldap.IsErrorWithCode(err, ldap.LDAPResultNoSuchObject) {
			return false, nil
		}
		return false, err
	}
	if len(result.Entries) == 0 {
		return false, nil
	}
	return true, nil
}

// HasAnyResource returns true if any of the specified resources exists.
ale's avatar
ale committed
423
424
425
func (tx *backendTX) HasAnyResource(ctx context.Context, resourceIDs []accountserver.FindResourceRequest) (bool, error) {
	for _, req := range resourceIDs {
		has, err := tx.hasResource(ctx, req.Type, req.Name)
ale's avatar
ale committed
426
427
428
429
430
431
432
		if err != nil || has {
			return has, err
		}
	}
	return false, nil
}

433
// GetResource returns a ResourceWrapper, as part of a read-modify-update transaction.
434
func (tx *backendTX) GetResource(ctx context.Context, rsrcID accountserver.ResourceID) (*accountserver.Resource, error) {
ale's avatar
ale committed
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
	// From the resource ID we can obtain the DN, and fetch it
	// straight from LDAP without even doing a real search.
	dn, err := tx.backend.resources.GetDN(rsrcID)
	if err != nil {
		return nil, err
	}

	// This is just a 'point' search.
	req := ldap.NewSearchRequest(
		dn,
		ldap.ScopeBaseObject,
		ldap.NeverDerefAliases,
		0,
		0,
		false,
		"(objectClass=*)",
		nil,
		nil,
	)

	result, err := tx.search(ctx, req)
456
457
458
459
460
461
462
	if err != nil {
		if ldap.IsErrorWithCode(err, ldap.LDAPResultNoSuchObject) {
			return nil, nil
		}
		return nil, err
	}

ale's avatar
ale committed
463
464
	// We know the resource type so we don't have to guess.
	return tx.backend.resources.FromLDAPWithType(rsrcID.Type(), result.Entries[0])
465
466
}

ale's avatar
ale committed
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
// CreateResource creates a new LDAP-backed resource object.
func (tx *backendTX) CreateResource(ctx context.Context, r *accountserver.Resource) error {
	dn, err := tx.backend.resources.GetDN(r.ID)
	if err != nil {
		return err
	}

	tx.create(dn)
	for _, attr := range tx.backend.resources.ToLDAP(r) {
		tx.setAttr(dn, attr.Type, attr.Vals...)
	}

	return nil
}

482
// UpdateResource updates a LDAP-backed resource that was obtained by a previous GetResource call.
483
func (tx *backendTX) UpdateResource(ctx context.Context, r *accountserver.Resource) error {
ale's avatar
ale committed
484
485
486
487
	dn, err := tx.backend.resources.GetDN(r.ID)
	if err != nil {
		return err
	}
488

489
490
	// We can simply dump all attribute/value pairs and let the
	// code in ldapTX do the work of finding the differences.
ale's avatar
ale committed
491
	for _, attr := range tx.backend.resources.ToLDAP(r) {
492
		tx.setAttr(dn, attr.Type, attr.Vals...)
493
494
	}

495
	return nil
496
497
}

ale's avatar
ale committed
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
// NextUID returns an available user ID (uidNumber). It does so
// without keeping state by just guessing random UIDs in the
// minUID-maxUID range, and checking if they are available (so it's
// best to keep the range largely underutilized).
func (tx *backendTX) NextUID(ctx context.Context) (uid int, err error) {
	// Won't actually run forever, at some point the context will expire.
	var ok bool
	for !ok && err == nil {
		uid = tx.backend.minUID + rand.Intn(tx.backend.maxUID-tx.backend.minUID)
		ok, err = tx.isUIDAvailable(ctx, uid)
	}
	return
}

func (tx *backendTX) isUIDAvailable(ctx context.Context, uid int) (bool, error) {
	// Try to make this query lightweight: ask for no attributes,
	// use a size limit of 1 and treat "Size Limit Exceeded"
	// errors as a successful result.
	result, err := tx.search(ctx, ldap.NewSearchRequest(
		tx.backend.baseDN,
		ldap.ScopeWholeSubtree,
		ldap.NeverDerefAliases,
		1, // just one result is enough
		0,
		false,
		fmt.Sprintf("(uidNumber=%d)", uid),
		[]string{"dn"},
		nil,
	))
	if err != nil {
		if ldap.IsErrorWithCode(err, ldap.LDAPResultSizeLimitExceeded) {
			return false, nil
		}
		return false, err
	}
	if len(result.Entries) > 0 {
		return false, nil
	}
	return true, nil
}