2016-12-16 07:26:15 +01:00
|
|
|
/*
|
2019-04-09 20:39:42 +02:00
|
|
|
* MinIO Cloud Storage, (C) 2016, 2017, 2018, 2019 MinIO, Inc.
|
2016-12-16 07:26:15 +01:00
|
|
|
*
|
|
|
|
* 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 cmd
|
|
|
|
|
2018-01-22 23:54:55 +01:00
|
|
|
import (
|
|
|
|
"net/http"
|
|
|
|
|
2018-04-22 04:23:54 +02:00
|
|
|
"github.com/gorilla/mux"
|
2019-10-23 06:01:14 +02:00
|
|
|
"github.com/minio/minio/pkg/madmin"
|
2018-01-22 23:54:55 +01:00
|
|
|
)
|
|
|
|
|
|
|
|
const (
|
2020-04-08 04:30:59 +02:00
|
|
|
adminPathPrefix = minioReservedBucketPath + "/admin"
|
|
|
|
adminAPIVersionV2 = madmin.AdminAPIVersionV2
|
|
|
|
adminAPIVersion = madmin.AdminAPIVersion
|
|
|
|
adminAPIVersionPrefix = SlashSeparator + adminAPIVersion
|
|
|
|
adminAPIVersionV2Prefix = SlashSeparator + adminAPIVersionV2
|
2018-01-22 23:54:55 +01:00
|
|
|
)
|
2016-12-16 07:26:15 +01:00
|
|
|
|
2019-04-09 20:39:42 +02:00
|
|
|
// adminAPIHandlers provides HTTP handlers for MinIO admin API.
|
2019-11-04 18:30:59 +01:00
|
|
|
type adminAPIHandlers struct{}
|
2016-12-16 07:26:15 +01:00
|
|
|
|
|
|
|
// registerAdminRouter - Add handler functions for each service REST API routes.
|
2020-05-25 09:17:52 +02:00
|
|
|
func registerAdminRouter(router *mux.Router, enableConfigOps, enableIAMOps bool) {
|
2016-12-16 07:26:15 +01:00
|
|
|
|
|
|
|
adminAPI := adminAPIHandlers{}
|
|
|
|
// Admin router
|
2019-11-04 18:30:59 +01:00
|
|
|
adminRouter := router.PathPrefix(adminPathPrefix).Subrouter()
|
2018-01-22 23:54:55 +01:00
|
|
|
|
2017-01-04 08:39:22 +01:00
|
|
|
/// Service operations
|
2016-12-16 07:26:15 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
adminVersions := []string{
|
|
|
|
adminAPIVersionPrefix,
|
|
|
|
adminAPIVersionV2Prefix,
|
|
|
|
}
|
2017-01-04 08:39:22 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
for _, adminVersion := range adminVersions {
|
|
|
|
// Restart and stop MinIO service.
|
2020-05-11 19:34:08 +02:00
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion+"/service").HandlerFunc(httpTraceAll(adminAPI.ServiceHandler)).Queries("action", "{action:.*}")
|
2020-04-08 04:30:59 +02:00
|
|
|
// Update MinIO servers.
|
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion+"/update").HandlerFunc(httpTraceAll(adminAPI.ServerUpdateHandler)).Queries("updateURL", "{updateURL:.*}")
|
2019-10-23 06:01:14 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Info operations
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/info").HandlerFunc(httpTraceAll(adminAPI.ServerInfoHandler))
|
2017-02-15 19:45:45 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// StorageInfo operations
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/storageinfo").HandlerFunc(httpTraceAll(adminAPI.StorageInfoHandler))
|
|
|
|
// DataUsageInfo operations
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/datausageinfo").HandlerFunc(httpTraceAll(adminAPI.DataUsageInfoHandler))
|
2020-02-05 03:20:39 +01:00
|
|
|
|
2020-06-13 05:04:01 +02:00
|
|
|
if globalIsDistErasure || globalIsErasure {
|
2020-04-08 04:30:59 +02:00
|
|
|
/// Heal operations
|
2018-12-31 18:46:44 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Heal processing endpoint.
|
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion + "/heal/").HandlerFunc(httpTraceAll(adminAPI.HealHandler))
|
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion + "/heal/{bucket}").HandlerFunc(httpTraceAll(adminAPI.HealHandler))
|
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion + "/heal/{bucket}/{prefix:.*}").HandlerFunc(httpTraceAll(adminAPI.HealHandler))
|
2019-06-26 01:42:24 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion + "/background-heal/status").HandlerFunc(httpTraceAll(adminAPI.BackgroundHealStatusHandler))
|
2018-12-31 18:46:44 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
/// Health operations
|
2019-10-23 07:59:13 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
}
|
2018-10-09 23:00:01 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Profiling operations
|
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion+"/profiling/start").HandlerFunc(httpTraceAll(adminAPI.StartProfilingHandler)).
|
|
|
|
Queries("profilerType", "{profilerType:.*}")
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/profiling/download").HandlerFunc(httpTraceAll(adminAPI.DownloadProfilingHandler))
|
2018-10-13 09:18:43 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Config KV operations.
|
|
|
|
if enableConfigOps {
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/get-config-kv").HandlerFunc(httpTraceHdrs(adminAPI.GetConfigKVHandler)).Queries("key", "{key:.*}")
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion + "/set-config-kv").HandlerFunc(httpTraceHdrs(adminAPI.SetConfigKVHandler))
|
|
|
|
adminRouter.Methods(http.MethodDelete).Path(adminVersion + "/del-config-kv").HandlerFunc(httpTraceHdrs(adminAPI.DelConfigKVHandler))
|
2020-04-16 23:49:12 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Enable config help in all modes.
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/help-config-kv").HandlerFunc(httpTraceAll(adminAPI.HelpConfigKVHandler)).Queries("subSys", "{subSys:.*}", "key", "{key:.*}")
|
|
|
|
|
|
|
|
// Config KV history operations.
|
|
|
|
if enableConfigOps {
|
2020-04-08 04:30:59 +02:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/list-config-history-kv").HandlerFunc(httpTraceAll(adminAPI.ListConfigHistoryKVHandler)).Queries("count", "{count:[0-9]+}")
|
|
|
|
adminRouter.Methods(http.MethodDelete).Path(adminVersion+"/clear-config-history-kv").HandlerFunc(httpTraceHdrs(adminAPI.ClearConfigHistoryKVHandler)).Queries("restoreId", "{restoreId:.*}")
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/restore-config-history-kv").HandlerFunc(httpTraceHdrs(adminAPI.RestoreConfigHistoryKVHandler)).Queries("restoreId", "{restoreId:.*}")
|
|
|
|
}
|
2018-10-16 21:48:19 +02:00
|
|
|
|
2020-04-16 23:49:12 +02:00
|
|
|
/// Config import/export bulk operations
|
2020-04-08 04:30:59 +02:00
|
|
|
if enableConfigOps {
|
|
|
|
// Get config
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/config").HandlerFunc(httpTraceHdrs(adminAPI.GetConfigHandler))
|
|
|
|
// Set config
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion + "/config").HandlerFunc(httpTraceHdrs(adminAPI.SetConfigHandler))
|
|
|
|
}
|
2018-10-16 21:48:19 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
if enableIAMOps {
|
|
|
|
// -- IAM APIs --
|
2020-03-17 18:36:13 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Add policy IAM
|
2021-02-13 08:05:09 +01:00
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/add-canned-policy").HandlerFunc(httpTraceAll(adminAPI.AddCannedPolicy)).Queries("name", "{name:.*}")
|
2019-09-26 20:23:13 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Add user IAM
|
2020-11-28 02:23:57 +01:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/accountinfo").HandlerFunc(httpTraceAll(adminAPI.AccountInfoHandler))
|
2020-05-16 03:16:45 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/add-user").HandlerFunc(httpTraceHdrs(adminAPI.AddUser)).Queries("accessKey", "{accessKey:.*}")
|
2018-10-09 23:00:01 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/set-user-status").HandlerFunc(httpTraceHdrs(adminAPI.SetUserStatus)).Queries("accessKey", "{accessKey:.*}").Queries("status", "{status:.*}")
|
2019-08-13 22:41:06 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Service accounts ops
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion + "/add-service-account").HandlerFunc(httpTraceHdrs(adminAPI.AddServiceAccount))
|
2021-04-15 07:51:14 +02:00
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion+"/update-service-account").HandlerFunc(httpTraceHdrs(adminAPI.UpdateServiceAccount)).Queries("accessKey", "{accessKey:.*}")
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/info-service-account").HandlerFunc(httpTraceHdrs(adminAPI.InfoServiceAccount)).Queries("accessKey", "{accessKey:.*}")
|
2020-04-24 21:10:09 +02:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/list-service-accounts").HandlerFunc(httpTraceHdrs(adminAPI.ListServiceAccounts))
|
|
|
|
adminRouter.Methods(http.MethodDelete).Path(adminVersion+"/delete-service-account").HandlerFunc(httpTraceHdrs(adminAPI.DeleteServiceAccount)).Queries("accessKey", "{accessKey:.*}")
|
2018-10-09 23:00:01 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
if adminVersion == adminAPIVersionV2Prefix {
|
|
|
|
// Info policy IAM v2
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/info-canned-policy").HandlerFunc(httpTraceHdrs(adminAPI.InfoCannedPolicyV2)).Queries("name", "{name:.*}")
|
2018-10-13 09:18:43 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// List policies v2
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/list-canned-policies").HandlerFunc(httpTraceHdrs(adminAPI.ListCannedPoliciesV2))
|
|
|
|
} else {
|
|
|
|
// Info policy IAM latest
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/info-canned-policy").HandlerFunc(httpTraceHdrs(adminAPI.InfoCannedPolicy)).Queries("name", "{name:.*}")
|
2019-08-13 22:41:06 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// List policies latest
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/list-canned-policies").HandlerFunc(httpTraceHdrs(adminAPI.ListCannedPolicies))
|
|
|
|
}
|
2019-08-02 23:25:00 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Remove policy IAM
|
|
|
|
adminRouter.Methods(http.MethodDelete).Path(adminVersion+"/remove-canned-policy").HandlerFunc(httpTraceHdrs(adminAPI.RemoveCannedPolicy)).Queries("name", "{name:.*}")
|
2019-08-02 23:25:00 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Set user or group policy
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/set-user-or-group-policy").
|
|
|
|
HandlerFunc(httpTraceHdrs(adminAPI.SetPolicyForUserOrGroup)).
|
|
|
|
Queries("policyName", "{policyName:.*}", "userOrGroup", "{userOrGroup:.*}", "isGroup", "{isGroup:true|false}")
|
2019-08-02 23:25:00 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Remove user IAM
|
|
|
|
adminRouter.Methods(http.MethodDelete).Path(adminVersion+"/remove-user").HandlerFunc(httpTraceHdrs(adminAPI.RemoveUser)).Queries("accessKey", "{accessKey:.*}")
|
2019-08-02 23:25:00 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// List users
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/list-users").HandlerFunc(httpTraceHdrs(adminAPI.ListUsers))
|
2018-10-18 02:25:16 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// User info
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/user-info").HandlerFunc(httpTraceHdrs(adminAPI.GetUserInfo)).Queries("accessKey", "{accessKey:.*}")
|
|
|
|
|
|
|
|
// Add/Remove members from group
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion + "/update-group-members").HandlerFunc(httpTraceHdrs(adminAPI.UpdateGroupMembers))
|
|
|
|
|
|
|
|
// Get Group
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/group").HandlerFunc(httpTraceHdrs(adminAPI.GetGroup)).Queries("group", "{group:.*}")
|
|
|
|
|
|
|
|
// List Groups
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/groups").HandlerFunc(httpTraceHdrs(adminAPI.ListGroups))
|
|
|
|
|
|
|
|
// Set Group Status
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/set-group-status").HandlerFunc(httpTraceHdrs(adminAPI.SetGroupStatus)).Queries("group", "{group:.*}").Queries("status", "{status:.*}")
|
2020-05-01 00:55:54 +02:00
|
|
|
}
|
2020-04-08 04:30:59 +02:00
|
|
|
|
2020-06-13 05:04:01 +02:00
|
|
|
if globalIsDistErasure || globalIsErasure {
|
2021-01-04 18:43:31 +01:00
|
|
|
// GetBucketQuotaConfig
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/get-bucket-quota").HandlerFunc(
|
|
|
|
httpTraceHdrs(adminAPI.GetBucketQuotaConfigHandler)).Queries("bucket", "{bucket:.*}")
|
|
|
|
// PutBucketQuotaConfig
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/set-bucket-quota").HandlerFunc(
|
|
|
|
httpTraceHdrs(adminAPI.PutBucketQuotaConfigHandler)).Queries("bucket", "{bucket:.*}")
|
|
|
|
|
|
|
|
// Bucket replication operations
|
|
|
|
// GetBucketTargetHandler
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion+"/list-remote-targets").HandlerFunc(
|
|
|
|
httpTraceHdrs(adminAPI.ListRemoteTargetsHandler)).Queries("bucket", "{bucket:.*}", "type", "{type:.*}")
|
|
|
|
// SetRemoteTargetHandler
|
|
|
|
adminRouter.Methods(http.MethodPut).Path(adminVersion+"/set-remote-target").HandlerFunc(
|
|
|
|
httpTraceHdrs(adminAPI.SetRemoteTargetHandler)).Queries("bucket", "{bucket:.*}")
|
|
|
|
// RemoveRemoteTargetHandler
|
|
|
|
adminRouter.Methods(http.MethodDelete).Path(adminVersion+"/remove-remote-target").HandlerFunc(
|
|
|
|
httpTraceHdrs(adminAPI.RemoveRemoteTargetHandler)).Queries("bucket", "{bucket:.*}", "arn", "{arn:.*}")
|
2020-04-08 04:30:59 +02:00
|
|
|
}
|
2021-01-04 18:43:31 +01:00
|
|
|
|
2020-06-13 05:04:01 +02:00
|
|
|
if globalIsDistErasure {
|
2021-01-25 19:01:27 +01:00
|
|
|
// Top locks
|
2020-04-08 04:30:59 +02:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/top/locks").HandlerFunc(httpTraceHdrs(adminAPI.TopLocksHandler))
|
2021-01-25 19:01:27 +01:00
|
|
|
// Force unlocks paths
|
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion+"/force-unlock").
|
|
|
|
Queries("paths", "{paths:.*}").HandlerFunc(httpTraceHdrs(adminAPI.ForceUnlockHandler))
|
2020-04-08 04:30:59 +02:00
|
|
|
}
|
2019-01-24 16:22:14 +01:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// HTTP Trace
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/trace").HandlerFunc(adminAPI.TraceHandler)
|
2019-09-04 22:19:44 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// Console Logs
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/log").HandlerFunc(httpTraceAll(adminAPI.ConsoleLogHandler))
|
2019-09-03 20:10:48 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
// -- KMS APIs --
|
|
|
|
//
|
2020-07-09 03:50:43 +02:00
|
|
|
adminRouter.Methods(http.MethodPost).Path(adminVersion+"/kms/key/create").HandlerFunc(httpTraceAll(adminAPI.KMSCreateKeyHandler)).Queries("key-id", "{key-id:.*}")
|
2020-04-08 04:30:59 +02:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/kms/key/status").HandlerFunc(httpTraceAll(adminAPI.KMSKeyStatusHandler))
|
2019-09-04 22:19:44 +02:00
|
|
|
|
2020-04-08 04:30:59 +02:00
|
|
|
if !globalIsGateway {
|
2020-11-20 21:52:53 +01:00
|
|
|
// Keep obdinfo for backward compatibility with mc
|
2020-09-16 03:02:54 +02:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/obdinfo").
|
2020-11-20 21:52:53 +01:00
|
|
|
HandlerFunc(httpTraceHdrs(adminAPI.HealthInfoHandler))
|
|
|
|
// -- Health API --
|
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/healthinfo").
|
|
|
|
HandlerFunc(httpTraceHdrs(adminAPI.HealthInfoHandler))
|
2020-10-10 05:36:00 +02:00
|
|
|
adminRouter.Methods(http.MethodGet).Path(adminVersion + "/bandwidth").
|
|
|
|
HandlerFunc(httpTraceHdrs(adminAPI.BandwidthMonitorHandler))
|
2020-04-08 04:30:59 +02:00
|
|
|
}
|
2020-03-27 05:07:39 +01:00
|
|
|
}
|
|
|
|
|
2019-11-04 18:30:59 +01:00
|
|
|
// If none of the routes match add default error handler routes
|
2020-09-28 22:33:49 +02:00
|
|
|
adminRouter.NotFoundHandler = httpTraceAll(errorResponseHandler)
|
2020-10-28 17:18:35 +01:00
|
|
|
adminRouter.MethodNotAllowedHandler = httpTraceAll(methodNotAllowedHandler("Admin"))
|
2016-12-16 07:26:15 +01:00
|
|
|
}
|