Skip to content

Modern Docker Management, Designed for Everyone

4.3 KB
Raw Blame
package federated

import (
	"net/http"

	"github.com/danielgtaylor/huma/v2"
	"github.com/getarcaneapp/arcane/types/v2/federated"
	"github.com/labstack/echo/v5"

	"github.com/getarcaneapp/arcane/backend/v2/internal/middleware"
	"github.com/getarcaneapp/arcane/backend/v2/pkg/authz"
	"github.com/getarcaneapp/arcane/backend/v2/pkg/utils/handlerutil"
)

// RegisterFederatedTokenExchange registers the public RFC 8693 token exchange
// endpoint. It intentionally uses Echo because the standard requires form
// encoding while the rest of Arcane's Huma API is JSON-first.
func RegisterFederatedTokenExchange(g *echo.Group, federatedCredentialService *FederatedCredentialService) {
	g.POST("/auth/federated/token", func(c *echo.Context) error {
		if federatedCredentialService == nil {
			return c.JSON(http.StatusInternalServerError, federatedTokenExchangeError{
				Error:            "server_error",
				ErrorDescription: "service not available",
			})
		}
		if err := c.Request().ParseForm(); err != nil {
			return c.JSON(http.StatusBadRequest, federatedTokenExchangeError{
				Error:            "invalid_request",
				ErrorDescription: "invalid token exchange request",
			})
		}

		form := c.Request().Form
		resp, err := federatedCredentialService.ExchangeToken(c.Request().Context(), federated.TokenExchangeRequest{
			GrantType:          form.Get("grant_type"),
			SubjectToken:       form.Get("subject_token"),
			SubjectTokenType:   form.Get("subject_token_type"),
			Audience:           form.Get("audience"),
			Scope:              form.Get("scope"),
			RequestedTokenType: form.Get("requested_token_type"),
		})
		if err != nil {
			return writeFederatedTokenExchangeErrorInternal(c, err)
		}
		return c.JSON(http.StatusOK, resp)
	})
}

// RegisterFederatedCredentials registers federated credential management routes.
func RegisterFederatedCredentials(api huma.API, federatedCredentialService *FederatedCredentialService) {
	h := &FederatedCredentialHandler{
		federatedCredentialService: federatedCredentialService,
	}

	huma.Register(api, huma.Operation{
		OperationID: "list-federated-credentials",
		Method:      http.MethodGet,
		Path:        "/federated-credentials",
		Summary:     "List federated credentials",
		Description: "Get a paginated list of workload identity federation trust rules",
		Tags:        []string{"Federated Credentials"},
		Security:    handlerutil.DefaultOperationSecurity(),
		Middlewares: middleware.RequirePermission(api, authz.PermFederatedList),
	}, h.ListFederatedCredentials)

	huma.Register(api, huma.Operation{
		OperationID: "create-federated-credential",
		Method:      http.MethodPost,
		Path:        "/federated-credentials",
		Summary:     "Create a federated credential",
		Description: "Create a workload identity federation trust rule",
		Tags:        []string{"Federated Credentials"},
		Security:    handlerutil.DefaultOperationSecurity(),
		Middlewares: middleware.RequireGlobalAdmin(api),
	}, h.CreateFederatedCredential)

	huma.Register(api, huma.Operation{
		OperationID: "get-federated-credential",
		Method:      http.MethodGet,
		Path:        "/federated-credentials/{id}",
		Summary:     "Get a federated credential",
		Description: "Get details of a workload identity federation trust rule",
		Tags:        []string{"Federated Credentials"},
		Security:    handlerutil.DefaultOperationSecurity(),
		Middlewares: middleware.RequirePermission(api, authz.PermFederatedRead),
	}, h.GetFederatedCredential)

	huma.Register(api, huma.Operation{
		OperationID: "update-federated-credential",
		Method:      http.MethodPut,
		Path:        "/federated-credentials/{id}",
		Summary:     "Update a federated credential",
		Description: "Update a workload identity federation trust rule",
		Tags:        []string{"Federated Credentials"},
		Security:    handlerutil.DefaultOperationSecurity(),
		Middlewares: middleware.RequireGlobalAdmin(api),
	}, h.UpdateFederatedCredential)

	huma.Register(api, huma.Operation{
		OperationID: "delete-federated-credential",
		Method:      http.MethodDelete,
		Path:        "/federated-credentials/{id}",
		Summary:     "Delete a federated credential",
		Description: "Delete a workload identity federation trust rule and its service user",
		Tags:        []string{"Federated Credentials"},
		Security:    handlerutil.DefaultOperationSecurity(),
		Middlewares: middleware.RequireGlobalAdmin(api),
	}, h.DeleteFederatedCredential)
}