Files
zeekay e71dfbc4f3 SuperAdmin is the host boundary's verdict, never the org a token names
util.IsSuperAdmin compared the resolved user's owner to "admin", a
second predicate beside the one the host boundary decides, and the two
disagreed. An admin-org application (no orgs, owner claim admin), an
admin-org person's sk- key, and an org spelled "admin " (the parse
trimmed orgs[0]) were each SuperAdmin here and refused by the boundary.

The host now states the verdict: object.SetSuper, which hanzo-inc/cloud
fills with principal.Super, the X-User-IsAdmin its boundary deletes from
every request and re-mints from authz.Claims.Sudo. Every HTTP seam that
turns a token into a principal goes through object.Verify, which stamps
it on iam.User.Sudo (never decoded); IsSuperAdmin and ScopeOwner read
that and compare no org. util.AdminOrg is gone; the rows that are the
platform's own are named by authz.AdminOrg.

With no host there is no SuperAdmin, and a ZAP door is not the host:
target deletes X-User-IsAdmin from a ZAP-built request, and zapPrincipal
carries a verdict only when the HTTP bridge vouched for the request it
was handed. A key is never the SuperAdmin, as at the host.
2026-10-18 22:21:43 -07:00

372 lines
16 KiB
Go

// Copyright 2023-2026 Hanzo AI Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package iam
// User mirrors the Hanzo IAM server's User JSON model. The FULL field set is
// reproduced deliberately (not a slim projection): object/redact.go reflects
// over every field by its json tag as a fail-secure secret-redaction control,
// and it must see every credential field (password*, *Secret, *Token, totp,
// social-login ids, custom1..10, …) to zero it before a user is returned to a
// client. A slim User would silently narrow that control and break its test.
// The json tags are therefore load-bearing and match the server verbatim; the
// server's xorm/db tags are dropped (ai has no ORM).
type User struct {
Owner string `json:"owner"`
Name string `json:"name"`
CreatedTime string `json:"createdTime"`
UpdatedTime string `json:"updatedTime"`
DeletedTime string `json:"deletedTime"`
Id string `json:"id"`
ExternalId string `json:"externalId"`
Type string `json:"type"`
Password string `json:"password"`
PasswordSalt string `json:"passwordSalt"`
PasswordType string `json:"passwordType"`
DisplayName string `json:"displayName"`
FirstName string `json:"firstName"`
LastName string `json:"lastName"`
Avatar string `json:"avatar"`
AvatarType string `json:"avatarType"`
PermanentAvatar string `json:"permanentAvatar"`
Email string `json:"email"`
EmailVerified bool `json:"emailVerified"`
Phone string `json:"phone"`
CountryCode string `json:"countryCode"`
Region string `json:"region"`
Location string `json:"location"`
Address []string `json:"address"`
Addresses []*Address `json:"addresses"`
Affiliation string `json:"affiliation"`
Title string `json:"title"`
IdCardType string `json:"idCardType"`
IdCard string `json:"idCard"`
RealName string `json:"realName"`
IsVerified bool `json:"isVerified"`
Homepage string `json:"homepage"`
Bio string `json:"bio"`
Tag string `json:"tag"`
Language string `json:"language"`
Gender string `json:"gender"`
Birthday string `json:"birthday"`
Education string `json:"education"`
Score int `json:"score"`
Karma int `json:"karma"`
Ranking int `json:"ranking"`
Balance float64 `json:"balance"`
BalanceCredit float64 `json:"balanceCredit"`
Currency string `json:"currency"`
BalanceCurrency string `json:"balanceCurrency"`
IsDefaultAvatar bool `json:"isDefaultAvatar"`
IsOnline bool `json:"isOnline"`
IsAdmin bool `json:"isAdmin"`
IsForbidden bool `json:"isForbidden"`
IsDeleted bool `json:"isDeleted"`
SignupApplication string `json:"signupApplication"`
Hash string `json:"hash"`
PreHash string `json:"preHash"`
RegisterType string `json:"registerType"`
RegisterSource string `json:"registerSource"`
AccessKey string `json:"accessKey"`
AccessSecret string `json:"accessSecret"`
AccessToken string `json:"accessToken"`
OriginalToken string `json:"originalToken"`
OriginalRefreshToken string `json:"originalRefreshToken"`
CreatedIp string `json:"createdIp"`
LastSigninTime string `json:"lastSigninTime"`
LastSigninIp string `json:"lastSigninIp"`
GitHub string `json:"github"`
Google string `json:"google"`
QQ string `json:"qq"`
WeChat string `json:"wechat"`
Facebook string `json:"facebook"`
DingTalk string `json:"dingtalk"`
Weibo string `json:"weibo"`
Gitee string `json:"gitee"`
LinkedIn string `json:"linkedin"`
Wecom string `json:"wecom"`
Lark string `json:"lark"`
Gitlab string `json:"gitlab"`
Adfs string `json:"adfs"`
Baidu string `json:"baidu"`
Alipay string `json:"alipay"`
Infoflow string `json:"infoflow"`
Apple string `json:"apple"`
AzureAD string `json:"azuread"`
AzureADB2c string `json:"azureadb2c"`
Slack string `json:"slack"`
Steam string `json:"steam"`
Bilibili string `json:"bilibili"`
Okta string `json:"okta"`
Douyin string `json:"douyin"`
Kwai string `json:"kwai"`
Line string `json:"line"`
Amazon string `json:"amazon"`
Auth0 string `json:"auth0"`
BattleNet string `json:"battlenet"`
Bitbucket string `json:"bitbucket"`
Box string `json:"box"`
CloudFoundry string `json:"cloudfoundry"`
Dailymotion string `json:"dailymotion"`
Deezer string `json:"deezer"`
DigitalOcean string `json:"digitalocean"`
Discord string `json:"discord"`
Dropbox string `json:"dropbox"`
EveOnline string `json:"eveonline"`
Fitbit string `json:"fitbit"`
Gitea string `json:"gitea"`
Heroku string `json:"heroku"`
InfluxCloud string `json:"influxcloud"`
Instagram string `json:"instagram"`
Intercom string `json:"intercom"`
Kakao string `json:"kakao"`
Lastfm string `json:"lastfm"`
Mailru string `json:"mailru"`
Meetup string `json:"meetup"`
MicrosoftOnline string `json:"microsoftonline"`
Naver string `json:"naver"`
Nextcloud string `json:"nextcloud"`
OneDrive string `json:"onedrive"`
Oura string `json:"oura"`
Patreon string `json:"patreon"`
Paypal string `json:"paypal"`
SalesForce string `json:"salesforce"`
Shopify string `json:"shopify"`
Soundcloud string `json:"soundcloud"`
Spotify string `json:"spotify"`
Strava string `json:"strava"`
Stripe string `json:"stripe"`
TikTok string `json:"tiktok"`
Tumblr string `json:"tumblr"`
Twitch string `json:"twitch"`
Twitter string `json:"twitter"`
Typetalk string `json:"typetalk"`
Uber string `json:"uber"`
VK string `json:"vk"`
Wepay string `json:"wepay"`
Xero string `json:"xero"`
Yahoo string `json:"yahoo"`
Yammer string `json:"yammer"`
Yandex string `json:"yandex"`
Zoom string `json:"zoom"`
Custom string `json:"custom"`
Custom2 string `json:"custom2"`
Custom3 string `json:"custom3"`
Custom4 string `json:"custom4"`
Custom5 string `json:"custom5"`
Custom6 string `json:"custom6"`
Custom7 string `json:"custom7"`
Custom8 string `json:"custom8"`
Custom9 string `json:"custom9"`
Custom10 string `json:"custom10"`
PreferredMfaType string `json:"preferredMfaType"`
RecoveryCodes []string `json:"recoveryCodes"`
TotpSecret string `json:"totpSecret"`
MfaPhoneEnabled bool `json:"mfaPhoneEnabled"`
MfaEmailEnabled bool `json:"mfaEmailEnabled"`
MfaRadiusEnabled bool `json:"mfaRadiusEnabled"`
MfaRadiusUsername string `json:"mfaRadiusUsername"`
MfaRadiusProvider string `json:"mfaRadiusProvider"`
MfaPushEnabled bool `json:"mfaPushEnabled"`
MfaPushReceiver string `json:"mfaPushReceiver"`
MfaPushProvider string `json:"mfaPushProvider"`
MultiFactorAuths []*MfaProps `json:"multiFactorAuths,omitempty"`
Invitation string `json:"invitation"`
InvitationCode string `json:"invitationCode"`
FaceIds []*FaceId `json:"faceIds"`
Cart []ProductInfo `json:"cart"`
Ldap string `json:"ldap"`
Properties map[string]string `json:"properties"`
Roles []*Role `json:"roles"`
Permissions []*Permission `json:"permissions"`
Groups []string `json:"groups"`
LastChangePasswordTime string `json:"lastChangePasswordTime"`
LastSigninWrongTime string `json:"lastSigninWrongTime"`
SigninWrongTimes int `json:"signinWrongTimes"`
ManagedAccounts []ManagedAccount `json:"managedAccounts"`
MfaAccounts []MfaAccount `json:"mfaAccounts"`
MfaItems []*MfaItem `json:"mfaItems"`
MfaRememberDeadline string `json:"mfaRememberDeadline"`
NeedUpdatePassword bool `json:"needUpdatePassword"`
IpWhitelist string `json:"ipWhitelist"`
// BillingAccount is the signed `billing_account` claim: WHO PAYS for this
// credential, stated by IAM at mint time. Wire is "<kind>:<subject>" (e.g.
// "org:acme"); empty when IAM could not attribute one, in which case a reader
// must fall back to Payer's shape rule rather than bill a guess.
//
// It lives HERE, on the identity, and not on the Claims envelope that carries
// it, because every place that spends money holds a *User. When this field sat
// on Claims it was structurally unreachable from 27 of the 28 account.Payer
// call sites, so they all silently billed the shape-rule fallback: an org admin
// paid from their own empty wallet while the company pool sat funded and
// unused, and no layer could report an error because each one was doing exactly
// what it was told. Prefer u.Payer(ledger) over reading this directly.
BillingAccount string `json:"billing_account,omitempty"`
// Sudo is the host boundary's verdict that this request's principal is the
// SuperAdmin (object.Verify, from object.SetSuper). It is never decoded — not
// from a token, an IAM response or a request body — and never derived from the
// org this row names; util.IsSuperAdmin reads it and nothing else does.
Sudo bool `json:"-"`
}
// GetId returns "<owner>/<name>", the IAM user identifier.
func (u *User) GetId() string { return u.Owner + "/" + u.Name }
// Address is one postal address on a User.
type Address struct {
Tag string `json:"tag"`
Line1 string `json:"line1"`
Line2 string `json:"line2"`
City string `json:"city"`
State string `json:"state"`
ZipCode string `json:"zipCode"`
Region string `json:"region"`
}
// MfaProps is one enrolled multi-factor method. Secret/RecoveryCodes are
// credentials and are cleared by object/redact.go before a user is returned.
type MfaProps struct {
Enabled bool `json:"enabled"`
IsPreferred bool `json:"isPreferred"`
MfaType string `json:"mfaType"`
Secret string `json:"secret,omitempty"`
CountryCode string `json:"countryCode,omitempty"`
URL string `json:"url,omitempty"`
RecoveryCodes []string `json:"recoveryCodes,omitempty"`
}
// MfaItem is one required MFA enrollment item.
type MfaItem struct {
Name string `json:"name"`
Rule string `json:"rule"`
}
// MfaAccount is a TOTP account entry (carries a secret key).
type MfaAccount struct {
AccountName string `json:"accountName"`
Issuer string `json:"issuer"`
SecretKey string `json:"secretKey"`
Origin string `json:"origin"`
}
// ManagedAccount is a linked downstream account (carries a password).
type ManagedAccount struct {
Application string `json:"application"`
Username string `json:"username"`
Password string `json:"password"`
SigninUrl string `json:"signinUrl"`
}
// FaceId is enrolled biometric face data.
type FaceId struct {
Name string `json:"name"`
FaceIdData []float64 `json:"faceIdData"`
ImageUrl string `json:"ImageUrl"`
}
// Role is an IAM role reference.
type Role struct {
Owner string `json:"owner"`
Name string `json:"name"`
CreatedTime string `json:"createdTime"`
DisplayName string `json:"displayName"`
Description string `json:"description"`
Users []string `json:"users"`
Groups []string `json:"groups"`
Roles []string `json:"roles"`
Domains []string `json:"domains"`
IsEnabled bool `json:"isEnabled"`
}
// ProductInfo is one line item on a User's cart.
type ProductInfo struct {
Owner string `json:"owner"`
Name string `json:"name"`
DisplayName string `json:"displayName"`
Image string `json:"image,omitempty"`
Detail string `json:"detail,omitempty"`
Price float64 `json:"price"`
Currency string `json:"currency,omitempty"`
IsRecharge bool `json:"isRecharge,omitempty"`
Quantity int `json:"quantity,omitempty"`
PricingName string `json:"pricingName,omitempty"`
PlanName string `json:"planName,omitempty"`
}
// GetUser fetches a single user by name within the client's organization.
func (c *Client) GetUser(name string) (*User, error) {
var user *User
if err := c.get(Ref{Owner: c.OrganizationName, Name: name}.path("users"), nil, &user); err != nil {
return nil, err
}
return user, nil
}
// GetUsers lists all users in the client's organization.
func (c *Client) GetUsers() ([]*User, error) {
var page struct {
Users []*User `json:"users"`
Total int `json:"total"`
}
if err := c.get("users", map[string]string{"owner": c.OrganizationName}, &page); err != nil {
return nil, err
}
return page.Users, nil
}
// UpdateUser writes user back to IAM.
//
// The record is named in the URL like every other one: PUT /v1/iam/users/<owner>/
// <name>. The body still carries the record under `user`, because that is the
// shape of the write — what the record should BECOME — while the address says
// WHICH record, and the address outranks anything the body claims about its own
// identity.
//
// It is a WHOLE-RECORD write, and the caller must hand over a record it read
// rather than one it assembled: every field present replaces what is stored.
// The retired surface took a `columns` list and touched only those, which is
// what the two callers here used to scope a write to `properties`; the native
// route has no such parameter, so the narrowing is gone and only the read the
// caller started from keeps the rest of the record intact.
//
// What a stale copy cannot damage, IAM protects itself: the password digest,
// the key secret, the MFA material, the OIDC subject, the creation stamp and
// the lockout counters are all carried from the stored row and any value in the
// body is ignored. The exposure is the ordinary profile — a display name edited
// after the caller's copy was taken would be written back to its older value.
func (c *Client) UpdateUser(user *User) error {
if user.Owner == "" {
user.Owner = c.OrganizationName
}
return c.put(Ref{Owner: user.Owner, Name: user.Name}.path("users"), struct {
User *User `json:"user"`
}{User: user}, nil)
}
// Package-level helpers operate on the configured (or env-derived) global client.
func GetUser(name string) (*User, error) { return ensureClient().GetUser(name) }
func GetUsers() ([]*User, error) { return ensureClient().GetUsers() }
func UpdateUser(user *User) error { return ensureClient().UpdateUser(user) }