Qiskit / qiskit-ibm-runtime / 30835810088

89%

push

github

Support IAM private endpoints via IAM_URL env var (#3135)

<!--
⚠️ The pull request title should be short detailed and understandable
for all.
⚠️ Also, please add a release note file using towncrier if the change
needs to
  be documented in the release notes.
⚠️ If your pull request fixes an open issue, please link to the issue.

✅ I have added the tests to cover my changes.
✅ I have updated the documentation accordingly.
✅ I have read the CONTRIBUTING document.
-->

### Summary

Adds an `IAM_URL` environment variable to override the IAM endpoint URL
used for authentication, allowing IAM traffic to be routed through a
private endpoint (e.g. https://private.iam.cloud.ibm.com) in VPE
environments without code changes. This follows the same convention as
the IBM SDK's `GLOBAL_SEARCH_URL` and `GLOBAL_CATALOG_URL` variables.

Additionally, skips the `instances()` validation call during
`QiskitRuntimeService` initialization when
`QISKIT_FUNCTIONS_EXPERIMENTAL` is set. This is an undocumented setting
for environments where Global Search/Catalog may not be reachable via
private endpoints.

### Details and comments

Fixes #3134.

I will keep the PR on draft until I have been able to re-verify that the
URL changes I implemented hold in both production and staging.
### Pending tests

- [x] Test private endpoints in staging
- [x] Test private endpoints in production

### AI/LLM disclosure

- [ ] I didn't use LLM tooling, or only used it privately.
- [ ] I used the following tool to help write this PR description:
- [x] I used the following tool to generate or modify code: Claude
Sonnet 4.6

---------

Co-authored-by: Diego M. Rodriguez <diego@moreda.io>

7 of 8 new or added lines in 3 files covered. (87.5%)

9251 of 10390 relevant lines covered (89.04%)

9.74 hits per line