We are trying out Stoplight Elements for API documentation, and are sharing our work-in-progress with another team on a password-protected website (HTTP Basic auth).
Current Behavior
On our password-protected site, JSON Schema external refs do not work, leading to errors in the Stoplight Elements UI like "Cannot resolve external references".
Expected Behavior
External references should work -- the site visitor has already put in the password.
Context
We are trying out Stoplight Elements for API documentation, and are sharing our work-in-progress with another team on a password-protected website (HTTP Basic auth).
Current Behavior
On our password-protected site, JSON Schema external refs do not work, leading to errors in the Stoplight Elements UI like "Cannot resolve external references".
Expected Behavior
External references should work -- the site visitor has already put in the password.
Possible Workaround/Solution
We made a point change in https://github.com/APIDevTools/json-schema-ref-parser/blob/main/lib/resolvers/http.js (or rather, its minified version) to set withCredentials: true. This resolved our issue. However, it would be useful if this were the default, or else if there were some reasonable way to pass that option down from Elements.
Steps to Reproduce
Create an openapi.yml with an external $ref, like
or
When accessing the schema, the UI shows
When accessing an API which refers to that example, the UI shows