mirror of
https://github.com/etcd-io/etcd.git
synced 2024-09-27 06:25:44 +00:00

This commit expands RPCs for getting user and role and support list up all users and roles. etcdctl v3 is now support getting all users and roles with the newly added option --all e.g. etcdctl user get --all
230 lines
8.9 KiB
Go
230 lines
8.9 KiB
Go
// Copyright 2016 The etcd Authors
|
|
//
|
|
// 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 clientv3
|
|
|
|
import (
|
|
"fmt"
|
|
"strings"
|
|
|
|
"github.com/coreos/etcd/auth/authpb"
|
|
pb "github.com/coreos/etcd/etcdserver/etcdserverpb"
|
|
"golang.org/x/net/context"
|
|
"google.golang.org/grpc"
|
|
)
|
|
|
|
type (
|
|
AuthEnableResponse pb.AuthEnableResponse
|
|
AuthDisableResponse pb.AuthDisableResponse
|
|
AuthenticateResponse pb.AuthenticateResponse
|
|
AuthUserAddResponse pb.AuthUserAddResponse
|
|
AuthUserDeleteResponse pb.AuthUserDeleteResponse
|
|
AuthUserChangePasswordResponse pb.AuthUserChangePasswordResponse
|
|
AuthUserGrantRoleResponse pb.AuthUserGrantRoleResponse
|
|
AuthUserGetResponse pb.AuthUserGetResponse
|
|
AuthUserRevokeRoleResponse pb.AuthUserRevokeRoleResponse
|
|
AuthRoleAddResponse pb.AuthRoleAddResponse
|
|
AuthRoleGrantPermissionResponse pb.AuthRoleGrantPermissionResponse
|
|
AuthRoleGetResponse pb.AuthRoleGetResponse
|
|
AuthRoleRevokePermissionResponse pb.AuthRoleRevokePermissionResponse
|
|
AuthRoleDeleteResponse pb.AuthRoleDeleteResponse
|
|
AuthUserListResponse pb.AuthUserListResponse
|
|
AuthRoleListResponse pb.AuthRoleListResponse
|
|
|
|
PermissionType authpb.Permission_Type
|
|
)
|
|
|
|
const (
|
|
PermRead = authpb.READ
|
|
PermWrite = authpb.WRITE
|
|
PermReadWrite = authpb.READWRITE
|
|
)
|
|
|
|
type Auth interface {
|
|
// AuthEnable enables auth of an etcd cluster.
|
|
AuthEnable(ctx context.Context) (*AuthEnableResponse, error)
|
|
|
|
// AuthDisable disables auth of an etcd cluster.
|
|
AuthDisable(ctx context.Context) (*AuthDisableResponse, error)
|
|
|
|
// UserAdd adds a new user to an etcd cluster.
|
|
UserAdd(ctx context.Context, name string, password string) (*AuthUserAddResponse, error)
|
|
|
|
// UserDelete deletes a user from an etcd cluster.
|
|
UserDelete(ctx context.Context, name string) (*AuthUserDeleteResponse, error)
|
|
|
|
// UserChangePassword changes a password of a user.
|
|
UserChangePassword(ctx context.Context, name string, password string) (*AuthUserChangePasswordResponse, error)
|
|
|
|
// UserGrantRole grants a role to a user.
|
|
UserGrantRole(ctx context.Context, user string, role string) (*AuthUserGrantRoleResponse, error)
|
|
|
|
// UserGet gets a detailed information of a user.
|
|
UserGet(ctx context.Context, name string) (*AuthUserGetResponse, error)
|
|
|
|
// UserList gets a list of all users.
|
|
UserList(ctx context.Context) (*AuthUserListResponse, error)
|
|
|
|
// UserRevokeRole revokes a role of a user.
|
|
UserRevokeRole(ctx context.Context, name string, role string) (*AuthUserRevokeRoleResponse, error)
|
|
|
|
// RoleAdd adds a new role to an etcd cluster.
|
|
RoleAdd(ctx context.Context, name string) (*AuthRoleAddResponse, error)
|
|
|
|
// RoleGrantPermission grants a permission to a role.
|
|
RoleGrantPermission(ctx context.Context, name string, key, rangeEnd string, permType PermissionType) (*AuthRoleGrantPermissionResponse, error)
|
|
|
|
// RoleGet gets a detailed information of a role.
|
|
RoleGet(ctx context.Context, role string) (*AuthRoleGetResponse, error)
|
|
|
|
// RoleList gets a list of all roles.
|
|
RoleList(ctx context.Context) (*AuthRoleListResponse, error)
|
|
|
|
// RoleRevokePermission revokes a permission from a role.
|
|
RoleRevokePermission(ctx context.Context, role string, key, rangeEnd string) (*AuthRoleRevokePermissionResponse, error)
|
|
|
|
// RoleDelete deletes a role.
|
|
RoleDelete(ctx context.Context, role string) (*AuthRoleDeleteResponse, error)
|
|
}
|
|
|
|
type auth struct {
|
|
c *Client
|
|
|
|
conn *grpc.ClientConn // conn in-use
|
|
remote pb.AuthClient
|
|
}
|
|
|
|
func NewAuth(c *Client) Auth {
|
|
conn := c.ActiveConnection()
|
|
return &auth{
|
|
conn: c.ActiveConnection(),
|
|
remote: pb.NewAuthClient(conn),
|
|
c: c,
|
|
}
|
|
}
|
|
|
|
func (auth *auth) AuthEnable(ctx context.Context) (*AuthEnableResponse, error) {
|
|
resp, err := auth.remote.AuthEnable(ctx, &pb.AuthEnableRequest{})
|
|
return (*AuthEnableResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) AuthDisable(ctx context.Context) (*AuthDisableResponse, error) {
|
|
resp, err := auth.remote.AuthDisable(ctx, &pb.AuthDisableRequest{})
|
|
return (*AuthDisableResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserAdd(ctx context.Context, name string, password string) (*AuthUserAddResponse, error) {
|
|
resp, err := auth.remote.UserAdd(ctx, &pb.AuthUserAddRequest{Name: name, Password: password})
|
|
return (*AuthUserAddResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserDelete(ctx context.Context, name string) (*AuthUserDeleteResponse, error) {
|
|
resp, err := auth.remote.UserDelete(ctx, &pb.AuthUserDeleteRequest{Name: name})
|
|
return (*AuthUserDeleteResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserChangePassword(ctx context.Context, name string, password string) (*AuthUserChangePasswordResponse, error) {
|
|
resp, err := auth.remote.UserChangePassword(ctx, &pb.AuthUserChangePasswordRequest{Name: name, Password: password})
|
|
return (*AuthUserChangePasswordResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserGrantRole(ctx context.Context, user string, role string) (*AuthUserGrantRoleResponse, error) {
|
|
resp, err := auth.remote.UserGrantRole(ctx, &pb.AuthUserGrantRoleRequest{User: user, Role: role})
|
|
return (*AuthUserGrantRoleResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserGet(ctx context.Context, name string) (*AuthUserGetResponse, error) {
|
|
resp, err := auth.remote.UserGet(ctx, &pb.AuthUserGetRequest{Name: name})
|
|
return (*AuthUserGetResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserList(ctx context.Context) (*AuthUserListResponse, error) {
|
|
resp, err := auth.remote.UserList(ctx, &pb.AuthUserListRequest{})
|
|
return (*AuthUserListResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) UserRevokeRole(ctx context.Context, name string, role string) (*AuthUserRevokeRoleResponse, error) {
|
|
resp, err := auth.remote.UserRevokeRole(ctx, &pb.AuthUserRevokeRoleRequest{Name: name, Role: role})
|
|
return (*AuthUserRevokeRoleResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) RoleAdd(ctx context.Context, name string) (*AuthRoleAddResponse, error) {
|
|
resp, err := auth.remote.RoleAdd(ctx, &pb.AuthRoleAddRequest{Name: name})
|
|
return (*AuthRoleAddResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) RoleGrantPermission(ctx context.Context, name string, key, rangeEnd string, permType PermissionType) (*AuthRoleGrantPermissionResponse, error) {
|
|
perm := &authpb.Permission{
|
|
Key: []byte(key),
|
|
RangeEnd: []byte(rangeEnd),
|
|
PermType: authpb.Permission_Type(permType),
|
|
}
|
|
resp, err := auth.remote.RoleGrantPermission(ctx, &pb.AuthRoleGrantPermissionRequest{Name: name, Perm: perm})
|
|
return (*AuthRoleGrantPermissionResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) RoleGet(ctx context.Context, role string) (*AuthRoleGetResponse, error) {
|
|
resp, err := auth.remote.RoleGet(ctx, &pb.AuthRoleGetRequest{Role: role})
|
|
return (*AuthRoleGetResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) RoleList(ctx context.Context) (*AuthRoleListResponse, error) {
|
|
resp, err := auth.remote.RoleList(ctx, &pb.AuthRoleListRequest{})
|
|
return (*AuthRoleListResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) RoleRevokePermission(ctx context.Context, role string, key, rangeEnd string) (*AuthRoleRevokePermissionResponse, error) {
|
|
resp, err := auth.remote.RoleRevokePermission(ctx, &pb.AuthRoleRevokePermissionRequest{Role: role, Key: key, RangeEnd: rangeEnd})
|
|
return (*AuthRoleRevokePermissionResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *auth) RoleDelete(ctx context.Context, role string) (*AuthRoleDeleteResponse, error) {
|
|
resp, err := auth.remote.RoleDelete(ctx, &pb.AuthRoleDeleteRequest{Role: role})
|
|
return (*AuthRoleDeleteResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func StrToPermissionType(s string) (PermissionType, error) {
|
|
val, ok := authpb.Permission_Type_value[strings.ToUpper(s)]
|
|
if ok {
|
|
return PermissionType(val), nil
|
|
}
|
|
return PermissionType(-1), fmt.Errorf("invalid permission type: %s", s)
|
|
}
|
|
|
|
type authenticator struct {
|
|
conn *grpc.ClientConn // conn in-use
|
|
remote pb.AuthClient
|
|
}
|
|
|
|
func (auth *authenticator) authenticate(ctx context.Context, name string, password string) (*AuthenticateResponse, error) {
|
|
resp, err := auth.remote.Authenticate(ctx, &pb.AuthenticateRequest{Name: name, Password: password})
|
|
return (*AuthenticateResponse)(resp), toErr(ctx, err)
|
|
}
|
|
|
|
func (auth *authenticator) close() {
|
|
auth.conn.Close()
|
|
}
|
|
|
|
func newAuthenticator(endpoint string, opts []grpc.DialOption) (*authenticator, error) {
|
|
conn, err := grpc.Dial(endpoint, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return &authenticator{
|
|
conn: conn,
|
|
remote: pb.NewAuthClient(conn),
|
|
}, nil
|
|
}
|