github.com/minio/mc@v0.0.0-20240503112107-b471de8d1882/cmd/admin-kms-key-create.go (about)

     1  // Copyright (c) 2015-2022 MinIO, Inc.
     2  //
     3  // This file is part of MinIO Object Storage stack
     4  //
     5  // This program is free software: you can redistribute it and/or modify
     6  // it under the terms of the GNU Affero General Public License as published by
     7  // the Free Software Foundation, either version 3 of the License, or
     8  // (at your option) any later version.
     9  //
    10  // This program is distributed in the hope that it will be useful
    11  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    12  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    13  // GNU Affero General Public License for more details.
    14  //
    15  // You should have received a copy of the GNU Affero General Public License
    16  // along with this program.  If not, see <http://www.gnu.org/licenses/>.
    17  
    18  package cmd
    19  
    20  import (
    21  	"fmt"
    22  	"os"
    23  
    24  	"github.com/fatih/color"
    25  	"github.com/minio/cli"
    26  	"github.com/minio/mc/pkg/probe"
    27  	"github.com/minio/pkg/v2/console"
    28  	"golang.org/x/term"
    29  )
    30  
    31  var adminKMSCreateKeyCmd = cli.Command{
    32  	Name:         "create",
    33  	Usage:        "creates a new master KMS key",
    34  	Action:       mainAdminKMSCreateKey,
    35  	OnUsageError: onUsageError,
    36  	Before:       setGlobalsFromContext,
    37  	Flags:        globalFlags,
    38  	CustomHelpTemplate: `NAME:
    39    {{.HelpName}} - {{.Usage}}
    40  
    41  USAGE:
    42    {{.HelpName}} TARGET [KEY_NAME]
    43  
    44  FLAGS:
    45    {{range .VisibleFlags}}{{.}}
    46    {{end}}
    47  EXAMPLES:
    48    1. Create a new master key named 'my-key' default master key.
    49       $ {{.HelpName}} play my-key
    50  `,
    51  }
    52  
    53  // adminKMSCreateKeyCmd is the handler for the "mc admin kms key create" command.
    54  func mainAdminKMSCreateKey(ctx *cli.Context) error {
    55  	if len(ctx.Args()) != 2 {
    56  		showCommandHelpAndExit(ctx, 1) // last argument is exit code
    57  	}
    58  
    59  	client, err := newAdminClient(ctx.Args().Get(0))
    60  	fatalIf(err, "Cannot get a configured admin connection.")
    61  
    62  	keyID := ctx.Args().Get(1)
    63  	e := client.CreateKey(globalContext, keyID)
    64  	fatalIf(probe.NewError(e), "Failed to create master key")
    65  
    66  	if term.IsTerminal(int(os.Stdout.Fd())) {
    67  		console.Println(color.GreenString(fmt.Sprintf("Created master key `%s` successfully", keyID)))
    68  	}
    69  	return nil
    70  }