Pulse/pkg/proxmox/client_request_test.go
pulse-triage[bot] 75a240ad1c Classify offline Proxmox node failures accurately
Treat node-scoped HTTP 595 responses as debug-level resource unavailability instead of repeated authentication warnings. Preserve warnings and returned errors for real credential failures.

Refs #1794.

Contract-Neutral: corrects internal log severity without changing API, resource, or extension contracts
Change-source: pulse-maintainer
2026-08-29 13:16:21 +01:00

308 lines
8.1 KiB
Go

package proxmox
import (
"context"
"fmt"
"io"
"net/http"
"net/http/httptest"
"strings"
"sync/atomic"
"testing"
)
func TestClientRequest_403TokenPermissionHint(t *testing.T) {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusForbidden)
w.Write([]byte("forbidden"))
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
TokenName: "user@pve!token",
TokenValue: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
_, err = client.get(context.Background(), "/nodes/node1/status")
if err == nil {
t.Fatal("expected error")
}
msg := err.Error()
if !strings.Contains(msg, "authentication error") {
t.Fatalf("expected authentication error, got %q", msg)
}
if !strings.Contains(msg, "does not have sufficient permissions") {
t.Fatalf("expected permission hint, got %q", msg)
}
if !strings.Contains(msg, "user@pve") {
t.Fatalf("expected user in error message, got %q", msg)
}
}
func TestClientRequest_595NodeSpecific(t *testing.T) {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(595)
w.Write([]byte("no ticket"))
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
TokenName: "user@pve!token",
TokenValue: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
_, err = client.get(context.Background(), "/nodes/node1/status")
if err == nil {
t.Fatal("expected error")
}
if !strings.Contains(err.Error(), "Cannot access node resource") {
t.Fatalf("unexpected error: %v", err)
}
}
func TestClassifyAPIErrorLog(t *testing.T) {
t.Parallel()
tests := []struct {
name string
status int
path string
wantLevel apiErrorLogLevel
wantMsg string
}{
{
name: "offline node resource is diagnostic",
status: 595,
path: "/api2/json/nodes/proxmox1/lxc/217/config",
wantLevel: apiErrorLogDebug,
wantMsg: "Proxmox node resource unavailable",
},
{
name: "cluster scoped 595 remains authentication warning",
status: 595,
path: "/api2/json/cluster/status",
wantLevel: apiErrorLogWarn,
wantMsg: "Proxmox authentication error",
},
{
name: "unauthorized remains authentication warning",
status: http.StatusUnauthorized,
path: "/api2/json/nodes",
wantLevel: apiErrorLogWarn,
wantMsg: "Proxmox authentication error",
},
{
name: "optional apt permission remains diagnostic",
status: http.StatusForbidden,
path: "/api2/json/nodes/proxmox1/apt/update",
wantLevel: apiErrorLogDebug,
wantMsg: "Proxmox permission error (optional endpoint)",
},
{
name: "server error is not logged here",
status: http.StatusInternalServerError,
path: "/api2/json/nodes",
wantLevel: apiErrorLogNone,
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
t.Parallel()
gotLevel, gotMsg := classifyAPIErrorLog(tt.status, tt.path)
if gotLevel != tt.wantLevel || gotMsg != tt.wantMsg {
t.Fatalf("classifyAPIErrorLog(%d, %q) = (%v, %q), want (%v, %q)", tt.status, tt.path, gotLevel, gotMsg, tt.wantLevel, tt.wantMsg)
}
})
}
}
func TestClientRequest_595Auth(t *testing.T) {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(595)
w.Write([]byte("no ticket"))
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
TokenName: "user@pve!token",
TokenValue: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
_, err = client.get(context.Background(), "/cluster/status")
if err == nil {
t.Fatal("expected error")
}
if !strings.Contains(err.Error(), "Authentication failed") {
t.Fatalf("unexpected error: %v", err)
}
}
func TestClientRequest_401Unauthorized(t *testing.T) {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusUnauthorized)
w.Write([]byte("unauthorized"))
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
TokenName: "user@pve!token",
TokenValue: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
_, err = client.get(context.Background(), "/nodes")
if err == nil {
t.Fatal("expected error")
}
if !strings.Contains(err.Error(), "API error 401") {
t.Fatalf("unexpected error: %v", err)
}
}
func TestClientRequest_401PasswordAuthReauthAndRetry(t *testing.T) {
var authCalls int32
var nodeCalls int32
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
switch r.URL.Path {
case "/api2/json/access/ticket":
call := atomic.AddInt32(&authCalls, 1)
fmt.Fprintf(w, `{"data":{"ticket":"ticket-%d","CSRFPreventionToken":"csrf-%d"}}`, call, call)
case "/api2/json/nodes":
call := atomic.AddInt32(&nodeCalls, 1)
cookie := r.Header.Get("Cookie")
if call == 1 {
if !strings.Contains(cookie, "ticket-1") {
t.Fatalf("first request missing initial ticket, got %q", cookie)
}
w.WriteHeader(http.StatusUnauthorized)
w.Write([]byte("ticket expired"))
return
}
if !strings.Contains(cookie, "ticket-2") {
t.Fatalf("retry request missing refreshed ticket, got %q", cookie)
}
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"data":[]}`))
default:
t.Fatalf("unexpected path: %s", r.URL.Path)
}
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
User: "user@pam",
Password: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
resp, err := client.get(context.Background(), "/nodes")
if err != nil {
t.Fatalf("expected retry to succeed, got %v", err)
}
defer resp.Body.Close()
_, _ = io.ReadAll(resp.Body)
if got := atomic.LoadInt32(&authCalls); got != 2 {
t.Fatalf("expected 2 auth calls (initial + refresh), got %d", got)
}
if got := atomic.LoadInt32(&nodeCalls); got != 2 {
t.Fatalf("expected 2 node calls (initial + retry), got %d", got)
}
}
func TestClientRequest_401PasswordAuthReauthFailure(t *testing.T) {
var authCalls int32
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
switch r.URL.Path {
case "/api2/json/access/ticket":
call := atomic.AddInt32(&authCalls, 1)
if call == 1 {
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"data":{"ticket":"ticket-1","CSRFPreventionToken":"csrf-1"}}`))
return
}
w.WriteHeader(http.StatusUnauthorized)
w.Write([]byte("bad password"))
case "/api2/json/nodes":
w.WriteHeader(http.StatusUnauthorized)
w.Write([]byte("ticket invalid"))
default:
t.Fatalf("unexpected path: %s", r.URL.Path)
}
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
User: "user@pam",
Password: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
_, err = client.get(context.Background(), "/nodes")
if err == nil {
t.Fatal("expected error")
}
if !strings.Contains(err.Error(), "re-authentication failed after 401") {
t.Fatalf("unexpected error: %v", err)
}
}
func TestClientRequest_500NonAuth(t *testing.T) {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusInternalServerError)
w.Write([]byte("boom"))
}))
defer server.Close()
client, err := NewClient(ClientConfig{
Host: server.URL,
TokenName: "user@pve!token",
TokenValue: "secret",
VerifySSL: false,
})
if err != nil {
t.Fatalf("NewClient failed: %v", err)
}
_, err = client.get(context.Background(), "/nodes")
if err == nil {
t.Fatal("expected error")
}
msg := err.Error()
if !strings.Contains(msg, "API error 500") {
t.Fatalf("expected api error 500, got %q", msg)
}
if strings.Contains(strings.ToLower(msg), "authentication error") {
t.Fatalf("did not expect authentication error for 500, got %q", msg)
}
}