versitygw/cmd/internal/gwcli/iam.go

// Copyright 2026 Versity Software
// This file is 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 gwcli

import (
	"github.com/urfave/cli/v2"
)

// RunIAM starts the standalone IAM API server for the given command
// context. The hosting binary's main package must set this before running
// the "iam" command.
var RunIAM func(ctx *cli.Context) error

// IAMCommand returns the "iam" subcommand, common to all versitygw binaries.
func IAMCommand() *cli.Command {
	return &cli.Command{
		Name:        "iam",
		Usage:       "IAM API server",
		Description: "Run the standalone IAM API server.",
		Action: func(ctx *cli.Context) error {
			return RunIAM(ctx)
		},
		Flags: []cli.Flag{
			&cli.StringFlag{
				Name:    "dir",
				Usage:   "directory path for file-backed IAM storage",
				EnvVars: []string{"VGW_IAM_DIR"},
			},
			&cli.StringFlag{
				Name:    "vault-endpoint-url",
				Usage:   "vault server url for IAM storage",
				EnvVars: []string{"VGW_IAM_VAULT_ENDPOINT_URL"},
			},
			&cli.StringFlag{
				Name:    "vault-namespace",
				Usage:   "fallback vault namespace for IAM storage (overridden by vault-auth-namespace / vault-secret-storage-namespace)",
				EnvVars: []string{"VGW_IAM_VAULT_NAMESPACE"},
			},
			&cli.StringFlag{
				Name:    "vault-secret-storage-path",
				Usage:   "vault KV v2 path prefix for IAM user storage (default: iam)",
				EnvVars: []string{"VGW_IAM_VAULT_SECRET_STORAGE_PATH"},
			},
			&cli.StringFlag{
				Name:    "vault-secret-storage-namespace",
				Usage:   "vault namespace for KV v2 IAM storage (overrides vault-namespace)",
				EnvVars: []string{"VGW_IAM_VAULT_SECRET_STORAGE_NAMESPACE"},
			},
			&cli.StringFlag{
				Name:    "vault-auth-method",
				Usage:   "vault auth method mount path (default: approle)",
				EnvVars: []string{"VGW_IAM_VAULT_AUTH_METHOD"},
			},
			&cli.StringFlag{
				Name:    "vault-auth-namespace",
				Usage:   "vault namespace for AppRole login (overrides vault-namespace)",
				EnvVars: []string{"VGW_IAM_VAULT_AUTH_NAMESPACE"},
			},
			&cli.StringFlag{
				Name:    "vault-mount-path",
				Usage:   "vault KV v2 engine mount path (default: kv-v2)",
				EnvVars: []string{"VGW_IAM_VAULT_MOUNT_PATH"},
			},
			&cli.StringFlag{
				Name:    "vault-root-token",
				Usage:   "vault root token for authentication (mutually exclusive with vault-role-id/vault-role-secret)",
				EnvVars: []string{"VGW_IAM_VAULT_ROOT_TOKEN"},
			},
			&cli.StringFlag{
				Name:    "vault-role-id",
				Usage:   "vault AppRole role ID for authentication",
				EnvVars: []string{"VGW_IAM_VAULT_ROLE_ID"},
			},
			&cli.StringFlag{
				Name:    "vault-role-secret",
				Usage:   "vault AppRole secret ID for authentication",
				EnvVars: []string{"VGW_IAM_VAULT_ROLE_SECRET"},
			},
			&cli.StringFlag{
				Name:    "vault-server-cert",
				Usage:   "PEM-encoded vault server TLS certificate for verification",
				EnvVars: []string{"VGW_IAM_VAULT_SERVER_CERT"},
			},
			&cli.StringFlag{
				Name:    "vault-client-cert",
				Usage:   "PEM-encoded client TLS certificate presented to vault",
				EnvVars: []string{"VGW_IAM_VAULT_CLIENT_CERT"},
			},
			&cli.StringFlag{
				Name:    "vault-client-cert-key",
				Usage:   "PEM-encoded private key for vault-client-cert",
				EnvVars: []string{"VGW_IAM_VAULT_CLIENT_CERT_KEY"},
			},
			&cli.BoolFlag{
				Name:    "quiet",
				Usage:   "silence stdout request logging output",
				EnvVars: []string{"VGW_QUIET"},
				Aliases: []string{"q"},
			},
		},
	}
}