Repository navigation
Commit ea940e6
VAP15-80 docs: document public-key model URL rejection (#1404)
* VAP15-80 docs: document public-key model URL rejection
VAPSEC-618 changed a documented contract: a web call or chat
(POST /call/web, /chat/web, /chat/web/responses) authenticated with a
public API key or a public JWT now gets a 403 if model.url appears
anywhere in the request body. The docs still presented transient
assistants and assistantOverrides as interchangeable with saved
configuration from the browser, so a customer hitting the 403 had no
page explaining it. The cohort email needs a stable URL to link to.
- transient-vs-permanent-configurations.mdx: a "Model URLs on
public-key requests" section covering scope, the request-body
locations, who is unaffected, the literal 403 body, and the two
fixes (save the assistant and pass assistantId, or start the call
server-side with a private key).
- using-your-server.mdx: a Note under the Custom LLM URL step pointing
to that section.
The 403 message is quoted verbatim from
CALLER_MODEL_URL_REJECTION_MESSAGE so support can search for it.
Scope says "public API key or public JWT", not "public key". The
enforced auth paths are api-key-public, customer-jwt-public and
customer-jwt-untagged; VAPSEC-618 deliverable 4 settled that both JWT
paths stay enforced, since Origin is caller-controlled and the token
type is the only boundary an attacker can't forge. org-jwt and
workos-jwt (dashboard) callers are not enforced and are excluded. The
ramp is deliberately not described.
fern check: 0 errors, no warnings on the edited pages.
Refs VAP15-80, VAPSEC-618, VAPSEC-906
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* VAP15-80 docs: apply review suggestions and scope fixes
- Use "stored assistant" throughout, matching the page and the 403 body
- Name the Custom LLM URL field next to model.url
- List squad.membersOverrides as its own location
- Clarify private keys and private JWTs are unaffected on POST /call and /chat
- Add a phased-rollout Note
- Note variableValues is the only override on the public chat routes
- Add private JWT to the server-side fix; fold the Warning into it
- Trim the custom LLM Note per review
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* VAP15-80 docs: drop Vapi as the actor per review
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Steve Smtih <stephen@vapi.ai>1 parent 87cec58 commit ea940e6
2 files changed
Lines changed: 37 additions & 0 deletions
File tree
- fern
- assistants/concepts
- customization/custom-llm
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
260 | 260 | | |
261 | 261 | | |
262 | 262 | | |
| 263 | + | |
| 264 | + | |
| 265 | + | |
| 266 | + | |
| 267 | + | |
| 268 | + | |
| 269 | + | |
| 270 | + | |
| 271 | + | |
| 272 | + | |
| 273 | + | |
| 274 | + | |
| 275 | + | |
| 276 | + | |
| 277 | + | |
| 278 | + | |
| 279 | + | |
| 280 | + | |
| 281 | + | |
| 282 | + | |
| 283 | + | |
| 284 | + | |
| 285 | + | |
| 286 | + | |
| 287 | + | |
| 288 | + | |
| 289 | + | |
| 290 | + | |
| 291 | + | |
| 292 | + | |
| 293 | + | |
| 294 | + | |
| 295 | + | |
263 | 296 | | |
264 | 297 | | |
265 | 298 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
61 | 61 | | |
62 | 62 | | |
63 | 63 | | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
64 | 68 | | |
65 | 69 | | |
66 | 70 | | |
| |||
0 commit comments