Keep base URL out of config errors and always keep a bounded error excerpt
Independent review Codex gpt-6-sol high: CHANGES_REQUIRED (1 high, 1 medium)
CI / ci (push) Successful in 1m27s
CI / ci (pull_request) Successful in 1m29s

New no longer echoes the supplied base URL in any configuration error, so
a credential in a rejected URL's query or fragment cannot leak.

llm.NewProviderError now takes the single credential sent with the
request ("" when none) and always keeps a body excerpt bounded to
MaxBodyExcerpt bytes, redacting the credential first. Keyless Ollama
errors therefore keep the vendor's explanation, e.g. model not found.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-03 16:28:21 -04:00
co-authored by Claude Opus 5.5
parent 6d0bea10b5
commit 1f4356cd17
4 changed files with 95 additions and 43 deletions
+6 -6
View File
@@ -74,15 +74,17 @@ var _ llm.Provider = (*Provider)(nil)
// New validates cfg and returns a Provider.
func New(cfg Config) (*Provider, error) {
// Base URL errors never echo the URL: a rejected one may carry a
// credential.
u, err := url.Parse(cfg.BaseURL)
if err != nil {
return nil, errors.New("openai: base URL does not parse")
}
if (u.Scheme != "http" && u.Scheme != "https") || u.Host == "" {
return nil, fmt.Errorf("openai: base URL %q must be an absolute http or https URL", u.Redacted())
return nil, errors.New("openai: base URL must be an absolute http or https URL")
}
if u.User != nil || u.RawQuery != "" || u.Fragment != "" {
return nil, fmt.Errorf("openai: base URL %q must not carry credentials, a query or a fragment", u.Redacted())
return nil, errors.New("openai: base URL must not carry credentials, a query or a fragment")
}
switch cfg.StructuredOutput {
case JSONSchema, JSONObject, PromptOnly:
@@ -217,7 +219,7 @@ func (p *Provider) Generate(ctx context.Context, req llm.Request) (llm.Response,
}
if len(cr.Error) > 0 && string(cr.Error) != "null" {
// OpenRouter can report an upstream failure in a 2xx body.
return llm.Response{}, fmt.Errorf("openai: generate: %w", llm.NewProviderError(status, raw, p.secrets()))
return llm.Response{}, fmt.Errorf("openai: generate: %w", llm.NewProviderError(status, raw, p.apiKey))
}
if len(cr.Choices) == 0 {
return llm.Response{}, errors.New("openai: generate: response has no choices")
@@ -319,8 +321,6 @@ func (p *Provider) Verify(ctx context.Context) error {
return err
}
func (p *Provider) secrets() []string { return []string{p.apiKey} }
// do sends one request and returns the body and status of a 2xx response.
// Any other status becomes the matching llm typed error.
func (p *Provider) do(ctx context.Context, method, path string, payload []byte) ([]byte, int, error) {
@@ -376,7 +376,7 @@ func (p *Provider) statusError(resp *http.Response, body []byte) error {
case http.StatusRequestTimeout:
return fmt.Errorf("HTTP %d: %w", resp.StatusCode, llm.ErrTimeout)
default:
return llm.NewProviderError(resp.StatusCode, body, p.secrets())
return llm.NewProviderError(resp.StatusCode, body, p.apiKey)
}
}
+63 -1
View File
@@ -498,6 +498,64 @@ func TestTransportErrorHasNoSecret(t *testing.T) {
assertNoSecret(t, err)
}
// TestKeyedErrorsNeverLeakKey drives every error path of the keyed OpenAI
// and OpenRouter shapes with vendor bodies that echo the key.
func TestKeyedErrorsNeverLeakKey(t *testing.T) {
shapes := map[string]struct {
path string
headers map[string]string
}{
"OpenAI": {path: "/v1"},
"OpenRouter": {path: "/api/v1", headers: map[string]string{"HTTP-Referer": "https://mealquest.example", "X-Title": "MealQuest"}},
}
fixtures := []string{"openai_error_invalid_key.json", "openai_error_server.json", "openrouter_error_rate_limited.json"}
statuses := []int{400, 401, 403, 404, 408, 429, 500, 502, 503}
for name, shape := range shapes {
for _, fixture := range fixtures {
for _, status := range statuses {
vs := newVendorServer(t, reply{status: status, fixture: fixture})
p := newProvider(t, vs.URL+shape.path, JSONSchema, shape.headers)
_, genErr := p.Generate(context.Background(), schemaRequest())
_, listErr := p.ListModels(context.Background())
verifyErr := p.Verify(context.Background())
for _, err := range []error{genErr, listErr, verifyErr} {
if err == nil {
t.Fatalf("%s %s HTTP %d: nil error", name, fixture, status)
}
assertNoSecret(t, err)
var pe *llm.ProviderError
if errors.As(err, &pe) {
assertNoSecret(t, errors.New(pe.Body()))
}
}
}
}
}
}
func TestKeylessOllamaErrorKeepsExcerpt(t *testing.T) {
vs := newVendorServer(t, reply{status: 404, fixture: "ollama_error_not_found.json"})
p, err := New(Config{BaseURL: vs.URL + "/v1", Model: "llama9", StructuredOutput: PromptOnly})
if err != nil {
t.Fatal(err)
}
_, err = p.Generate(context.Background(), schemaRequest())
var pe *llm.ProviderError
if !errors.As(err, &pe) || pe.Status() != 404 {
t.Fatalf("err = %v, want a 404 ProviderError", err)
}
if !strings.Contains(pe.Body(), `model \"llama9\" not found`) || len(pe.Body()) > llm.MaxBodyExcerpt {
t.Fatalf("Body() = %q, want the bounded not-found explanation", pe.Body())
}
if !strings.Contains(err.Error(), pe.Body()) {
t.Fatalf("Error() = %q, want it to carry the excerpt", err)
}
assertNoSecret(t, err)
if got := vs.only(t).header.Get("Authorization"); got != "" {
t.Fatalf("keyless request sent Authorization %q", got)
}
}
func TestGenerateRejectsInvalidRequests(t *testing.T) {
vs := newVendorServer(t, reply{status: 200, fixture: "ollama_chat_text.json"})
p := newProvider(t, vs.URL, JSONSchema, nil)
@@ -524,7 +582,11 @@ func TestNewRejectsBadConfig(t *testing.T) {
"relative base": {BaseURL: "api.openai.com/v1", StructuredOutput: JSONSchema},
"ftp base": {BaseURL: "ftp://example.com", StructuredOutput: JSONSchema},
"credentials in URL": {BaseURL: "https://user:" + testKey + "@example.com/v1", StructuredOutput: JSONSchema},
"query in URL": {BaseURL: "https://example.com/v1?key=x", StructuredOutput: JSONSchema},
"key in query": {BaseURL: "https://example.com/v1?key=" + testKey, StructuredOutput: JSONSchema},
"key in fragment": {BaseURL: "https://example.com/v1#" + testKey, StructuredOutput: JSONSchema},
"key, relative base": {BaseURL: "example.com/v1?key=" + testKey, StructuredOutput: JSONSchema},
"key, ftp base": {BaseURL: "ftp://example.com/v1?key=" + testKey, StructuredOutput: JSONSchema},
"key, unparseable": {BaseURL: "https://example.com/%zz?key=" + testKey, StructuredOutput: JSONSchema},
"unknown mode": {BaseURL: "https://example.com/v1", StructuredOutput: "json"},
"no mode": {BaseURL: "https://example.com/v1"},
"authorization hdr": {BaseURL: "https://example.com/v1", StructuredOutput: JSONSchema, Headers: map[string]string{"authorization": "Bearer x"}},