uv/docs/configuration
John Mumm c58675fdac
Add an optional authentication policy to [index] configuration (#11896)
Adds a new optional key `auth-policy` to `[tool.uv.index]` that sets the
authentication policy for the index URL.

The default is `"auto"`, which attempts to authenticate when necessary.
`"always"` always attempts to authenticate and fails if the endpoint is
unauthenticated. `"never"` never attempts to authenticate.

These policy address two kinds of cases:
* Some indexes don’t fail on unauthenticated requests; instead they just
forward to the public PyPI. This can leave the user confused as to why
their package is missing. The "always" policy prevents this.
* "never" allows users to ensure their credentials couldn't be leaked to
an unexpected index, though it will only allow for successful requests
on an index that doesn't require credentials.

Closes #11600
2025-03-10 12:24:25 -05:00
..
authentication.md Add an optional authentication policy to [index] configuration (#11896) 2025-03-10 12:24:25 -05:00
environment.md Add NO_BUILD and NO_BUILD_PACKAGE environment variables (#11968) 2025-03-04 22:58:19 -06:00
files.md Use [[index]] API in configuration example (#9065) 2024-11-12 14:43:54 -05:00
index.md Add support for named and explicit indexes (#7481) 2024-10-15 18:24:23 -04:00
indexes.md Add an optional authentication policy to [index] configuration (#11896) 2025-03-10 12:24:25 -05:00
installer.md Supplement missing separators for UV_INSTALL_DIR in Windows. (#9507) 2024-12-19 09:53:49 -06:00