boxd 0.3.0.dev986__tar.gz → 0.3.0.dev1040__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {boxd-0.3.0.dev986/src/boxd.egg-info → boxd-0.3.0.dev1040}/PKG-INFO +1 -1
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/pyproject.toml +1 -1
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_credentials.py +25 -5
- boxd-0.3.0.dev1040/src/boxd/_generated/api_pb2.py +696 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_regions.py +65 -27
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_requests.py +13 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_transport.py +91 -8
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_urls.py +24 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/machines.py +121 -56
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040/src/boxd.egg-info}/PKG-INFO +1 -1
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd.egg-info/SOURCES.txt +2 -0
- boxd-0.3.0.dev1040/tests/test_create_in_one_call.py +136 -0
- boxd-0.3.0.dev1040/tests/test_raw_key.py +254 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_regions.py +78 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_transport.py +1 -1
- boxd-0.3.0.dev986/src/boxd/_generated/api_pb2.py +0 -696
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/LICENSE +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/README.md +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/setup.cfg +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/__init__.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_client.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_generated/__init__.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_generated/api_pb2_grpc.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_mappers.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_streaming.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/_version_check.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/errors.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/models.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/py.typed +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/__init__.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/account.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/credentials.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/disks.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/domains.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/fs.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/orgs.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/regions.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/snapshots.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/teams.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/resources/vars.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd/spec.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd.egg-info/dependency_links.txt +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd.egg-info/requires.txt +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/src/boxd.egg-info/top_level.txt +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_credentials.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_delete_self.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_fs.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_mappers.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_namespaces.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_python_versions.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_requests.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_spec.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_streaming.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_urls.py +0 -0
- {boxd-0.3.0.dev986 → boxd-0.3.0.dev1040}/tests/test_version_check.py +0 -0
|
@@ -1,13 +1,15 @@
|
|
|
1
|
-
"""Credential resolution: explicit token, API
|
|
1
|
+
"""Credential resolution: explicit token, API key, or in-VM metadata.
|
|
2
2
|
|
|
3
|
-
The gRPC API
|
|
4
|
-
|
|
5
|
-
and
|
|
3
|
+
The gRPC API takes ``Authorization: Bearer <JWT>``, and a ``bxd_`` API key as
|
|
4
|
+
the bearer itself. A key goes as itself over TLS, or to a loopback address
|
|
5
|
+
(:meth:`_CredentialsBase.raw_key`); otherwise, and once a server refuses it as
|
|
6
|
+
one from before raw keys does (the transport's ``_refuses_raw_key``), it is
|
|
7
|
+
exchanged for a JWT that is kept fresh, as every client did before.
|
|
6
8
|
|
|
7
9
|
Resolution order, first match wins:
|
|
8
10
|
|
|
9
11
|
1. explicit ``token`` — used as-is, never refreshed
|
|
10
|
-
2. explicit ``api_key`` — exchanged for a JWT
|
|
12
|
+
2. explicit ``api_key`` — sent as itself, or exchanged for a JWT
|
|
11
13
|
3. ``BOXD_TOKEN``, then ``BOXD_API_KEY`` — same handling
|
|
12
14
|
4. in-VM metadata adapter — no credentials required
|
|
13
15
|
5. otherwise :class:`AuthenticationError` (reason ``"missing_credentials"``)
|
|
@@ -289,6 +291,24 @@ class _CredentialsBase:
|
|
|
289
291
|
self._expires_at: float = 0.0
|
|
290
292
|
# Base URL learned from the metadata adapter (in-VM mode only).
|
|
291
293
|
self.discovered_base_url: str | None = None
|
|
294
|
+
# A server refused the key itself as an older one does: exchange it
|
|
295
|
+
# from now on, for the life of the client, every endpoint included.
|
|
296
|
+
self._raw_key_refused = False
|
|
297
|
+
|
|
298
|
+
def raw_key(self, *, allowed: bool) -> str | None:
|
|
299
|
+
"""The API key, when a call should carry it as the bearer itself.
|
|
300
|
+
|
|
301
|
+
``allowed`` says the endpoint is reached over TLS or on a loopback
|
|
302
|
+
address. ``None`` means use :meth:`token` (a token, an in-VM
|
|
303
|
+
credential, or the session exchanged for the key).
|
|
304
|
+
"""
|
|
305
|
+
if self.mode != "exchange" or not allowed or self._raw_key_refused:
|
|
306
|
+
return None
|
|
307
|
+
return self._api_key
|
|
308
|
+
|
|
309
|
+
def raw_key_refused(self) -> None:
|
|
310
|
+
"""A server refused the key itself: exchange it from now on."""
|
|
311
|
+
self._raw_key_refused = True
|
|
292
312
|
|
|
293
313
|
@property
|
|
294
314
|
def mode(self) -> str:
|