auth 3.5.1__tar.gz → 3.6.0__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.
- {auth-3.5.1 → auth-3.6.0}/PKG-INFO +10 -5
- {auth-3.5.1 → auth-3.6.0}/README.md +3 -3
- {auth-3.5.1 → auth-3.6.0}/auth/__init__.py +23 -7
- auth-3.6.0/auth/core/__init__.py +18 -0
- {auth-3.5.1 → auth-3.6.0}/auth/keycheck.py +20 -3
- auth-3.6.0/auth/migrate.py +61 -0
- auth-3.6.0/auth/migrations/01KYTMDEYFVH43HKR0MQWW1EMP_add_auth_api_key.sql +41 -0
- auth-3.6.0/auth/migrations/01KYTQN79R1ZBNDPA3ND9AAA73_drop_alembic_version.sql +21 -0
- auth-3.6.0/auth/migrations/01KYTRKMWNBDDZPN1H0AXRTT5G_add_auth_tenant_settings.sql +26 -0
- auth-3.6.0/auth/migrations/01KYTX0MKVZ775P62CJ87631Z1_grandfather_strict_users.sql +85 -0
- auth-3.6.0/auth/migrations/01KZJWHG32K9X1AFBPPB4YJC6A_partition_audit_log.sql +279 -0
- auth-3.6.0/auth/migrations/01M2Y4SMRCS9PW29AA0TFCVXKR_add_creator_fp_and_rotate_key.sql +108 -0
- auth-3.6.0/auth/migrations/01M2Y4YA6RY6DZWT235CDV9H5W_enable_row_level_security.sql +180 -0
- auth-3.6.0/auth/migrations/01M2Y8WEM8SYB1SG8QD35S3T6M_add_encryption_canary.sql +40 -0
- auth-3.6.0/auth/migrations/01M2Y9AYF2B7WM3AHMGX14AWWJ_rls_on_new_audit_partitions.sql +108 -0
- auth-3.6.0/auth/migrations/01M2Y9FNKBJ513W0XVCYFYPDR9_drop_stale_public_tables.sql +104 -0
- auth-3.6.0/auth/migrations/01M2Y9WFEY32ZWDP161SHR1B2M_add_apply_tenant_rls_function.sql +166 -0
- auth-3.6.0/auth/migrations/01M2Z040JTSGF3V0AQMP583BDA_create_audit_log_partitioned_if_absent.sql +117 -0
- auth-3.6.0/auth/migrations/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/static_docs/api_reference.md +33 -10
- {auth-3.5.1 → auth-3.6.0}/auth/static_docs/claude_guide.md +5 -4
- {auth-3.5.1 → auth-3.6.0}/auth/static_docs/landing.md +2 -2
- {auth-3.5.1 → auth-3.6.0}/auth.egg-info/PKG-INFO +10 -5
- {auth-3.5.1 → auth-3.6.0}/auth.egg-info/SOURCES.txt +18 -0
- {auth-3.5.1 → auth-3.6.0}/auth.egg-info/entry_points.txt +1 -0
- {auth-3.5.1 → auth-3.6.0}/auth.egg-info/requires.txt +7 -1
- {auth-3.5.1 → auth-3.6.0}/pyproject.toml +18 -2
- auth-3.6.0/tests/test_deploy_lock.py +91 -0
- auth-3.6.0/tests/test_import_footprint.py +93 -0
- auth-3.6.0/tests/test_migrate_cli.py +104 -0
- auth-3.6.0/tests/test_served_docs_host.py +49 -0
- auth-3.5.1/auth/core/__init__.py +0 -6
- {auth-3.5.1 → auth-3.6.0}/LICENSE +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/api_keys.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/audit.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/circuit_breaker.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/client/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/client/_transport.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/client/base.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/client/keys.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/client/rbac.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/client/workflow.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/cmd/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/cmd/server.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/config.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/core/REST/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/core/REST/client.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/core/models/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/database.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/decorators.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/docs_page.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/encryption.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/logging_config.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/main.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/models/sql.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/response_format.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/rls.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/_common.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/apikeys.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/membership.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/permissions.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/public.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/roles.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/tenant.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/routes/workflow.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/sanitizer.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/schema_check.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/schema_reconcile.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/server.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/base.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/keys.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/queries.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/rbac.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/recovery.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/rotation.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/service.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/services/tenant.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/static_docs/__init__.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/static_docs/page.html +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/validation.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth/workflow_checker.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth.egg-info/dependency_links.txt +0 -0
- {auth-3.5.1 → auth-3.6.0}/auth.egg-info/top_level.txt +0 -0
- {auth-3.5.1 → auth-3.6.0}/setup.cfg +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_api_keys.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_api_keys_encryption.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_audit_integrity.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_client.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_client_exceptions_do_not_render_payload.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_client_rest.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_cmd_server.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_config.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_correctness_hardening.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_database_pool_settings.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_database_sslmode.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_degraded_response_is_a_contract.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_docs_page.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_encryption.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_encryption_integration.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_flask.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_gunicorn_config_invariants.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_key_rotation.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_log_redaction.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_no_bundled_libpq.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_phase_a_hardening.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_provision_script_no_dsn_leak.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_reencryption.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_routes_errors.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_schema_check.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_self_service_audit.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_server.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_service_lifecycle.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_settings_do_not_echo_secrets.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_strict_default.py +0 -0
- {auth-3.5.1 → auth-3.6.0}/tests/test_strict_users.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: auth
|
|
3
|
-
Version: 3.
|
|
3
|
+
Version: 3.6.0
|
|
4
4
|
Summary: Authorization for humans
|
|
5
5
|
Author-email: Farshid Ashouri <farsheed.ashouri@gmail.com>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -35,13 +35,18 @@ Requires-Dist: pydantic<3,>=2.0.0
|
|
|
35
35
|
Requires-Dist: pydantic-settings<3,>=2.0.0
|
|
36
36
|
Requires-Dist: requests<3,>=2.25.0
|
|
37
37
|
Requires-Dist: bleach<7,>=5.0.0
|
|
38
|
-
Requires-Dist: python-json-logger<
|
|
38
|
+
Requires-Dist: python-json-logger<5,>=3.1.0
|
|
39
39
|
Provides-Extra: c
|
|
40
40
|
Requires-Dist: psycopg[c]<4,>=3.0.0; extra == "c"
|
|
41
41
|
Provides-Extra: ratelimit
|
|
42
42
|
Requires-Dist: flask-limiter>=3.0.0; extra == "ratelimit"
|
|
43
43
|
Provides-Extra: migrations
|
|
44
44
|
Requires-Dist: migretti>=0.10.0; extra == "migrations"
|
|
45
|
+
Provides-Extra: server
|
|
46
|
+
Requires-Dist: gunicorn[setproctitle]>=26.2.0; extra == "server"
|
|
47
|
+
Requires-Dist: supervice<0.4,>=0.3.0; extra == "server"
|
|
48
|
+
Requires-Dist: click>=8.3.3; extra == "server"
|
|
49
|
+
Requires-Dist: setuptools>=84.1.0; extra == "server"
|
|
45
50
|
Provides-Extra: dev
|
|
46
51
|
Requires-Dist: pytest>=6.0; extra == "dev"
|
|
47
52
|
Requires-Dist: pytest-cov>=2.0; extra == "dev"
|
|
@@ -77,7 +82,7 @@ before you add members or permissions to it.
|
|
|
77
82
|
|
|
78
83
|
```bash
|
|
79
84
|
KEY=$(python3 -c "import uuid; print(uuid.uuid4())")
|
|
80
|
-
BASE=https://auth.rodmena.
|
|
85
|
+
BASE=https://auth.rodmena.com
|
|
81
86
|
|
|
82
87
|
curl -X POST -H "Authorization: Bearer $KEY" $BASE/api/role/engineers
|
|
83
88
|
curl -X POST -H "Authorization: Bearer $KEY" $BASE/api/permission/engineers/deploy
|
|
@@ -112,7 +117,7 @@ With the Python client (`pip install auth`):
|
|
|
112
117
|
```python
|
|
113
118
|
from auth import Client
|
|
114
119
|
|
|
115
|
-
with Client(api_key=KEY, service_url="https://auth.rodmena.
|
|
120
|
+
with Client(api_key=KEY, service_url="https://auth.rodmena.com") as c:
|
|
116
121
|
c.create_role("engineers")
|
|
117
122
|
c.add_permission("engineers", "deploy")
|
|
118
123
|
c.create_api_key("alice") # strict default since 3.0.0
|
|
@@ -158,7 +163,7 @@ with Client(api_key=KEY, service_url="https://auth.rodmena.app") as c:
|
|
|
158
163
|
|
|
159
164
|
| Doc | What's in it |
|
|
160
165
|
|---|---|
|
|
161
|
-
| **Live API reference** — [`/docs`](https://auth.rodmena.
|
|
166
|
+
| **Live API reference** — [`/docs`](https://auth.rodmena.com/docs) · [`/llms.txt`](https://auth.rodmena.com/llms.txt) | Every endpoint and exact response shape, served by the app (agent-friendly). |
|
|
162
167
|
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Design, components, request lifecycle, data model, permission-check and key-rotation flows, diagrams. |
|
|
163
168
|
| [SECURITY.md](SECURITY.md) | Security model (tenant isolation, encryption, audit, rotation), threat notes, reporting. |
|
|
164
169
|
| [MIGRATIONS.md](MIGRATIONS.md) | Schema creation vs migrations, upgrade/rollback runbook. |
|
|
@@ -20,7 +20,7 @@ before you add members or permissions to it.
|
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
22
|
KEY=$(python3 -c "import uuid; print(uuid.uuid4())")
|
|
23
|
-
BASE=https://auth.rodmena.
|
|
23
|
+
BASE=https://auth.rodmena.com
|
|
24
24
|
|
|
25
25
|
curl -X POST -H "Authorization: Bearer $KEY" $BASE/api/role/engineers
|
|
26
26
|
curl -X POST -H "Authorization: Bearer $KEY" $BASE/api/permission/engineers/deploy
|
|
@@ -55,7 +55,7 @@ With the Python client (`pip install auth`):
|
|
|
55
55
|
```python
|
|
56
56
|
from auth import Client
|
|
57
57
|
|
|
58
|
-
with Client(api_key=KEY, service_url="https://auth.rodmena.
|
|
58
|
+
with Client(api_key=KEY, service_url="https://auth.rodmena.com") as c:
|
|
59
59
|
c.create_role("engineers")
|
|
60
60
|
c.add_permission("engineers", "deploy")
|
|
61
61
|
c.create_api_key("alice") # strict default since 3.0.0
|
|
@@ -101,7 +101,7 @@ with Client(api_key=KEY, service_url="https://auth.rodmena.app") as c:
|
|
|
101
101
|
|
|
102
102
|
| Doc | What's in it |
|
|
103
103
|
|---|---|
|
|
104
|
-
| **Live API reference** — [`/docs`](https://auth.rodmena.
|
|
104
|
+
| **Live API reference** — [`/docs`](https://auth.rodmena.com/docs) · [`/llms.txt`](https://auth.rodmena.com/llms.txt) | Every endpoint and exact response shape, served by the app (agent-friendly). |
|
|
105
105
|
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Design, components, request lifecycle, data model, permission-check and key-rotation flows, diagrams. |
|
|
106
106
|
| [SECURITY.md](SECURITY.md) | Security model (tenant isolation, encryption, audit, rotation), threat notes, reporting. |
|
|
107
107
|
| [MIGRATIONS.md](MIGRATIONS.md) | Schema creation vs migrations, upgrade/rollback runbook. |
|
|
@@ -1,23 +1,39 @@
|
|
|
1
1
|
__author__ = "Farshid Ashouri"
|
|
2
2
|
|
|
3
3
|
from importlib.metadata import PackageNotFoundError, version
|
|
4
|
-
from typing import Optional
|
|
4
|
+
from typing import TYPE_CHECKING, Optional
|
|
5
5
|
|
|
6
|
-
from auth.client import ( # Import the new client
|
|
7
|
-
AuthRefused,
|
|
8
|
-
AuthTransportError,
|
|
9
|
-
Client,
|
|
10
|
-
EnhancedAuthClient,
|
|
11
|
-
)
|
|
12
6
|
from auth.database import SessionLocal
|
|
13
7
|
from auth.schema_check import SchemaMismatchError, check_schema
|
|
14
8
|
from auth.services.service import AuthorizationService
|
|
15
9
|
|
|
10
|
+
if TYPE_CHECKING:
|
|
11
|
+
from auth.client import (
|
|
12
|
+
AuthRefused,
|
|
13
|
+
AuthTransportError,
|
|
14
|
+
Client,
|
|
15
|
+
EnhancedAuthClient,
|
|
16
|
+
)
|
|
17
|
+
|
|
16
18
|
try:
|
|
17
19
|
__version__ = version("auth")
|
|
18
20
|
except PackageNotFoundError: # running from a source checkout without install
|
|
19
21
|
__version__ = "0.0.0.dev0"
|
|
20
22
|
|
|
23
|
+
_CLIENT_EXPORTS = frozenset(
|
|
24
|
+
{"AuthRefused", "AuthTransportError", "Client", "EnhancedAuthClient"}
|
|
25
|
+
)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def __getattr__(name: str):
|
|
29
|
+
if name in _CLIENT_EXPORTS:
|
|
30
|
+
import auth.client
|
|
31
|
+
|
|
32
|
+
value = getattr(auth.client, name)
|
|
33
|
+
globals()[name] = value
|
|
34
|
+
return value
|
|
35
|
+
raise AttributeError(f"module 'auth' has no attribute {name!r}")
|
|
36
|
+
|
|
21
37
|
|
|
22
38
|
# Lazy import for Flask app to avoid immediate initialization
|
|
23
39
|
def _get_app():
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
__author__ = "Farshid Ashouri"
|
|
2
|
+
|
|
3
|
+
from typing import TYPE_CHECKING
|
|
4
|
+
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from auth.client import Client, EnhancedAuthClient
|
|
7
|
+
|
|
8
|
+
__all__ = ["Client", "EnhancedAuthClient"]
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def __getattr__(name: str):
|
|
12
|
+
if name in __all__:
|
|
13
|
+
import auth.client
|
|
14
|
+
|
|
15
|
+
value = getattr(auth.client, name)
|
|
16
|
+
globals()[name] = value
|
|
17
|
+
return value
|
|
18
|
+
raise AttributeError(f"module 'auth.core' has no attribute {name!r}")
|
|
@@ -164,6 +164,18 @@ def verify_encryption_key(db) -> str:
|
|
|
164
164
|
return _set(OK, "encryption key verified against the deployment canary")
|
|
165
165
|
|
|
166
166
|
|
|
167
|
+
RLS_SCHEMA = "auth_rbac"
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
def _schema_hint(schema: str) -> str:
|
|
171
|
+
if schema == RLS_SCHEMA:
|
|
172
|
+
return ""
|
|
173
|
+
return (
|
|
174
|
+
f" (AUTH_DATABASE_SCHEMA is {schema!r}; auth's migrations and row level"
|
|
175
|
+
f" security are defined in schema {RLS_SCHEMA!r})"
|
|
176
|
+
)
|
|
177
|
+
|
|
178
|
+
|
|
167
179
|
def verify_row_level_security(db) -> str:
|
|
168
180
|
"""Confirm RLS is actually in force, not merely enabled.
|
|
169
181
|
|
|
@@ -198,7 +210,10 @@ def verify_row_level_security(db) -> str:
|
|
|
198
210
|
return _set(UNVERIFIED, f"could not read RLS state: {exc.__class__.__name__}")
|
|
199
211
|
|
|
200
212
|
if not rows:
|
|
201
|
-
return _set(
|
|
213
|
+
return _set(
|
|
214
|
+
UNVERIFIED,
|
|
215
|
+
"no tenant tables found to check RLS on" + _schema_hint(schema),
|
|
216
|
+
)
|
|
202
217
|
|
|
203
218
|
# A table that is absent is not a table that is safe. The junction tables
|
|
204
219
|
# are created by the ORM rather than by a migration, so on a fresh database
|
|
@@ -210,7 +225,8 @@ def verify_row_level_security(db) -> str:
|
|
|
210
225
|
return _set(
|
|
211
226
|
MISMATCH,
|
|
212
227
|
"expected tenant tables are absent, so nothing protects them: "
|
|
213
|
-
+ ", ".join(missing)
|
|
228
|
+
+ ", ".join(missing)
|
|
229
|
+
+ _schema_hint(schema),
|
|
214
230
|
)
|
|
215
231
|
|
|
216
232
|
unprotected = [
|
|
@@ -221,7 +237,8 @@ def verify_row_level_security(db) -> str:
|
|
|
221
237
|
MISMATCH,
|
|
222
238
|
"row level security is not in force on: "
|
|
223
239
|
+ ", ".join(sorted(unprotected))
|
|
224
|
-
+ " - tenant isolation would rest on query convention alone"
|
|
240
|
+
+ " - tenant isolation would rest on query convention alone"
|
|
241
|
+
+ _schema_hint(schema),
|
|
225
242
|
)
|
|
226
243
|
return _set(OK, f"row level security forced on {len(rows)} tables")
|
|
227
244
|
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import importlib.util
|
|
2
|
+
import os
|
|
3
|
+
import subprocess
|
|
4
|
+
import sys
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
from typing import List, Mapping, Optional
|
|
7
|
+
|
|
8
|
+
COMMANDS = ("apply", "status", "verify", "head", "list")
|
|
9
|
+
URL_VARIABLES = ("MG_DATABASE_URL", "AUTH_DATABASE_URL", "AUTH_POSTGRESQL_URL")
|
|
10
|
+
DRIVER_PREFIXES = ("postgresql+psycopg://", "postgres+psycopg://")
|
|
11
|
+
USAGE = (
|
|
12
|
+
"usage: auth-migrate {apply,status,verify,head,list} [migretti options]\n"
|
|
13
|
+
"Runs the migrations shipped with this auth release against the database "
|
|
14
|
+
"named by the first of MG_DATABASE_URL, AUTH_DATABASE_URL or "
|
|
15
|
+
"AUTH_POSTGRESQL_URL that is set."
|
|
16
|
+
)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def migrations_root() -> Path:
|
|
20
|
+
return Path(__file__).resolve().parent
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def database_url(environ: Mapping[str, str]) -> Optional[str]:
|
|
24
|
+
for name in URL_VARIABLES:
|
|
25
|
+
value = environ.get(name, "").strip()
|
|
26
|
+
if not value:
|
|
27
|
+
continue
|
|
28
|
+
for prefix in DRIVER_PREFIXES:
|
|
29
|
+
if value.startswith(prefix):
|
|
30
|
+
return "postgresql://" + value[len(prefix) :]
|
|
31
|
+
return value
|
|
32
|
+
return None
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def _refuse(message: str) -> int:
|
|
36
|
+
print(f"auth-migrate: {message}", file=sys.stderr)
|
|
37
|
+
return 2
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def main(argv: Optional[List[str]] = None) -> int:
|
|
41
|
+
args = list(sys.argv[1:] if argv is None else argv)
|
|
42
|
+
if not args or args[0] not in COMMANDS:
|
|
43
|
+
print(USAGE, file=sys.stderr)
|
|
44
|
+
return 2
|
|
45
|
+
if importlib.util.find_spec("migretti") is None:
|
|
46
|
+
return _refuse('migretti is not installed; install "auth[migrations]"')
|
|
47
|
+
url = database_url(os.environ)
|
|
48
|
+
if url is None:
|
|
49
|
+
return _refuse("set MG_DATABASE_URL, AUTH_DATABASE_URL or AUTH_POSTGRESQL_URL")
|
|
50
|
+
if not url.startswith(("postgresql://", "postgres://")):
|
|
51
|
+
return _refuse("the shipped migrations target PostgreSQL only")
|
|
52
|
+
environment = dict(os.environ, MG_DATABASE_URL=url)
|
|
53
|
+
return subprocess.call(
|
|
54
|
+
[sys.executable, "-m", "migretti", *args],
|
|
55
|
+
cwd=migrations_root(),
|
|
56
|
+
env=environment,
|
|
57
|
+
)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
if __name__ == "__main__":
|
|
61
|
+
sys.exit(main())
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
-- migration: add_auth_api_key
|
|
2
|
+
-- id: 01KYTMDEYFVH43HKR0MQWW1EMP
|
|
3
|
+
--
|
|
4
|
+
-- Per-user API-key registry (SPEC 0004, issuedb #9). Mirrors the SQLAlchemy
|
|
5
|
+
-- model auth.models.sql.AuthApiKey exactly — the app's boot-time
|
|
6
|
+
-- create_all(checkfirst=True) may legally create this table first on a fresh
|
|
7
|
+
-- install, so every statement is IF NOT EXISTS and the two DDL paths converge
|
|
8
|
+
-- in either order. Schema is the production/CI deployment schema (auth_rbac,
|
|
9
|
+
-- AUTH_DATABASE_SCHEMA); schemaless SQLite/dev installs are covered by
|
|
10
|
+
-- create_all and never run migretti.
|
|
11
|
+
|
|
12
|
+
-- migrate: up
|
|
13
|
+
CREATE SCHEMA IF NOT EXISTS auth_rbac;
|
|
14
|
+
|
|
15
|
+
CREATE TABLE IF NOT EXISTS auth_rbac.auth_api_key (
|
|
16
|
+
id SERIAL PRIMARY KEY,
|
|
17
|
+
key_id VARCHAR(36) NOT NULL,
|
|
18
|
+
creator VARCHAR(64) NOT NULL,
|
|
19
|
+
"user" TEXT NOT NULL,
|
|
20
|
+
key_hash VARCHAR(64) NOT NULL,
|
|
21
|
+
key_prefix VARCHAR(16) NOT NULL,
|
|
22
|
+
label TEXT,
|
|
23
|
+
is_active BOOLEAN DEFAULT TRUE,
|
|
24
|
+
date_created TIMESTAMP DEFAULT now(),
|
|
25
|
+
modified TIMESTAMP DEFAULT now(),
|
|
26
|
+
revoked_at TIMESTAMP,
|
|
27
|
+
expires_at TIMESTAMP,
|
|
28
|
+
last_used_at TIMESTAMP,
|
|
29
|
+
CONSTRAINT uq_auth_api_key_key_hash UNIQUE (key_hash),
|
|
30
|
+
CONSTRAINT uq_auth_api_key_key_id UNIQUE (key_id)
|
|
31
|
+
);
|
|
32
|
+
|
|
33
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_api_key_id
|
|
34
|
+
ON auth_rbac.auth_api_key (id);
|
|
35
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_api_key_creator
|
|
36
|
+
ON auth_rbac.auth_api_key (creator);
|
|
37
|
+
CREATE INDEX IF NOT EXISTS ix_auth_api_key_creator_user
|
|
38
|
+
ON auth_rbac.auth_api_key (creator, "user");
|
|
39
|
+
|
|
40
|
+
-- migrate: down
|
|
41
|
+
DROP TABLE IF EXISTS auth_rbac.auth_api_key;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
-- migration: drop_alembic_version
|
|
2
|
+
-- id: 01KYTQN79R1ZBNDPA3ND9AAA73
|
|
3
|
+
--
|
|
4
|
+
-- Alembic is fully purged (issuedb #14, SPEC 0009): migretti owns all
|
|
5
|
+
-- tracking, so the legacy alembic_version table goes. Its single recorded
|
|
6
|
+
-- revision was 0001_widen_text (varchar->TEXT widening, applied 2026-07);
|
|
7
|
+
-- the revision source now lives in git history only. The down section
|
|
8
|
+
-- faithfully restores the table and its one row. On databases that never ran
|
|
9
|
+
-- Alembic (fresh installs, CI) the up is a no-op.
|
|
10
|
+
|
|
11
|
+
-- migrate: up
|
|
12
|
+
DROP TABLE IF EXISTS auth_rbac.alembic_version;
|
|
13
|
+
|
|
14
|
+
-- migrate: down
|
|
15
|
+
CREATE TABLE IF NOT EXISTS auth_rbac.alembic_version (
|
|
16
|
+
version_num VARCHAR(32) NOT NULL,
|
|
17
|
+
CONSTRAINT alembic_version_pkc PRIMARY KEY (version_num)
|
|
18
|
+
);
|
|
19
|
+
INSERT INTO auth_rbac.alembic_version (version_num)
|
|
20
|
+
VALUES ('0001_widen_text')
|
|
21
|
+
ON CONFLICT DO NOTHING;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
-- migration: add_auth_tenant_settings
|
|
2
|
+
-- id: 01KYTRKMWNBDDZPN1H0AXRTT5G
|
|
3
|
+
--
|
|
4
|
+
-- Per-tenant settings (SPEC 0010, issuedb #15) — one row per creator, absence
|
|
5
|
+
-- means defaults. strict_users gates SPEC 0008 strict user identity (opt-in
|
|
6
|
+
-- in 2.5.0; default flip is 3.0.0, gated on client confirmations). Mirrors
|
|
7
|
+
-- auth.models.sql.AuthTenantSettings; IF NOT EXISTS so create_all(checkfirst)
|
|
8
|
+
-- and mg apply converge in either order.
|
|
9
|
+
|
|
10
|
+
-- migrate: up
|
|
11
|
+
CREATE SCHEMA IF NOT EXISTS auth_rbac;
|
|
12
|
+
|
|
13
|
+
CREATE TABLE IF NOT EXISTS auth_rbac.auth_tenant_settings (
|
|
14
|
+
id SERIAL PRIMARY KEY,
|
|
15
|
+
creator VARCHAR(64) NOT NULL,
|
|
16
|
+
strict_users BOOLEAN NOT NULL DEFAULT FALSE,
|
|
17
|
+
date_created TIMESTAMP DEFAULT now(),
|
|
18
|
+
modified TIMESTAMP DEFAULT now(),
|
|
19
|
+
CONSTRAINT uq_auth_tenant_settings_creator UNIQUE (creator)
|
|
20
|
+
);
|
|
21
|
+
|
|
22
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_tenant_settings_id
|
|
23
|
+
ON auth_rbac.auth_tenant_settings (id);
|
|
24
|
+
|
|
25
|
+
-- migrate: down
|
|
26
|
+
DROP TABLE IF EXISTS auth_rbac.auth_tenant_settings;
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
-- migration: grandfather_strict_users
|
|
2
|
+
-- id: 01KYTX0MKVZ775P62CJ87631Z1
|
|
3
|
+
--
|
|
4
|
+
-- 3.0.0 flip protection (SPEC 0012, issuedb #18): every creator existing on
|
|
5
|
+
-- this database gets an explicit strict_users=false row, so the 3.0.0
|
|
6
|
+
-- no-row-means-strict default reaches ONLY tenants created afterwards. A
|
|
7
|
+
-- marker row ('__meta:grandfathered-3.0__', reserved) records that the pass
|
|
8
|
+
-- ran; the identical marker-guarded pass in auth.database.create_tables()
|
|
9
|
+
-- composes idempotently with this migration in either order.
|
|
10
|
+
--
|
|
11
|
+
-- The three base RBAC tables are created here IF NOT EXISTS (exact
|
|
12
|
+
-- create_all parity, like add_auth_api_key did for its table): on a fresh
|
|
13
|
+
-- database migrations must be self-sufficient — production already has
|
|
14
|
+
-- them, so these are no-ops there.
|
|
15
|
+
--
|
|
16
|
+
-- down removes the marker only: the grandfather rows are deliberate,
|
|
17
|
+
-- auditable tenant state and are kept on rollback.
|
|
18
|
+
|
|
19
|
+
-- migrate: up
|
|
20
|
+
CREATE SCHEMA IF NOT EXISTS auth_rbac;
|
|
21
|
+
|
|
22
|
+
CREATE TABLE IF NOT EXISTS auth_rbac.auth_group (
|
|
23
|
+
id SERIAL PRIMARY KEY,
|
|
24
|
+
creator VARCHAR(64) NOT NULL,
|
|
25
|
+
role TEXT NOT NULL,
|
|
26
|
+
description TEXT,
|
|
27
|
+
is_active BOOLEAN DEFAULT TRUE,
|
|
28
|
+
date_created TIMESTAMP DEFAULT now(),
|
|
29
|
+
modified TIMESTAMP DEFAULT now(),
|
|
30
|
+
CONSTRAINT uq_auth_group_creator_role UNIQUE (creator, role)
|
|
31
|
+
);
|
|
32
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_group_id ON auth_rbac.auth_group (id);
|
|
33
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_group_creator ON auth_rbac.auth_group (creator);
|
|
34
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_group_role ON auth_rbac.auth_group (role);
|
|
35
|
+
|
|
36
|
+
CREATE TABLE IF NOT EXISTS auth_rbac.auth_membership (
|
|
37
|
+
id SERIAL PRIMARY KEY,
|
|
38
|
+
"user" TEXT NOT NULL,
|
|
39
|
+
creator VARCHAR(64) NOT NULL,
|
|
40
|
+
is_active BOOLEAN DEFAULT TRUE,
|
|
41
|
+
date_created TIMESTAMP DEFAULT now(),
|
|
42
|
+
modified TIMESTAMP DEFAULT now(),
|
|
43
|
+
CONSTRAINT uq_auth_membership_creator_user UNIQUE (creator, "user")
|
|
44
|
+
);
|
|
45
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_membership_id ON auth_rbac.auth_membership (id);
|
|
46
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_membership_creator ON auth_rbac.auth_membership (creator);
|
|
47
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_membership_user ON auth_rbac.auth_membership ("user");
|
|
48
|
+
|
|
49
|
+
CREATE TABLE IF NOT EXISTS auth_rbac.auth_permission (
|
|
50
|
+
id SERIAL PRIMARY KEY,
|
|
51
|
+
name TEXT NOT NULL,
|
|
52
|
+
creator VARCHAR(64) NOT NULL,
|
|
53
|
+
is_active BOOLEAN DEFAULT TRUE,
|
|
54
|
+
date_created TIMESTAMP DEFAULT now(),
|
|
55
|
+
modified TIMESTAMP DEFAULT now(),
|
|
56
|
+
CONSTRAINT uq_auth_permission_creator_name UNIQUE (creator, name)
|
|
57
|
+
);
|
|
58
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_permission_id ON auth_rbac.auth_permission (id);
|
|
59
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_permission_creator ON auth_rbac.auth_permission (creator);
|
|
60
|
+
CREATE INDEX IF NOT EXISTS ix_auth_rbac_auth_permission_name ON auth_rbac.auth_permission (name);
|
|
61
|
+
|
|
62
|
+
INSERT INTO auth_rbac.auth_tenant_settings (creator, strict_users)
|
|
63
|
+
SELECT c.creator, FALSE
|
|
64
|
+
FROM (
|
|
65
|
+
SELECT creator FROM auth_rbac.auth_group
|
|
66
|
+
UNION SELECT creator FROM auth_rbac.auth_membership
|
|
67
|
+
UNION SELECT creator FROM auth_rbac.auth_permission
|
|
68
|
+
UNION SELECT creator FROM auth_rbac.auth_api_key
|
|
69
|
+
) c
|
|
70
|
+
WHERE NOT EXISTS (
|
|
71
|
+
SELECT 1 FROM auth_rbac.auth_tenant_settings
|
|
72
|
+
WHERE creator = '__meta:grandfathered-3.0__'
|
|
73
|
+
)
|
|
74
|
+
AND c.creator NOT IN (SELECT creator FROM auth_rbac.auth_tenant_settings);
|
|
75
|
+
|
|
76
|
+
INSERT INTO auth_rbac.auth_tenant_settings (creator, strict_users)
|
|
77
|
+
SELECT '__meta:grandfathered-3.0__', FALSE
|
|
78
|
+
WHERE NOT EXISTS (
|
|
79
|
+
SELECT 1 FROM auth_rbac.auth_tenant_settings
|
|
80
|
+
WHERE creator = '__meta:grandfathered-3.0__'
|
|
81
|
+
);
|
|
82
|
+
|
|
83
|
+
-- migrate: down
|
|
84
|
+
DELETE FROM auth_rbac.auth_tenant_settings
|
|
85
|
+
WHERE creator = '__meta:grandfathered-3.0__';
|