package api import ( "errors" "net/http" "strconv" "time" "github.com/grafana/grafana/pkg/api/dtos" "github.com/grafana/grafana/pkg/api/response" "github.com/grafana/grafana/pkg/components/apikeygen" "github.com/grafana/grafana/pkg/services/apikey" contextmodel "github.com/grafana/grafana/pkg/services/contexthandler/model" "github.com/grafana/grafana/pkg/web" ) // swagger:route GET /auth/keys api_keys getAPIkeys // // Get auth keys. // // Will return auth keys. // // Deprecated: true. // // Deprecated. Please use GET /api/serviceaccounts and GET /api/serviceaccounts/{id}/tokens instead // see https://grafana.com/docs/grafana/next/administration/api-keys/#migrate-api-keys-to-grafana-service-accounts-using-the-api. // // Responses: // 200: getAPIkeyResponse // 401: unauthorisedError // 403: forbiddenError // 404: notFoundError // 500: internalServerError func (hs *HTTPServer) GetAPIKeys(c *contextmodel.ReqContext) response.Response { query := apikey.GetApiKeysQuery{OrgID: c.OrgID, User: c.SignedInUser, IncludeExpired: c.QueryBool("includeExpired")} keys, err := hs.apiKeyService.GetAPIKeys(c.Req.Context(), &query) if err != nil { return response.Error(500, "Failed to list api keys", err) } ids := map[string]bool{} result := make([]*dtos.ApiKeyDTO, len(keys)) for i, t := range keys { ids[strconv.FormatInt(t.ID, 10)] = true var expiration *time.Time = nil if t.Expires != nil { v := time.Unix(*t.Expires, 0) expiration = &v } result[i] = &dtos.ApiKeyDTO{ ID: t.ID, Name: t.Name, Role: t.Role, Expiration: expiration, LastUsedAt: t.LastUsedAt, } } metadata := hs.getMultiAccessControlMetadata(c, c.OrgID, "apikeys:id", ids) if len(metadata) > 0 { for _, key := range result { key.AccessControl = metadata[strconv.FormatInt(key.ID, 10)] } } return response.JSON(http.StatusOK, result) } // swagger:route DELETE /auth/keys/{id} api_keys deleteAPIkey // // Delete API key. // // Deletes an API key. // Deprecated. See: https://grafana.com/docs/grafana/next/administration/api-keys/#migrate-api-keys-to-grafana-service-accounts-using-the-api. // // Deprecated: true // Responses: // 200: okResponse // 401: unauthorisedError // 403: forbiddenError // 404: notFoundError // 500: internalServerError func (hs *HTTPServer) DeleteAPIKey(c *contextmodel.ReqContext) response.Response { id, err := strconv.ParseInt(web.Params(c.Req)[":id"], 10, 64) if err != nil { return response.Error(http.StatusBadRequest, "id is invalid", err) } cmd := &apikey.DeleteCommand{ID: id, OrgID: c.OrgID} err = hs.apiKeyService.DeleteApiKey(c.Req.Context(), cmd) if err != nil { var status int if errors.Is(err, apikey.ErrNotFound) { status = 404 } else { status = 500 } return response.Error(status, "Failed to delete API key", err) } return response.Success("API key deleted") } // swagger:route POST /auth/keys api_keys addAPIkey // // Creates an API key. // // Will return details of the created API key. // // Deprecated: true // Deprecated. Please use POST /api/serviceaccounts and POST /api/serviceaccounts/{id}/tokens // // see: https://grafana.com/docs/grafana/next/administration/api-keys/#migrate-api-keys-to-grafana-service-accounts-using-the-api. // // Responses: // 200: postAPIkeyResponse // 400: badRequestError // 401: unauthorisedError // 403: forbiddenError // 409: conflictError // 500: internalServerError func (hs *HTTPServer) AddAPIKey(c *contextmodel.ReqContext) response.Response { cmd := apikey.AddCommand{} if err := web.Bind(c.Req, &cmd); err != nil { return response.Error(http.StatusBadRequest, "bad request data", err) } if !cmd.Role.IsValid() { return response.Error(400, "Invalid role specified", nil) } if !c.OrgRole.Includes(cmd.Role) { return response.Error(http.StatusForbidden, "Cannot assign a role higher than user's role", nil) } if hs.Cfg.ApiKeyMaxSecondsToLive != -1 { if cmd.SecondsToLive == 0 { return response.Error(400, "Number of seconds before expiration should be set", nil) } if cmd.SecondsToLive > hs.Cfg.ApiKeyMaxSecondsToLive { return response.Error(400, "Number of seconds before expiration is greater than the global limit", nil) } } cmd.OrgID = c.OrgID newKeyInfo, err := apikeygen.New(cmd.OrgID, cmd.Name) if err != nil { return response.Error(500, "Generating API key failed", err) } cmd.Key = newKeyInfo.HashedKey key, err := hs.apiKeyService.AddAPIKey(c.Req.Context(), &cmd) if err != nil { if errors.Is(err, apikey.ErrInvalidExpiration) { return response.Error(400, err.Error(), nil) } if errors.Is(err, apikey.ErrDuplicate) { return response.Error(409, err.Error(), nil) } return response.Error(500, "Failed to add API Key", err) } result := &dtos.NewApiKeyResult{ ID: key.ID, Name: key.Name, Key: newKeyInfo.ClientSecret, } return response.JSON(http.StatusOK, result) } // swagger:parameters getAPIkeys type GetAPIkeysParams struct { // Show expired keys // in:query // required:false // default:false IncludeExpired bool `json:"includeExpired"` } // swagger:parameters addAPIkey type AddAPIkeyParams struct { // in:body // required:true Body apikey.AddCommand } // swagger:parameters deleteAPIkey type DeleteAPIkeyParams struct { // in:path // required:true ID int64 `json:"id"` } // swagger:response getAPIkeyResponse type GetAPIkeyResponse struct { // The response message // in: body Body []*dtos.ApiKeyDTO `json:"body"` } // swagger:response postAPIkeyResponse type PostAPIkeyResponse struct { // The response message // in: body Body dtos.NewApiKeyResult `json:"body"` }