[REQ] Feature Request Description

Is your feature request related to a problem? Please describe.

Support authed $ref urls so that businesses can have schema registries and refer to them from contracts. Repositories are often behind authentication.

Describe the solution you'd like

I'd like the generator to accept configuration so that, when I run it via Github action or other CI tool, I can pass a token to be used as a header when resolving certain $refs.

Describe alternatives you've considered

• Removing authentication from our repositories, which is a non-starter in my current environment.
• Using basic auth and rewriting the $ref urls by preprocessing, which doesn't work due to basic auth deprecation

Additional context

I've added a related issue for the specification itself: https://github.com/OAI/OpenAPI-Specification/issues/3270.

I think they are separate because I'm guessing it's easier to add support to the tool without changing the spec.

No files, tests, or entry points are named in the issue. Define how generator configuration should provide a token header for selected authenticated $ref URLs, and verify that those references resolve correctly in CI.