1 // Copyright (C) The Arvados Authors. All rights reserved.
3 // SPDX-License-Identifier: AGPL-3.0
23 "git.arvados.org/arvados.git/sdk/go/arvados"
24 "git.arvados.org/arvados.git/sdk/go/auth"
27 type TokenProvider func(context.Context) ([]string, error)
29 func PassthroughTokenProvider(ctx context.Context) ([]string, error) {
30 incoming, ok := auth.FromContext(ctx)
32 return nil, errors.New("no token provided")
34 return incoming.Tokens, nil
38 SendHeader http.Header
40 httpClient http.Client
42 tokenProvider TokenProvider
45 func NewConn(clusterID string, url *url.URL, insecure bool, tp TokenProvider) *Conn {
46 transport := http.DefaultTransport
48 // It's not safe to copy *http.DefaultTransport
49 // because it has a mutex (which might be locked)
50 // protecting a private map (which might not be nil).
51 // So we build our own, using the Go 1.12 default
52 // values, ignoring any changes the application has
53 // made to http.DefaultTransport.
54 transport = &http.Transport{
55 DialContext: (&net.Dialer{
56 Timeout: 30 * time.Second,
57 KeepAlive: 30 * time.Second,
61 IdleConnTimeout: 90 * time.Second,
62 TLSHandshakeTimeout: 10 * time.Second,
63 ExpectContinueTimeout: 1 * time.Second,
64 TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
69 httpClient: http.Client{
70 CheckRedirect: func(req *http.Request, via []*http.Request) error { return http.ErrUseLastResponse },
78 func (conn *Conn) requestAndDecode(ctx context.Context, dst interface{}, ep arvados.APIEndpoint, body io.Reader, opts interface{}) error {
79 aClient := arvados.Client{
80 Client: &conn.httpClient,
81 Scheme: conn.baseURL.Scheme,
82 APIHost: conn.baseURL.Host,
83 SendHeader: conn.SendHeader,
85 tokens, err := conn.tokenProvider(ctx)
88 } else if len(tokens) > 0 {
89 ctx = arvados.ContextWithAuthorization(ctx, "Bearer "+tokens[0])
91 // Use a non-empty auth string to ensure we override
92 // any default token set on aClient -- and to avoid
93 // having the remote prompt us to send a token by
95 ctx = arvados.ContextWithAuthorization(ctx, "Bearer -")
98 // Encode opts to JSON and decode from there to a
99 // map[string]interface{}, so we can munge the query params
100 // using the JSON key names specified by opts' struct tags.
101 j, err := json.Marshal(opts)
103 return fmt.Errorf("%T: requestAndDecode: Marshal opts: %s", conn, err)
105 var params map[string]interface{}
106 dec := json.NewDecoder(bytes.NewBuffer(j))
108 err = dec.Decode(¶ms)
110 return fmt.Errorf("%T: requestAndDecode: Decode opts: %s", conn, err)
112 if attrs, ok := params["attrs"]; ok && ep.AttrsKey != "" {
113 params[ep.AttrsKey] = attrs
114 delete(params, "attrs")
116 if limitStr, ok := params["limit"]; ok {
117 if limit, err := strconv.ParseInt(string(limitStr.(json.Number)), 10, 64); err == nil && limit < 0 {
118 // Negative limit means "not specified" here, but some
119 // servers/versions do not accept that, so we need to
120 // remove it entirely.
121 delete(params, "limit")
125 params["reader_tokens"] = tokens[1:]
128 if strings.Contains(ep.Path, "/{uuid}") {
129 uuid, _ := params["uuid"].(string)
130 path = strings.Replace(path, "/{uuid}", "/"+uuid, 1)
131 delete(params, "uuid")
133 return aClient.RequestAndDecodeContext(ctx, dst, ep.Method, path, body, params)
136 func (conn *Conn) BaseURL() url.URL {
140 func (conn *Conn) ConfigGet(ctx context.Context) (json.RawMessage, error) {
141 ep := arvados.EndpointConfigGet
142 var resp json.RawMessage
143 err := conn.requestAndDecode(ctx, &resp, ep, nil, nil)
147 func (conn *Conn) Login(ctx context.Context, options arvados.LoginOptions) (arvados.LoginResponse, error) {
148 ep := arvados.EndpointLogin
149 var resp arvados.LoginResponse
150 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
151 resp.RedirectLocation = conn.relativeToBaseURL(resp.RedirectLocation)
155 func (conn *Conn) Logout(ctx context.Context, options arvados.LogoutOptions) (arvados.LogoutResponse, error) {
156 ep := arvados.EndpointLogout
157 var resp arvados.LogoutResponse
158 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
159 resp.RedirectLocation = conn.relativeToBaseURL(resp.RedirectLocation)
163 // If the given location is a valid URL and its origin is the same as
164 // conn.baseURL, return it as a relative URL. Otherwise, return it
166 func (conn *Conn) relativeToBaseURL(location string) string {
167 u, err := url.Parse(location)
168 if err == nil && u.Scheme == conn.baseURL.Scheme && strings.ToLower(u.Host) == strings.ToLower(conn.baseURL.Host) {
178 func (conn *Conn) CollectionCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Collection, error) {
179 ep := arvados.EndpointCollectionCreate
180 var resp arvados.Collection
181 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
185 func (conn *Conn) CollectionUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Collection, error) {
186 ep := arvados.EndpointCollectionUpdate
187 var resp arvados.Collection
188 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
192 func (conn *Conn) CollectionGet(ctx context.Context, options arvados.GetOptions) (arvados.Collection, error) {
193 ep := arvados.EndpointCollectionGet
194 var resp arvados.Collection
195 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
199 func (conn *Conn) CollectionList(ctx context.Context, options arvados.ListOptions) (arvados.CollectionList, error) {
200 ep := arvados.EndpointCollectionList
201 var resp arvados.CollectionList
202 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
206 func (conn *Conn) CollectionProvenance(ctx context.Context, options arvados.GetOptions) (map[string]interface{}, error) {
207 ep := arvados.EndpointCollectionProvenance
208 var resp map[string]interface{}
209 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
213 func (conn *Conn) CollectionUsedBy(ctx context.Context, options arvados.GetOptions) (map[string]interface{}, error) {
214 ep := arvados.EndpointCollectionUsedBy
215 var resp map[string]interface{}
216 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
220 func (conn *Conn) CollectionDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Collection, error) {
221 ep := arvados.EndpointCollectionDelete
222 var resp arvados.Collection
223 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
227 func (conn *Conn) CollectionTrash(ctx context.Context, options arvados.DeleteOptions) (arvados.Collection, error) {
228 ep := arvados.EndpointCollectionTrash
229 var resp arvados.Collection
230 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
234 func (conn *Conn) CollectionUntrash(ctx context.Context, options arvados.UntrashOptions) (arvados.Collection, error) {
235 ep := arvados.EndpointCollectionUntrash
236 var resp arvados.Collection
237 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
241 func (conn *Conn) ContainerCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Container, error) {
242 ep := arvados.EndpointContainerCreate
243 var resp arvados.Container
244 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
248 func (conn *Conn) ContainerUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Container, error) {
249 ep := arvados.EndpointContainerUpdate
250 var resp arvados.Container
251 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
255 func (conn *Conn) ContainerGet(ctx context.Context, options arvados.GetOptions) (arvados.Container, error) {
256 ep := arvados.EndpointContainerGet
257 var resp arvados.Container
258 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
262 func (conn *Conn) ContainerList(ctx context.Context, options arvados.ListOptions) (arvados.ContainerList, error) {
263 ep := arvados.EndpointContainerList
264 var resp arvados.ContainerList
265 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
269 func (conn *Conn) ContainerDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Container, error) {
270 ep := arvados.EndpointContainerDelete
271 var resp arvados.Container
272 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
276 func (conn *Conn) ContainerLock(ctx context.Context, options arvados.GetOptions) (arvados.Container, error) {
277 ep := arvados.EndpointContainerLock
278 var resp arvados.Container
279 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
283 func (conn *Conn) ContainerUnlock(ctx context.Context, options arvados.GetOptions) (arvados.Container, error) {
284 ep := arvados.EndpointContainerUnlock
285 var resp arvados.Container
286 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
290 func (conn *Conn) ContainerRequestCreate(ctx context.Context, options arvados.CreateOptions) (arvados.ContainerRequest, error) {
291 log.Printf("THIS IS rcp.Conn.ContainerRequestCreate() for %s we are %s", options.ClusterID, conn.clusterID)
292 ep := arvados.EndpointContainerRequestCreate
293 var resp arvados.ContainerRequest
294 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
298 func (conn *Conn) ContainerRequestUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.ContainerRequest, error) {
299 ep := arvados.EndpointContainerRequestUpdate
300 var resp arvados.ContainerRequest
301 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
305 func (conn *Conn) ContainerRequestGet(ctx context.Context, options arvados.GetOptions) (arvados.ContainerRequest, error) {
306 ep := arvados.EndpointContainerRequestGet
307 var resp arvados.ContainerRequest
308 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
312 func (conn *Conn) ContainerRequestList(ctx context.Context, options arvados.ListOptions) (arvados.ContainerRequestList, error) {
313 ep := arvados.EndpointContainerRequestList
314 var resp arvados.ContainerRequestList
315 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
319 func (conn *Conn) ContainerRequestDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.ContainerRequest, error) {
320 ep := arvados.EndpointContainerRequestDelete
321 var resp arvados.ContainerRequest
322 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
326 func (conn *Conn) SpecimenCreate(ctx context.Context, options arvados.CreateOptions) (arvados.Specimen, error) {
327 ep := arvados.EndpointSpecimenCreate
328 var resp arvados.Specimen
329 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
333 func (conn *Conn) SpecimenUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.Specimen, error) {
334 ep := arvados.EndpointSpecimenUpdate
335 var resp arvados.Specimen
336 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
340 func (conn *Conn) SpecimenGet(ctx context.Context, options arvados.GetOptions) (arvados.Specimen, error) {
341 ep := arvados.EndpointSpecimenGet
342 var resp arvados.Specimen
343 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
347 func (conn *Conn) SpecimenList(ctx context.Context, options arvados.ListOptions) (arvados.SpecimenList, error) {
348 ep := arvados.EndpointSpecimenList
349 var resp arvados.SpecimenList
350 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
354 func (conn *Conn) SpecimenDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.Specimen, error) {
355 ep := arvados.EndpointSpecimenDelete
356 var resp arvados.Specimen
357 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
361 func (conn *Conn) UserCreate(ctx context.Context, options arvados.CreateOptions) (arvados.User, error) {
362 ep := arvados.EndpointUserCreate
363 var resp arvados.User
364 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
367 func (conn *Conn) UserUpdate(ctx context.Context, options arvados.UpdateOptions) (arvados.User, error) {
368 ep := arvados.EndpointUserUpdate
369 var resp arvados.User
370 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
373 func (conn *Conn) UserUpdateUUID(ctx context.Context, options arvados.UpdateUUIDOptions) (arvados.User, error) {
374 ep := arvados.EndpointUserUpdateUUID
375 var resp arvados.User
376 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
379 func (conn *Conn) UserMerge(ctx context.Context, options arvados.UserMergeOptions) (arvados.User, error) {
380 ep := arvados.EndpointUserMerge
381 var resp arvados.User
382 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
385 func (conn *Conn) UserActivate(ctx context.Context, options arvados.UserActivateOptions) (arvados.User, error) {
386 ep := arvados.EndpointUserActivate
387 var resp arvados.User
388 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
391 func (conn *Conn) UserSetup(ctx context.Context, options arvados.UserSetupOptions) (map[string]interface{}, error) {
392 ep := arvados.EndpointUserSetup
393 var resp map[string]interface{}
394 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
397 func (conn *Conn) UserUnsetup(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
398 ep := arvados.EndpointUserUnsetup
399 var resp arvados.User
400 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
403 func (conn *Conn) UserGet(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
404 ep := arvados.EndpointUserGet
405 var resp arvados.User
406 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
409 func (conn *Conn) UserGetCurrent(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
410 ep := arvados.EndpointUserGetCurrent
411 var resp arvados.User
412 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
415 func (conn *Conn) UserGetSystem(ctx context.Context, options arvados.GetOptions) (arvados.User, error) {
416 ep := arvados.EndpointUserGetSystem
417 var resp arvados.User
418 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
421 func (conn *Conn) UserList(ctx context.Context, options arvados.ListOptions) (arvados.UserList, error) {
422 ep := arvados.EndpointUserList
423 var resp arvados.UserList
424 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
427 func (conn *Conn) UserDelete(ctx context.Context, options arvados.DeleteOptions) (arvados.User, error) {
428 ep := arvados.EndpointUserDelete
429 var resp arvados.User
430 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
434 func (conn *Conn) APIClientAuthorizationCurrent(ctx context.Context, options arvados.GetOptions) (arvados.APIClientAuthorization, error) {
435 ep := arvados.EndpointAPIClientAuthorizationCurrent
436 var resp arvados.APIClientAuthorization
437 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
441 type UserSessionAuthInfo struct {
442 UserUUID string `json:"user_uuid"`
443 Email string `json:"email"`
444 AlternateEmails []string `json:"alternate_emails"`
445 FirstName string `json:"first_name"`
446 LastName string `json:"last_name"`
447 Username string `json:"username"`
450 type UserSessionCreateOptions struct {
451 AuthInfo UserSessionAuthInfo `json:"auth_info"`
452 ReturnTo string `json:"return_to"`
455 func (conn *Conn) UserSessionCreate(ctx context.Context, options UserSessionCreateOptions) (arvados.LoginResponse, error) {
456 ep := arvados.APIEndpoint{Method: "POST", Path: "auth/controller/callback"}
457 var resp arvados.LoginResponse
458 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
462 func (conn *Conn) UserBatchUpdate(ctx context.Context, options arvados.UserBatchUpdateOptions) (arvados.UserList, error) {
463 ep := arvados.EndpointUserBatchUpdate
464 var resp arvados.UserList
465 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)
469 func (conn *Conn) UserAuthenticate(ctx context.Context, options arvados.UserAuthenticateOptions) (arvados.APIClientAuthorization, error) {
470 ep := arvados.EndpointUserAuthenticate
471 var resp arvados.APIClientAuthorization
472 err := conn.requestAndDecode(ctx, &resp, ep, nil, options)