Fix 2.4.2 upgrade notes formatting refs #19330
[arvados.git] / lib / controller / federation / conn.go
1 // Copyright (C) The Arvados Authors. All rights reserved.
2 //
3 // SPDX-License-Identifier: AGPL-3.0
4
5 package federation
6
7 import (
8         "bytes"
9         "context"
10         "encoding/json"
11         "errors"
12         "fmt"
13         "net/http"
14         "net/url"
15         "regexp"
16         "strings"
17         "time"
18
19         "git.arvados.org/arvados.git/lib/config"
20         "git.arvados.org/arvados.git/lib/controller/localdb"
21         "git.arvados.org/arvados.git/lib/controller/rpc"
22         "git.arvados.org/arvados.git/sdk/go/arvados"
23         "git.arvados.org/arvados.git/sdk/go/auth"
24         "git.arvados.org/arvados.git/sdk/go/ctxlog"
25         "git.arvados.org/arvados.git/sdk/go/health"
26 )
27
28 type Conn struct {
29         cluster *arvados.Cluster
30         local   backend
31         remotes map[string]backend
32 }
33
34 func New(cluster *arvados.Cluster, healthFuncs *map[string]health.Func) *Conn {
35         local := localdb.NewConn(cluster)
36         remotes := map[string]backend{}
37         for id, remote := range cluster.RemoteClusters {
38                 if !remote.Proxy || id == cluster.ClusterID {
39                         continue
40                 }
41                 conn := rpc.NewConn(id, &url.URL{Scheme: remote.Scheme, Host: remote.Host}, remote.Insecure, saltedTokenProvider(cluster, local, id))
42                 // Older versions of controller rely on the Via header
43                 // to detect loops.
44                 conn.SendHeader = http.Header{"Via": {"HTTP/1.1 arvados-controller"}}
45                 remotes[id] = conn
46         }
47
48         if healthFuncs != nil {
49                 hf := map[string]health.Func{"vocabulary": local.LastVocabularyError}
50                 *healthFuncs = hf
51         }
52
53         return &Conn{
54                 cluster: cluster,
55                 local:   local,
56                 remotes: remotes,
57         }
58 }
59
60 // Return a new rpc.TokenProvider that takes the client-provided
61 // tokens from an incoming request context, determines whether they
62 // should (and can) be salted for the given remoteID, and returns the
63 // resulting tokens.
64 func saltedTokenProvider(cluster *arvados.Cluster, local backend, remoteID string) rpc.TokenProvider {
65         return func(ctx context.Context) ([]string, error) {
66                 var tokens []string
67                 incoming, ok := auth.FromContext(ctx)
68                 if !ok {
69                         return nil, errors.New("no token provided")
70                 }
71                 for _, token := range incoming.Tokens {
72                         if strings.HasPrefix(token, "v2/"+cluster.ClusterID+"-") &&
73                                 !strings.HasPrefix(token, "v2/"+cluster.ClusterID+"-gj3su-anonymouspublic/") &&
74                                 remoteID == cluster.Login.LoginCluster {
75                                 // If we did this, the login cluster would call back to us and then
76                                 // reject our response because the user UUID prefix (i.e., the
77                                 // LoginCluster prefix) won't match the token UUID prefix (i.e., our
78                                 // prefix). The anonymous token is OK to forward, because (unlike other
79                                 // local tokens for real users) the validation callback will return the
80                                 // locally issued anonymous user ID instead of a login-cluster user ID.
81                                 // That anonymous user ID gets mapped to the local anonymous user
82                                 // automatically on the login cluster.
83                                 return nil, httpErrorf(http.StatusUnauthorized, "cannot use a locally issued token to forward a request to our login cluster (%s)", remoteID)
84                         }
85                         salted, err := auth.SaltToken(token, remoteID)
86                         switch err {
87                         case nil:
88                                 tokens = append(tokens, salted)
89                         case auth.ErrSalted:
90                                 tokens = append(tokens, token)
91                         case auth.ErrTokenFormat:
92                                 // pass through unmodified (assume it's an OIDC access token)
93                                 tokens = append(tokens, token)
94                         case auth.ErrObsoleteToken:
95                                 ctx := auth.NewContext(ctx, &auth.Credentials{Tokens: []string{token}})
96                                 aca, err := local.APIClientAuthorizationCurrent(ctx, arvados.GetOptions{})
97                                 if errStatus(err) == http.StatusUnauthorized {
98                                         // pass through unmodified
99                                         tokens = append(tokens, token)
100                                         continue
101                                 } else if err != nil {
102                                         return nil, err
103                                 }
104                                 if strings.HasPrefix(aca.UUID, remoteID) {
105                                         // We have it cached here, but
106                                         // the token belongs to the
107                                         // remote target itself, so
108                                         // pass it through unmodified.
109                                         tokens = append(tokens, token)
110                                         continue
111                                 }
112                                 salted, err := auth.SaltToken(aca.TokenV2(), remoteID)
113                                 if err != nil {
114                                         return nil, err
115                                 }
116                                 tokens = append(tokens, salted)
117                         default:
118                                 return nil, err
119                         }
120                 }
121                 return tokens, nil
122         }
123 }
124
125 // Return suitable backend for a query about the given cluster ID
126 // ("aaaaa") or object UUID ("aaaaa-dz642-abcdefghijklmno").
127 func (conn *Conn) chooseBackend(id string) backend {
128         if len(id) == 27 {
129                 id = id[:5]
130         } else if len(id) != 5 {
131                 // PDH or bogus ID
132                 return conn.local
133         }
134         if id == conn.cluster.ClusterID {
135                 return conn.local
136         } else if be, ok := conn.remotes[id]; ok {
137                 return be
138         } else {
139                 // TODO: return an "always error" backend?
140                 return conn.local
141         }
142 }
143
144 func (conn *Conn) localOrLoginCluster() backend {
145         if conn.cluster.Login.LoginCluster != "" {
146                 return conn.chooseBackend(conn.cluster.Login.LoginCluster)
147         }
148         return conn.local
149 }
150
151 // Call fn with the local backend; then, if fn returned 404, call fn
152 // on the available remote backends (possibly concurrently) until one
153 // succeeds.
154 //
155 // The second argument to fn is the cluster ID of the remote backend,
156 // or "" for the local backend.
157 //
158 // A non-nil error means all backends failed.
159 func (conn *Conn) tryLocalThenRemotes(ctx context.Context, forwardedFor string, fn func(context.Context, string, backend) error) error {
160         if err := fn(ctx, "", conn.local); err == nil || errStatus(err) != http.StatusNotFound || forwardedFor != "" {
161                 // Note: forwardedFor != "" means this request came
162                 // from a remote cluster, so we don't take a second
163                 // hop. This avoids cycles, redundant calls to a
164                 // mutually reachable remote, and use of double-salted
165                 // tokens.
166                 return err
167         }
168
169         ctx, cancel := context.WithCancel(ctx)
170         defer cancel()
171         errchan := make(chan error, len(conn.remotes))
172         for remoteID, be := range conn.remotes {
173                 remoteID, be := remoteID, be
174                 go func() {
175                         errchan <- fn(ctx, remoteID, be)
176                 }()
177         }
178         all404 := true
179         var errs []error
180         for i := 0; i < cap(errchan); i++ {
181                 err := <-errchan
182                 if err == nil {
183                         return nil
184                 }
185                 all404 = all404 && errStatus(err) == http.StatusNotFound
186                 errs = append(errs, err)
187         }
188         if all404 {
189                 return notFoundError{}
190         }
191         return httpErrorf(http.StatusBadGateway, "errors: %v", errs)
192 }
193
194 func (conn *Conn) CollectionCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Collection, error) {
195         return conn.chooseBackend(options.ClusterID).CollectionCreate(ctx, options)
196 }
197
198 func (conn *Conn) CollectionUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Collection, error) {
199         return conn.chooseBackend(options.UUID).CollectionUpdate(ctx, options)
200 }
201
202 func rewriteManifest(mt, remoteID string) string {
203         return regexp.MustCompile(` [0-9a-f]{32}\+[^ ]*`).ReplaceAllStringFunc(mt, func(tok string) string {
204                 return strings.Replace(tok, "+A", "+R"+remoteID+"-", -1)
205         })
206 }
207
208 func (conn *Conn) ConfigGet(ctx context.Context) (json.RawMessage, error) {
209         var buf bytes.Buffer
210         err := config.ExportJSON(&buf, conn.cluster)
211         return json.RawMessage(buf.Bytes()), err
212 }
213
214 func (conn *Conn) VocabularyGet(ctx context.Context) (arvados.Vocabulary, error) {
215         return conn.chooseBackend(conn.cluster.ClusterID).VocabularyGet(ctx)
216 }
217
218 func (conn *Conn) Login(ctx context.Context, options arvados.LoginOptions) (arvados.LoginResponse, error) {
219         if id := conn.cluster.Login.LoginCluster; id != "" && id != conn.cluster.ClusterID {
220                 // defer entire login procedure to designated cluster
221                 remote, ok := conn.remotes[id]
222                 if !ok {
223                         return arvados.LoginResponse{}, fmt.Errorf("configuration problem: designated login cluster %q is not defined", id)
224                 }
225                 baseURL := remote.BaseURL()
226                 target, err := baseURL.Parse(arvados.EndpointLogin.Path)
227                 if err != nil {
228                         return arvados.LoginResponse{}, fmt.Errorf("internal error getting redirect target: %s", err)
229                 }
230                 params := url.Values{
231                         "return_to": []string{options.ReturnTo},
232                 }
233                 if options.Remote != "" {
234                         params.Set("remote", options.Remote)
235                 }
236                 target.RawQuery = params.Encode()
237                 return arvados.LoginResponse{
238                         RedirectLocation: target.String(),
239                 }, nil
240         }
241         return conn.local.Login(ctx, options)
242 }
243
244 func (conn *Conn) Logout(ctx context.Context, options arvados.LogoutOptions) (arvados.LogoutResponse, error) {
245         // If the logout request comes with an API token from a known
246         // remote cluster, redirect to that cluster's logout handler
247         // so it has an opportunity to clear sessions, expire tokens,
248         // etc. Otherwise use the local endpoint.
249         reqauth, ok := auth.FromContext(ctx)
250         if !ok || len(reqauth.Tokens) == 0 || len(reqauth.Tokens[0]) < 8 || !strings.HasPrefix(reqauth.Tokens[0], "v2/") {
251                 return conn.local.Logout(ctx, options)
252         }
253         id := reqauth.Tokens[0][3:8]
254         if id == conn.cluster.ClusterID {
255                 return conn.local.Logout(ctx, options)
256         }
257         remote, ok := conn.remotes[id]
258         if !ok {
259                 return conn.local.Logout(ctx, options)
260         }
261         baseURL := remote.BaseURL()
262         target, err := baseURL.Parse(arvados.EndpointLogout.Path)
263         if err != nil {
264                 return arvados.LogoutResponse{}, fmt.Errorf("internal error getting redirect target: %s", err)
265         }
266         target.RawQuery = url.Values{"return_to": {options.ReturnTo}}.Encode()
267         return arvados.LogoutResponse{RedirectLocation: target.String()}, nil
268 }
269
270 func (conn *Conn) CollectionGet(ctx context.Context, options arvados.GetOptions) (arvados.Collection, error) {
271         if len(options.UUID) == 27 {
272                 // UUID is really a UUID
273                 c, err := conn.chooseBackend(options.UUID).CollectionGet(ctx, options)
274                 if err == nil && options.UUID[:5] != conn.cluster.ClusterID {
275                         c.ManifestText = rewriteManifest(c.ManifestText, options.UUID[:5])
276                 }
277                 return c, err
278         }
279         // UUID is a PDH
280         first := make(chan arvados.Collection, 1)
281         err := conn.tryLocalThenRemotes(ctx, options.ForwardedFor, func(ctx context.Context, remoteID string, be backend) error {
282                 remoteOpts := options
283                 remoteOpts.ForwardedFor = conn.cluster.ClusterID + "-" + options.ForwardedFor
284                 c, err := be.CollectionGet(ctx, remoteOpts)
285                 if err != nil {
286                         return err
287                 }
288                 haveManifest := true
289                 if options.Select != nil {
290                         haveManifest = false
291                         for _, s := range options.Select {
292                                 if s == "manifest_text" {
293                                         haveManifest = true
294                                         break
295                                 }
296                         }
297                 }
298                 if haveManifest {
299                         pdh := arvados.PortableDataHash(c.ManifestText)
300                         // options.UUID is either hash+size or
301                         // hash+size+hints; only hash+size need to
302                         // match the computed PDH.
303                         if pdh != options.UUID && !strings.HasPrefix(options.UUID, pdh+"+") {
304                                 err = httpErrorf(http.StatusBadGateway, "bad portable data hash %q received from remote %q (expected %q)", pdh, remoteID, options.UUID)
305                                 ctxlog.FromContext(ctx).Warn(err)
306                                 return err
307                         }
308                 }
309                 if remoteID != "" {
310                         c.ManifestText = rewriteManifest(c.ManifestText, remoteID)
311                 }
312                 select {
313                 case first <- c:
314                         return nil
315                 default:
316                         // lost race, return value doesn't matter
317                         return nil
318                 }
319         })
320         if err != nil {
321                 return arvados.Collection{}, err
322         }
323         return <-first, nil
324 }
325
326 func (conn *Conn) CollectionList(ctx context.Context, options arvados.ListOptions) (arvados.CollectionList, error) {
327         return conn.generated_CollectionList(ctx, options)
328 }
329
330 func (conn *Conn) CollectionProvenance(ctx context.Context, options arvados.GetOptions) (map[string]interface{}, error) {
331         return conn.chooseBackend(options.UUID).CollectionProvenance(ctx, options)
332 }
333
334 func (conn *Conn) CollectionUsedBy(ctx context.Context, options arvados.GetOptions) (map[string]interface{}, error) {
335         return conn.chooseBackend(options.UUID).CollectionUsedBy(ctx, options)
336 }
337
338 func (conn *Conn) CollectionDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Collection, error) {
339         return conn.chooseBackend(options.UUID).CollectionDelete(ctx, options)
340 }
341
342 func (conn *Conn) CollectionTrash(ctx context.Context, options arvados.DeleteOptions) (arvados.Collection, error) {
343         return conn.chooseBackend(options.UUID).CollectionTrash(ctx, options)
344 }
345
346 func (conn *Conn) CollectionUntrash(ctx context.Context, options arvados.UntrashOptions) (arvados.Collection, error) {
347         return conn.chooseBackend(options.UUID).CollectionUntrash(ctx, options)
348 }
349
350 func (conn *Conn) ContainerList(ctx context.Context, options arvados.ListOptions) (arvados.ContainerList, error) {
351         return conn.generated_ContainerList(ctx, options)
352 }
353
354 func (conn *Conn) ContainerCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Container, error) {
355         return conn.chooseBackend(options.ClusterID).ContainerCreate(ctx, options)
356 }
357
358 func (conn *Conn) ContainerUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Container, error) {
359         return conn.chooseBackend(options.UUID).ContainerUpdate(ctx, options)
360 }
361
362 func (conn *Conn) ContainerGet(ctx context.Context, options arvados.GetOptions) (arvados.Container, error) {
363         return conn.chooseBackend(options.UUID).ContainerGet(ctx, options)
364 }
365
366 func (conn *Conn) ContainerDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Container, error) {
367         return conn.chooseBackend(options.UUID).ContainerDelete(ctx, options)
368 }
369
370 func (conn *Conn) ContainerLock(ctx context.Context, options arvados.GetOptions) (arvados.Container, error) {
371         return conn.chooseBackend(options.UUID).ContainerLock(ctx, options)
372 }
373
374 func (conn *Conn) ContainerUnlock(ctx context.Context, options arvados.GetOptions) (arvados.Container, error) {
375         return conn.chooseBackend(options.UUID).ContainerUnlock(ctx, options)
376 }
377
378 func (conn *Conn) ContainerSSH(ctx context.Context, options arvados.ContainerSSHOptions) (arvados.ConnectionResponse, error) {
379         return conn.chooseBackend(options.UUID).ContainerSSH(ctx, options)
380 }
381
382 func (conn *Conn) ContainerGatewayTunnel(ctx context.Context, options arvados.ContainerGatewayTunnelOptions) (arvados.ConnectionResponse, error) {
383         return conn.chooseBackend(options.UUID).ContainerGatewayTunnel(ctx, options)
384 }
385
386 func (conn *Conn) ContainerRequestList(ctx context.Context, options arvados.ListOptions) (arvados.ContainerRequestList, error) {
387         return conn.generated_ContainerRequestList(ctx, options)
388 }
389
390 func (conn *Conn) ContainerRequestCreate(ctx context.Context, options arvados.CreateOptions) (arvados.ContainerRequest, error) {
391         be := conn.chooseBackend(options.ClusterID)
392         if be == conn.local {
393                 return be.ContainerRequestCreate(ctx, options)
394         }
395         if _, ok := options.Attrs["runtime_token"]; !ok {
396                 // If runtime_token is not set, create a new token
397                 aca, err := conn.local.APIClientAuthorizationCurrent(ctx, arvados.GetOptions{})
398                 if err != nil {
399                         // This should probably be StatusUnauthorized
400                         // (need to update test in
401                         // lib/controller/federation_test.go):
402                         // When RoR is out of the picture this should be:
403                         // return arvados.ContainerRequest{}, httpErrorf(http.StatusUnauthorized, "%w", err)
404                         return arvados.ContainerRequest{}, httpErrorf(http.StatusForbidden, "%s", "invalid API token")
405                 }
406                 user, err := conn.local.UserGetCurrent(ctx, arvados.GetOptions{})
407                 if err != nil {
408                         return arvados.ContainerRequest{}, err
409                 }
410                 if len(aca.Scopes) == 0 || aca.Scopes[0] != "all" {
411                         return arvados.ContainerRequest{}, httpErrorf(http.StatusForbidden, "token scope is not [all]")
412                 }
413                 if strings.HasPrefix(aca.UUID, conn.cluster.ClusterID) {
414                         // Local user, submitting to a remote cluster.
415                         // Create a new time-limited token.
416                         local, ok := conn.local.(*localdb.Conn)
417                         if !ok {
418                                 return arvados.ContainerRequest{}, httpErrorf(http.StatusInternalServerError, "bug: local backend is a %T, not a *localdb.Conn", conn.local)
419                         }
420                         aca, err = local.CreateAPIClientAuthorization(ctx, conn.cluster.SystemRootToken, rpc.UserSessionAuthInfo{UserUUID: user.UUID,
421                                 ExpiresAt: time.Now().UTC().Add(conn.cluster.Collections.BlobSigningTTL.Duration())})
422                         if err != nil {
423                                 return arvados.ContainerRequest{}, err
424                         }
425                         options.Attrs["runtime_token"] = aca.TokenV2()
426                 } else {
427                         // Remote user. Container request will use the
428                         // current token, minus the trailing portion
429                         // (optional container uuid).
430                         options.Attrs["runtime_token"] = aca.TokenV2()
431                 }
432         }
433         return be.ContainerRequestCreate(ctx, options)
434 }
435
436 func (conn *Conn) ContainerRequestUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.ContainerRequest, error) {
437         return conn.chooseBackend(options.UUID).ContainerRequestUpdate(ctx, options)
438 }
439
440 func (conn *Conn) ContainerRequestGet(ctx context.Context, options arvados.GetOptions) (arvados.ContainerRequest, error) {
441         return conn.chooseBackend(options.UUID).ContainerRequestGet(ctx, options)
442 }
443
444 func (conn *Conn) ContainerRequestDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.ContainerRequest, error) {
445         return conn.chooseBackend(options.UUID).ContainerRequestDelete(ctx, options)
446 }
447
448 func (conn *Conn) GroupCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Group, error) {
449         return conn.chooseBackend(options.ClusterID).GroupCreate(ctx, options)
450 }
451
452 func (conn *Conn) GroupUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Group, error) {
453         return conn.chooseBackend(options.UUID).GroupUpdate(ctx, options)
454 }
455
456 func (conn *Conn) GroupGet(ctx context.Context, options arvados.GetOptions) (arvados.Group, error) {
457         return conn.chooseBackend(options.UUID).GroupGet(ctx, options)
458 }
459
460 func (conn *Conn) GroupList(ctx context.Context, options arvados.ListOptions) (arvados.GroupList, error) {
461         return conn.generated_GroupList(ctx, options)
462 }
463
464 var userUuidRe = regexp.MustCompile(`^[0-9a-z]{5}-tpzed-[0-9a-z]{15}$`)
465
466 func (conn *Conn) GroupContents(ctx context.Context, options arvados.GroupContentsOptions) (arvados.ObjectList, error) {
467         if options.ClusterID != "" {
468                 // explicitly selected cluster
469                 return conn.chooseBackend(options.ClusterID).GroupContents(ctx, options)
470         } else if userUuidRe.MatchString(options.UUID) {
471                 // user, get the things they own on the local cluster
472                 return conn.local.GroupContents(ctx, options)
473         } else {
474                 // a group, potentially want to make federated request
475                 return conn.chooseBackend(options.UUID).GroupContents(ctx, options)
476         }
477 }
478
479 func (conn *Conn) GroupShared(ctx context.Context, options arvados.ListOptions) (arvados.GroupList, error) {
480         return conn.chooseBackend(options.ClusterID).GroupShared(ctx, options)
481 }
482
483 func (conn *Conn) GroupDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Group, error) {
484         return conn.chooseBackend(options.UUID).GroupDelete(ctx, options)
485 }
486
487 func (conn *Conn) GroupTrash(ctx context.Context, options arvados.DeleteOptions) (arvados.Group, error) {
488         return conn.chooseBackend(options.UUID).GroupTrash(ctx, options)
489 }
490
491 func (conn *Conn) GroupUntrash(ctx context.Context, options arvados.UntrashOptions) (arvados.Group, error) {
492         return conn.chooseBackend(options.UUID).GroupUntrash(ctx, options)
493 }
494
495 func (conn *Conn) LinkCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Link, error) {
496         return conn.chooseBackend(options.ClusterID).LinkCreate(ctx, options)
497 }
498
499 func (conn *Conn) LinkUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Link, error) {
500         return conn.chooseBackend(options.UUID).LinkUpdate(ctx, options)
501 }
502
503 func (conn *Conn) LinkGet(ctx context.Context, options arvados.GetOptions) (arvados.Link, error) {
504         return conn.chooseBackend(options.UUID).LinkGet(ctx, options)
505 }
506
507 func (conn *Conn) LinkList(ctx context.Context, options arvados.ListOptions) (arvados.LinkList, error) {
508         return conn.generated_LinkList(ctx, options)
509 }
510
511 func (conn *Conn) LinkDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Link, error) {
512         return conn.chooseBackend(options.UUID).LinkDelete(ctx, options)
513 }
514
515 func (conn *Conn) SpecimenList(ctx context.Context, options arvados.ListOptions) (arvados.SpecimenList, error) {
516         return conn.generated_SpecimenList(ctx, options)
517 }
518
519 func (conn *Conn) SpecimenCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Specimen, error) {
520         return conn.chooseBackend(options.ClusterID).SpecimenCreate(ctx, options)
521 }
522
523 func (conn *Conn) SpecimenUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Specimen, error) {
524         return conn.chooseBackend(options.UUID).SpecimenUpdate(ctx, options)
525 }
526
527 func (conn *Conn) SpecimenGet(ctx context.Context, options arvados.GetOptions) (arvados.Specimen, error) {
528         return conn.chooseBackend(options.UUID).SpecimenGet(ctx, options)
529 }
530
531 func (conn *Conn) SpecimenDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Specimen, error) {
532         return conn.chooseBackend(options.UUID).SpecimenDelete(ctx, options)
533 }
534
535 func (conn *Conn) SysTrashSweep(ctx context.Context, options struct{}) (struct{}, error) {
536         return conn.local.SysTrashSweep(ctx, options)
537 }
538
539 var userAttrsCachedFromLoginCluster = map[string]bool{
540         "created_at":  true,
541         "email":       true,
542         "first_name":  true,
543         "is_active":   true,
544         "is_admin":    true,
545         "last_name":   true,
546         "modified_at": true,
547         "prefs":       true,
548         "username":    true,
549         "kind":        true,
550
551         "etag":                    false,
552         "full_name":               false,
553         "identity_url":            false,
554         "is_invited":              false,
555         "modified_by_client_uuid": false,
556         "modified_by_user_uuid":   false,
557         "owner_uuid":              false,
558         "uuid":                    false,
559         "writable_by":             false,
560         "can_write":               false,
561         "can_manage":              false,
562 }
563
564 func (conn *Conn) batchUpdateUsers(ctx context.Context,
565         options arvados.ListOptions,
566         items []arvados.User) (err error) {
567
568         id := conn.cluster.Login.LoginCluster
569         logger := ctxlog.FromContext(ctx)
570         batchOpts := arvados.UserBatchUpdateOptions{Updates: map[string]map[string]interface{}{}}
571         for _, user := range items {
572                 if !strings.HasPrefix(user.UUID, id) {
573                         continue
574                 }
575                 logger.Debugf("cache user info for uuid %q", user.UUID)
576
577                 // If the remote cluster has null timestamps
578                 // (e.g., test server with incomplete
579                 // fixtures) use dummy timestamps (instead of
580                 // the zero time, which causes a Rails API
581                 // error "year too big to marshal: 1 UTC").
582                 if user.ModifiedAt.IsZero() {
583                         user.ModifiedAt = time.Now()
584                 }
585                 if user.CreatedAt.IsZero() {
586                         user.CreatedAt = time.Now()
587                 }
588
589                 var allFields map[string]interface{}
590                 buf, err := json.Marshal(user)
591                 if err != nil {
592                         return fmt.Errorf("error encoding user record from remote response: %s", err)
593                 }
594                 err = json.Unmarshal(buf, &allFields)
595                 if err != nil {
596                         return fmt.Errorf("error transcoding user record from remote response: %s", err)
597                 }
598                 updates := allFields
599                 if len(options.Select) > 0 {
600                         updates = map[string]interface{}{}
601                         for _, k := range options.Select {
602                                 if v, ok := allFields[k]; ok && userAttrsCachedFromLoginCluster[k] {
603                                         updates[k] = v
604                                 }
605                         }
606                 } else {
607                         for k := range updates {
608                                 if !userAttrsCachedFromLoginCluster[k] {
609                                         delete(updates, k)
610                                 }
611                         }
612                 }
613                 batchOpts.Updates[user.UUID] = updates
614         }
615         if len(batchOpts.Updates) > 0 {
616                 ctxRoot := auth.NewContext(ctx, &auth.Credentials{Tokens: []string{conn.cluster.SystemRootToken}})
617                 _, err = conn.local.UserBatchUpdate(ctxRoot, batchOpts)
618                 if err != nil {
619                         return fmt.Errorf("error updating local user records: %s", err)
620                 }
621         }
622         return nil
623 }
624
625 func (conn *Conn) UserList(ctx context.Context, options arvados.ListOptions) (arvados.UserList, error) {
626         if id := conn.cluster.Login.LoginCluster; id != "" && id != conn.cluster.ClusterID && !options.BypassFederation {
627                 resp, err := conn.chooseBackend(id).UserList(ctx, options)
628                 if err != nil {
629                         return resp, err
630                 }
631                 err = conn.batchUpdateUsers(ctx, options, resp.Items)
632                 if err != nil {
633                         return arvados.UserList{}, err
634                 }
635                 return resp, nil
636         }
637         return conn.generated_UserList(ctx, options)
638 }
639
640 func (conn *Conn) UserCreate(ctx context.Context, options arvados.CreateOptions) (arvados.User, error) {
641         return conn.chooseBackend(options.ClusterID).UserCreate(ctx, options)
642 }
643
644 func (conn *Conn) UserUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.User, error) {
645         if options.BypassFederation {
646                 return conn.local.UserUpdate(ctx, options)
647         }
648         resp, err := conn.chooseBackend(options.UUID).UserUpdate(ctx, options)
649         if err != nil {
650                 return resp, err
651         }
652         if !strings.HasPrefix(options.UUID, conn.cluster.ClusterID) {
653                 // Copy the updated user record to the local cluster
654                 err = conn.batchUpdateUsers(ctx, arvados.ListOptions{}, []arvados.User{resp})
655                 if err != nil {
656                         return arvados.User{}, err
657                 }
658         }
659         return resp, err
660 }
661
662 func (conn *Conn) UserMerge(ctx context.Context, options arvados.UserMergeOptions) (arvados.User, error) {
663         return conn.local.UserMerge(ctx, options)
664 }
665
666 func (conn *Conn) UserActivate(ctx context.Context, options arvados.UserActivateOptions) (arvados.User, error) {
667         return conn.localOrLoginCluster().UserActivate(ctx, options)
668 }
669
670 func (conn *Conn) UserSetup(ctx context.Context, options arvados.UserSetupOptions) (map[string]interface{}, error) {
671         upstream := conn.localOrLoginCluster()
672         if upstream != conn.local {
673                 // When LoginCluster is in effect, and we're setting
674                 // up a remote user, and we want to give that user
675                 // access to a local VM, we can't include the VM in
676                 // the setup call, because the remote cluster won't
677                 // recognize it.
678
679                 // Similarly, if we want to create a git repo,
680                 // it should be created on the local cluster,
681                 // not the remote one.
682
683                 upstreamOptions := options
684                 upstreamOptions.VMUUID = ""
685                 upstreamOptions.RepoName = ""
686
687                 ret, err := upstream.UserSetup(ctx, upstreamOptions)
688                 if err != nil {
689                         return ret, err
690                 }
691         }
692
693         return conn.local.UserSetup(ctx, options)
694 }
695
696 func (conn *Conn) UserUnsetup(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
697         return conn.localOrLoginCluster().UserUnsetup(ctx, options)
698 }
699
700 func (conn *Conn) UserGet(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
701         resp, err := conn.chooseBackend(options.UUID).UserGet(ctx, options)
702         if err != nil {
703                 return resp, err
704         }
705         if options.UUID != resp.UUID {
706                 return arvados.User{}, httpErrorf(http.StatusBadGateway, "Had requested %v but response was for %v", options.UUID, resp.UUID)
707         }
708         if options.UUID[:5] != conn.cluster.ClusterID {
709                 err = conn.batchUpdateUsers(ctx, arvados.ListOptions{Select: options.Select}, []arvados.User{resp})
710                 if err != nil {
711                         return arvados.User{}, err
712                 }
713         }
714         return resp, nil
715 }
716
717 func (conn *Conn) UserGetCurrent(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
718         return conn.local.UserGetCurrent(ctx, options)
719 }
720
721 func (conn *Conn) UserGetSystem(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
722         return conn.chooseBackend(options.UUID).UserGetSystem(ctx, options)
723 }
724
725 func (conn *Conn) UserDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.User, error) {
726         return conn.chooseBackend(options.UUID).UserDelete(ctx, options)
727 }
728
729 func (conn *Conn) UserBatchUpdate(ctx context.Context, options arvados.UserBatchUpdateOptions) (arvados.UserList, error) {
730         return conn.local.UserBatchUpdate(ctx, options)
731 }
732
733 func (conn *Conn) UserAuthenticate(ctx context.Context, options arvados.UserAuthenticateOptions) (arvados.APIClientAuthorization, error) {
734         return conn.local.UserAuthenticate(ctx, options)
735 }
736
737 func (conn *Conn) APIClientAuthorizationCurrent(ctx context.Context, options arvados.GetOptions) (arvados.APIClientAuthorization, error) {
738         return conn.chooseBackend(options.UUID).APIClientAuthorizationCurrent(ctx, options)
739 }
740
741 func (conn *Conn) APIClientAuthorizationCreate(ctx context.Context, options arvados.CreateOptions) (arvados.APIClientAuthorization, error) {
742         if conn.cluster.Login.LoginCluster != "" {
743                 return conn.chooseBackend(conn.cluster.Login.LoginCluster).APIClientAuthorizationCreate(ctx, options)
744         }
745         ownerUUID, ok := options.Attrs["owner_uuid"].(string)
746         if ok && ownerUUID != "" {
747                 return conn.chooseBackend(ownerUUID).APIClientAuthorizationCreate(ctx, options)
748         }
749         return conn.local.APIClientAuthorizationCreate(ctx, options)
750 }
751
752 func (conn *Conn) APIClientAuthorizationUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.APIClientAuthorization, error) {
753         if options.BypassFederation {
754                 return conn.local.APIClientAuthorizationUpdate(ctx, options)
755         }
756         return conn.chooseBackend(options.UUID).APIClientAuthorizationUpdate(ctx, options)
757 }
758
759 func (conn *Conn) APIClientAuthorizationDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.APIClientAuthorization, error) {
760         return conn.chooseBackend(options.UUID).APIClientAuthorizationDelete(ctx, options)
761 }
762
763 func (conn *Conn) APIClientAuthorizationList(ctx context.Context, options arvados.ListOptions) (arvados.APIClientAuthorizationList, error) {
764         if id := conn.cluster.Login.LoginCluster; id != "" && id != conn.cluster.ClusterID && !options.BypassFederation {
765                 return conn.chooseBackend(conn.cluster.Login.LoginCluster).APIClientAuthorizationList(ctx, options)
766         }
767         return conn.generated_APIClientAuthorizationList(ctx, options)
768 }
769
770 func (conn *Conn) APIClientAuthorizationGet(ctx context.Context, options arvados.GetOptions) (arvados.APIClientAuthorization, error) {
771         return conn.chooseBackend(options.UUID).APIClientAuthorizationGet(ctx, options)
772 }
773
774 type backend interface {
775         arvados.API
776         BaseURL() url.URL
777 }
778
779 type notFoundError struct{}
780
781 func (notFoundError) HTTPStatus() int { return http.StatusNotFound }
782 func (notFoundError) Error() string   { return "not found" }
783
784 func errStatus(err error) int {
785         if httpErr, ok := err.(interface{ HTTPStatus() int }); ok {
786                 return httpErr.HTTPStatus()
787         }
788         return http.StatusInternalServerError
789 }