trueppm-api 0.4.0b2__py3-none-any.whl

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.
Files changed (759) hide show
  1. trueppm_api/__init__.py +14 -0
  2. trueppm_api/apps/access/__init__.py +0 -0
  3. trueppm_api/apps/access/apps.py +19 -0
  4. trueppm_api/apps/access/groups.py +518 -0
  5. trueppm_api/apps/access/management/__init__.py +0 -0
  6. trueppm_api/apps/access/management/commands/__init__.py +0 -0
  7. trueppm_api/apps/access/management/commands/create_admin.py +164 -0
  8. trueppm_api/apps/access/management/commands/migrate_locked.py +96 -0
  9. trueppm_api/apps/access/management/commands/revoke_api_tokens.py +209 -0
  10. trueppm_api/apps/access/migrations/0001_initial.py +61 -0
  11. trueppm_api/apps/access/migrations/0001_squashed_0012_programmembership_role_title.py +167 -0
  12. trueppm_api/apps/access/migrations/0002_alter_projectmembership_id.py +29 -0
  13. trueppm_api/apps/access/migrations/0003_projectmembership_soft_delete.py +24 -0
  14. trueppm_api/apps/access/migrations/0004_alter_projectmembership_role.py +34 -0
  15. trueppm_api/apps/access/migrations/0005_program_entity_and_membership.py +76 -0
  16. trueppm_api/apps/access/migrations/0006_role_ordinal_spacing.py +113 -0
  17. trueppm_api/apps/access/migrations/0007_projectmembership_joined_at_and_more.py +35 -0
  18. trueppm_api/apps/access/migrations/0008_projectmembership_source_group.py +25 -0
  19. trueppm_api/apps/access/migrations/0009_projectmembership_pm_proj_serverver_idx.py +20 -0
  20. trueppm_api/apps/access/migrations/0010_programmembership_joined_at_and_more.py +38 -0
  21. trueppm_api/apps/access/migrations/0011_alter_programmembership_unique_together_and_more.py +36 -0
  22. trueppm_api/apps/access/migrations/0012_programmembership_role_title.py +17 -0
  23. trueppm_api/apps/access/migrations/0013_userdefinedmentiongroup.py +82 -0
  24. trueppm_api/apps/access/migrations/0014_programmembership_progm_serverver_idx.py +19 -0
  25. trueppm_api/apps/access/migrations/0015_programuserdefinedmentiongroup.py +86 -0
  26. trueppm_api/apps/access/migrations/0016_externalstakeholder.py +67 -0
  27. trueppm_api/apps/access/migrations/0017_viewer_ordinal_one.py +132 -0
  28. trueppm_api/apps/access/migrations/0018_programmembership_sync_seq_and_more.py +52 -0
  29. trueppm_api/apps/access/migrations/0019_programmembership_reinstated_at_and_more.py +22 -0
  30. trueppm_api/apps/access/migrations/__init__.py +0 -0
  31. trueppm_api/apps/access/models.py +588 -0
  32. trueppm_api/apps/access/permissions.py +2837 -0
  33. trueppm_api/apps/access/serializers.py +946 -0
  34. trueppm_api/apps/access/services.py +667 -0
  35. trueppm_api/apps/access/signals.py +103 -0
  36. trueppm_api/apps/access/tasks.py +50 -0
  37. trueppm_api/apps/access/throttles.py +95 -0
  38. trueppm_api/apps/access/urls.py +191 -0
  39. trueppm_api/apps/access/views.py +1931 -0
  40. trueppm_api/apps/agents/__init__.py +6 -0
  41. trueppm_api/apps/agents/apps.py +11 -0
  42. trueppm_api/apps/agents/canonical.py +73 -0
  43. trueppm_api/apps/agents/deferred.py +108 -0
  44. trueppm_api/apps/agents/management/__init__.py +0 -0
  45. trueppm_api/apps/agents/management/commands/__init__.py +0 -0
  46. trueppm_api/apps/agents/management/commands/audit_prune.py +137 -0
  47. trueppm_api/apps/agents/management/commands/audit_verify.py +101 -0
  48. trueppm_api/apps/agents/middleware.py +44 -0
  49. trueppm_api/apps/agents/migrations/0001_initial.py +231 -0
  50. trueppm_api/apps/agents/migrations/0002_agentactioncheckpoint.py +71 -0
  51. trueppm_api/apps/agents/migrations/0003_agentactionrefusaldetail.py +58 -0
  52. trueppm_api/apps/agents/migrations/__init__.py +0 -0
  53. trueppm_api/apps/agents/models.py +371 -0
  54. trueppm_api/apps/agents/refusal.py +103 -0
  55. trueppm_api/apps/agents/serializers.py +85 -0
  56. trueppm_api/apps/agents/services.py +397 -0
  57. trueppm_api/apps/agents/signals.py +30 -0
  58. trueppm_api/apps/agents/urls.py +15 -0
  59. trueppm_api/apps/agents/views.py +108 -0
  60. trueppm_api/apps/csvimport/__init__.py +12 -0
  61. trueppm_api/apps/csvimport/apps.py +11 -0
  62. trueppm_api/apps/csvimport/mapping.py +363 -0
  63. trueppm_api/apps/csvimport/migrations/0001_initial.py +74 -0
  64. trueppm_api/apps/csvimport/migrations/0002_schedule_outline_batch_operations.py +37 -0
  65. trueppm_api/apps/csvimport/migrations/0003_csvimportrequest_date_order_and_more.py +26 -0
  66. trueppm_api/apps/csvimport/migrations/__init__.py +0 -0
  67. trueppm_api/apps/csvimport/models.py +111 -0
  68. trueppm_api/apps/csvimport/parser.py +1825 -0
  69. trueppm_api/apps/csvimport/services.py +48 -0
  70. trueppm_api/apps/csvimport/tasks.py +418 -0
  71. trueppm_api/apps/csvimport/template.py +37 -0
  72. trueppm_api/apps/csvimport/urls.py +50 -0
  73. trueppm_api/apps/csvimport/views.py +793 -0
  74. trueppm_api/apps/history/__init__.py +0 -0
  75. trueppm_api/apps/history/apps.py +12 -0
  76. trueppm_api/apps/history/changelog.py +359 -0
  77. trueppm_api/apps/history/diff_policy.py +177 -0
  78. trueppm_api/apps/history/serializers.py +104 -0
  79. trueppm_api/apps/history/signals.py +82 -0
  80. trueppm_api/apps/history/tasks.py +105 -0
  81. trueppm_api/apps/history/urls.py +38 -0
  82. trueppm_api/apps/history/views.py +443 -0
  83. trueppm_api/apps/idempotency/__init__.py +0 -0
  84. trueppm_api/apps/idempotency/apps.py +11 -0
  85. trueppm_api/apps/idempotency/migrations/0001_initial.py +71 -0
  86. trueppm_api/apps/idempotency/migrations/__init__.py +0 -0
  87. trueppm_api/apps/idempotency/mixins.py +226 -0
  88. trueppm_api/apps/idempotency/models.py +75 -0
  89. trueppm_api/apps/idempotency/tasks.py +61 -0
  90. trueppm_api/apps/integrations/__init__.py +13 -0
  91. trueppm_api/apps/integrations/apps.py +59 -0
  92. trueppm_api/apps/integrations/connections.py +806 -0
  93. trueppm_api/apps/integrations/encryption.py +92 -0
  94. trueppm_api/apps/integrations/external_sources.py +837 -0
  95. trueppm_api/apps/integrations/git_automation_services.py +231 -0
  96. trueppm_api/apps/integrations/git_webhook_auth.py +243 -0
  97. trueppm_api/apps/integrations/http.py +403 -0
  98. trueppm_api/apps/integrations/me_work.py +218 -0
  99. trueppm_api/apps/integrations/migrations/0001_initial.py +64 -0
  100. trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py +187 -0
  101. trueppm_api/apps/integrations/migrations/0002_tasklink.py +67 -0
  102. trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py +17 -0
  103. trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py +25 -0
  104. trueppm_api/apps/integrations/migrations/0005_boardautomation.py +56 -0
  105. trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py +40 -0
  106. trueppm_api/apps/integrations/migrations/0007_tasklink_created_at.py +23 -0
  107. trueppm_api/apps/integrations/migrations/0008_integrationcredential_config_externalworkitem.py +66 -0
  108. trueppm_api/apps/integrations/migrations/0009_externalsyncrequest_and_more.py +96 -0
  109. trueppm_api/apps/integrations/migrations/0010_externalworkitem_due_date.py +17 -0
  110. trueppm_api/apps/integrations/migrations/0011_tasklink_sync_seq_tasklink_tasklink_syncseq_idx.py +22 -0
  111. trueppm_api/apps/integrations/migrations/0012_boardautomation_last_delivery_at_and_more.py +42 -0
  112. trueppm_api/apps/integrations/migrations/0013_externalsyncrequest_attempt_count_and_more.py +26 -0
  113. trueppm_api/apps/integrations/migrations/__init__.py +0 -0
  114. trueppm_api/apps/integrations/models.py +622 -0
  115. trueppm_api/apps/integrations/notification_channels.py +57 -0
  116. trueppm_api/apps/integrations/opengraph.py +229 -0
  117. trueppm_api/apps/integrations/outgoing.py +201 -0
  118. trueppm_api/apps/integrations/providers.py +519 -0
  119. trueppm_api/apps/integrations/registry.py +345 -0
  120. trueppm_api/apps/integrations/serializers.py +453 -0
  121. trueppm_api/apps/integrations/services.py +171 -0
  122. trueppm_api/apps/integrations/tasks.py +731 -0
  123. trueppm_api/apps/integrations/throttles.py +165 -0
  124. trueppm_api/apps/integrations/urls.py +77 -0
  125. trueppm_api/apps/integrations/views.py +1106 -0
  126. trueppm_api/apps/jiraimport/__init__.py +8 -0
  127. trueppm_api/apps/jiraimport/apps.py +11 -0
  128. trueppm_api/apps/jiraimport/migrations/0001_initial.py +72 -0
  129. trueppm_api/apps/jiraimport/migrations/__init__.py +0 -0
  130. trueppm_api/apps/jiraimport/models.py +70 -0
  131. trueppm_api/apps/jiraimport/parser.py +350 -0
  132. trueppm_api/apps/jiraimport/services.py +46 -0
  133. trueppm_api/apps/jiraimport/tasks.py +277 -0
  134. trueppm_api/apps/jiraimport/urls.py +15 -0
  135. trueppm_api/apps/jiraimport/views.py +153 -0
  136. trueppm_api/apps/msproject/__init__.py +0 -0
  137. trueppm_api/apps/msproject/apps.py +11 -0
  138. trueppm_api/apps/msproject/dataclasses.py +153 -0
  139. trueppm_api/apps/msproject/exporter.py +500 -0
  140. trueppm_api/apps/msproject/extended_attributes.py +77 -0
  141. trueppm_api/apps/msproject/importer.py +1095 -0
  142. trueppm_api/apps/msproject/migrations/0001_import_request.py +77 -0
  143. trueppm_api/apps/msproject/migrations/0001_squashed_0002_importrequest_creates_project.py +80 -0
  144. trueppm_api/apps/msproject/migrations/0002_importrequest_creates_project.py +15 -0
  145. trueppm_api/apps/msproject/migrations/__init__.py +0 -0
  146. trueppm_api/apps/msproject/models.py +81 -0
  147. trueppm_api/apps/msproject/parser.py +1231 -0
  148. trueppm_api/apps/msproject/serializers.py +136 -0
  149. trueppm_api/apps/msproject/services.py +58 -0
  150. trueppm_api/apps/msproject/tasks.py +436 -0
  151. trueppm_api/apps/msproject/urls.py +39 -0
  152. trueppm_api/apps/msproject/views.py +531 -0
  153. trueppm_api/apps/notifications/__init__.py +7 -0
  154. trueppm_api/apps/notifications/apps.py +15 -0
  155. trueppm_api/apps/notifications/backfill.py +79 -0
  156. trueppm_api/apps/notifications/categories.py +112 -0
  157. trueppm_api/apps/notifications/delivery_limits.py +258 -0
  158. trueppm_api/apps/notifications/digests.py +447 -0
  159. trueppm_api/apps/notifications/email_backend.py +330 -0
  160. trueppm_api/apps/notifications/email_health.py +128 -0
  161. trueppm_api/apps/notifications/migrations/0001_initial.py +207 -0
  162. trueppm_api/apps/notifications/migrations/0001_squashed_0006_notification_task.py +294 -0
  163. trueppm_api/apps/notifications/migrations/0002_project_notification_preference.py +67 -0
  164. trueppm_api/apps/notifications/migrations/0003_projectnotificationpreference_paused.py +17 -0
  165. trueppm_api/apps/notifications/migrations/0004_clean_unknown_matrix_keys.py +30 -0
  166. trueppm_api/apps/notifications/migrations/0005_notification_body_notification_event_type_and_more.py +27 -0
  167. trueppm_api/apps/notifications/migrations/0006_notification_task.py +25 -0
  168. trueppm_api/apps/notifications/migrations/0007_workspaceemailsettings.py +80 -0
  169. trueppm_api/apps/notifications/migrations/0008_notification_snoozed_until.py +17 -0
  170. trueppm_api/apps/notifications/migrations/0009_usernotificationsettings.py +43 -0
  171. trueppm_api/apps/notifications/migrations/0010_projectnotificationpreference_schema_version.py +20 -0
  172. trueppm_api/apps/notifications/migrations/0011_usernotificationsettings_digest_hour_and_more.py +96 -0
  173. trueppm_api/apps/notifications/migrations/__init__.py +0 -0
  174. trueppm_api/apps/notifications/models.py +1197 -0
  175. trueppm_api/apps/notifications/receivers.py +155 -0
  176. trueppm_api/apps/notifications/schema_migrations.py +56 -0
  177. trueppm_api/apps/notifications/serializers.py +961 -0
  178. trueppm_api/apps/notifications/services.py +1451 -0
  179. trueppm_api/apps/notifications/tasks.py +711 -0
  180. trueppm_api/apps/notifications/throttles.py +98 -0
  181. trueppm_api/apps/notifications/urls.py +97 -0
  182. trueppm_api/apps/notifications/views.py +904 -0
  183. trueppm_api/apps/observability/__init__.py +0 -0
  184. trueppm_api/apps/observability/apps.py +31 -0
  185. trueppm_api/apps/observability/logging.py +213 -0
  186. trueppm_api/apps/observability/migrations/0001_initial.py +35 -0
  187. trueppm_api/apps/observability/migrations/0001_squashed_0003_alter_purgerun_trigger.py +154 -0
  188. trueppm_api/apps/observability/migrations/0002_purgerun_retentionpolicy_retentionschedule.py +131 -0
  189. trueppm_api/apps/observability/migrations/0003_alter_purgerun_trigger.py +21 -0
  190. trueppm_api/apps/observability/migrations/0004_alter_retentionpolicy_key.py +28 -0
  191. trueppm_api/apps/observability/migrations/__init__.py +0 -0
  192. trueppm_api/apps/observability/models.py +141 -0
  193. trueppm_api/apps/observability/otel/__init__.py +45 -0
  194. trueppm_api/apps/observability/otel/attributes.py +247 -0
  195. trueppm_api/apps/observability/otel/export_health.py +533 -0
  196. trueppm_api/apps/observability/otel/instrumentation.py +351 -0
  197. trueppm_api/apps/observability/otel/metrics.py +551 -0
  198. trueppm_api/apps/observability/otel/provider.py +511 -0
  199. trueppm_api/apps/observability/otel/request_attributes.py +204 -0
  200. trueppm_api/apps/observability/purge_registry.py +124 -0
  201. trueppm_api/apps/observability/retention.py +139 -0
  202. trueppm_api/apps/observability/selectors.py +969 -0
  203. trueppm_api/apps/observability/serializers.py +142 -0
  204. trueppm_api/apps/observability/services.py +407 -0
  205. trueppm_api/apps/observability/tasks.py +266 -0
  206. trueppm_api/apps/observability/urls.py +27 -0
  207. trueppm_api/apps/observability/views.py +523 -0
  208. trueppm_api/apps/profiles/__init__.py +0 -0
  209. trueppm_api/apps/profiles/apps.py +15 -0
  210. trueppm_api/apps/profiles/constants.py +54 -0
  211. trueppm_api/apps/profiles/migrations/0001_initial.py +55 -0
  212. trueppm_api/apps/profiles/migrations/0001_squashed_0004_userprofile_role_context.py +125 -0
  213. trueppm_api/apps/profiles/migrations/0002_userprofile_hidden_views.py +17 -0
  214. trueppm_api/apps/profiles/migrations/0003_projectvisit.py +63 -0
  215. trueppm_api/apps/profiles/migrations/0004_userprofile_role_context.py +26 -0
  216. trueppm_api/apps/profiles/migrations/0005_userprofile_schedule_in_deliver.py +20 -0
  217. trueppm_api/apps/profiles/migrations/0006_userprofile_date_format_userprofile_timezone.py +36 -0
  218. trueppm_api/apps/profiles/migrations/0007_userpin.py +91 -0
  219. trueppm_api/apps/profiles/migrations/0008_remove_userprofile_schedule_in_deliver.py +71 -0
  220. trueppm_api/apps/profiles/migrations/0009_auth_user_email_upper_idx.py +81 -0
  221. trueppm_api/apps/profiles/migrations/__init__.py +0 -0
  222. trueppm_api/apps/profiles/models.py +276 -0
  223. trueppm_api/apps/profiles/serializers.py +199 -0
  224. trueppm_api/apps/profiles/services.py +466 -0
  225. trueppm_api/apps/profiles/views.py +124 -0
  226. trueppm_api/apps/projects/__init__.py +0 -0
  227. trueppm_api/apps/projects/actual_date_rules.py +163 -0
  228. trueppm_api/apps/projects/amend.py +133 -0
  229. trueppm_api/apps/projects/apps.py +38 -0
  230. trueppm_api/apps/projects/asset_feed.py +459 -0
  231. trueppm_api/apps/projects/asset_views.py +317 -0
  232. trueppm_api/apps/projects/attachment_policy.py +278 -0
  233. trueppm_api/apps/projects/authentication.py +449 -0
  234. trueppm_api/apps/projects/backfill.py +287 -0
  235. trueppm_api/apps/projects/backlog_services.py +324 -0
  236. trueppm_api/apps/projects/backlog_views.py +302 -0
  237. trueppm_api/apps/projects/batch_operation_views.py +264 -0
  238. trueppm_api/apps/projects/blocker_services.py +510 -0
  239. trueppm_api/apps/projects/board_activity.py +462 -0
  240. trueppm_api/apps/projects/board_activity_views.py +186 -0
  241. trueppm_api/apps/projects/board_lanes.py +134 -0
  242. trueppm_api/apps/projects/bulk_settings.py +194 -0
  243. trueppm_api/apps/projects/bundled_templates.py +215 -0
  244. trueppm_api/apps/projects/calendar_settings.py +180 -0
  245. trueppm_api/apps/projects/ceremony_views.py +244 -0
  246. trueppm_api/apps/projects/commit_moment.py +204 -0
  247. trueppm_api/apps/projects/config_notice.py +1325 -0
  248. trueppm_api/apps/projects/custom_field_values.py +266 -0
  249. trueppm_api/apps/projects/decisions_services.py +93 -0
  250. trueppm_api/apps/projects/decisions_views.py +94 -0
  251. trueppm_api/apps/projects/estimation_scale.py +126 -0
  252. trueppm_api/apps/projects/export_bundle.py +353 -0
  253. trueppm_api/apps/projects/fixtures/seeds/atlas-platform-launch.json +4256 -0
  254. trueppm_api/apps/projects/fixtures/seeds/aurora-mobile-app.json +2000 -0
  255. trueppm_api/apps/projects/fixtures/seeds/bayside-civic-center.json +1825 -0
  256. trueppm_api/apps/projects/fixtures/seeds/ga-launch.json +1905 -0
  257. trueppm_api/apps/projects/fixtures/seeds/helios-crm-replacement.json +1409 -0
  258. trueppm_api/apps/projects/guardrail_policy_source.py +269 -0
  259. trueppm_api/apps/projects/inbound_sync.py +555 -0
  260. trueppm_api/apps/projects/iteration_label.py +85 -0
  261. trueppm_api/apps/projects/lifecycle.py +191 -0
  262. trueppm_api/apps/projects/management/__init__.py +0 -0
  263. trueppm_api/apps/projects/management/commands/__init__.py +0 -0
  264. trueppm_api/apps/projects/management/commands/backfill_in_progress_status.py +92 -0
  265. trueppm_api/apps/projects/management/commands/create_demo_share_link.py +368 -0
  266. trueppm_api/apps/projects/management/commands/export_program.py +50 -0
  267. trueppm_api/apps/projects/management/commands/import_seed.py +165 -0
  268. trueppm_api/apps/projects/management/commands/load_sample_project.py +247 -0
  269. trueppm_api/apps/projects/management/commands/seed_capacity.py +405 -0
  270. trueppm_api/apps/projects/management/commands/seed_integration_fixtures.py +178 -0
  271. trueppm_api/apps/projects/management/commands/shift_sample_dates.py +120 -0
  272. trueppm_api/apps/projects/mcp_settings.py +305 -0
  273. trueppm_api/apps/projects/methodology.py +178 -0
  274. trueppm_api/apps/projects/migrations/0001_initial.py +208 -0
  275. trueppm_api/apps/projects/migrations/0001_squashed_0094_project_decisions_policy.py +5595 -0
  276. trueppm_api/apps/projects/migrations/0002_alter_uuid_pk_serialize_false.py +57 -0
  277. trueppm_api/apps/projects/migrations/0003_rename_task_project_index.py +25 -0
  278. trueppm_api/apps/projects/migrations/0004_soft_delete_and_dependency_versioned.py +70 -0
  279. trueppm_api/apps/projects/migrations/0005_task_assignee.py +33 -0
  280. trueppm_api/apps/projects/migrations/0006_task_utilization_index.py +31 -0
  281. trueppm_api/apps/projects/migrations/0007_task_is_milestone.py +28 -0
  282. trueppm_api/apps/projects/migrations/0008_baseline.py +119 -0
  283. trueppm_api/apps/projects/migrations/0009_historicaldependency_historicalproject_and_more.py +210 -0
  284. trueppm_api/apps/projects/migrations/0010_risk.py +229 -0
  285. trueppm_api/apps/projects/migrations/0011_task_status.py +27 -0
  286. trueppm_api/apps/projects/migrations/0012_task_status.py +27 -0
  287. trueppm_api/apps/projects/migrations/0013_task_planned_start.py +24 -0
  288. trueppm_api/apps/projects/migrations/0014_short_hex_ids.py +74 -0
  289. trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py +48 -0
  290. trueppm_api/apps/projects/migrations/0016_task_actual_dates.py +42 -0
  291. trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py +43 -0
  292. trueppm_api/apps/projects/migrations/0018_estimation_governance.py +62 -0
  293. trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py +28 -0
  294. trueppm_api/apps/projects/migrations/0020_task_status_5col.py +65 -0
  295. trueppm_api/apps/projects/migrations/0021_boardsavedview.py +64 -0
  296. trueppm_api/apps/projects/migrations/0022_task_status_changed_at_priority_rank.py +35 -0
  297. trueppm_api/apps/projects/migrations/0023_risk_framework_fields.py +96 -0
  298. trueppm_api/apps/projects/migrations/0024_riskcomment.py +52 -0
  299. trueppm_api/apps/projects/migrations/0025_sprint.py +352 -0
  300. trueppm_api/apps/projects/migrations/0026_project_methodology.py +30 -0
  301. trueppm_api/apps/projects/migrations/0027_sprint_retro.py +89 -0
  302. trueppm_api/apps/projects/migrations/0028_normalize_notes_field.py +42 -0
  303. trueppm_api/apps/projects/migrations/0029_complete_implies_full_progress.py +38 -0
  304. trueppm_api/apps/projects/migrations/0030_review_implies_full_progress.py +37 -0
  305. trueppm_api/apps/projects/migrations/0031_task_remaining_points.py +22 -0
  306. trueppm_api/apps/projects/migrations/0032_task_is_subtask_and_sprint_scope_change.py +90 -0
  307. trueppm_api/apps/projects/migrations/0033_task_my_work_index.py +38 -0
  308. trueppm_api/apps/projects/migrations/0034_inbound_task_sync.py +313 -0
  309. trueppm_api/apps/projects/migrations/0035_retro_versioned_and_suggested_assignee.py +173 -0
  310. trueppm_api/apps/projects/migrations/0036_program_entity_and_membership.py +157 -0
  311. trueppm_api/apps/projects/migrations/0037_sprint_capacity_points.py +20 -0
  312. trueppm_api/apps/projects/migrations/0038_taskcomment_commentreaction_commentacknowledgement_and_more.py +233 -0
  313. trueppm_api/apps/projects/migrations/0039_apitoken_and_more.py +88 -0
  314. trueppm_api/apps/projects/migrations/0040_program_general_fields.py +119 -0
  315. trueppm_api/apps/projects/migrations/0041_ceremony_template_and_phase_gate_config.py +210 -0
  316. trueppm_api/apps/projects/migrations/0041_project_general_fields.py +106 -0
  317. trueppm_api/apps/projects/migrations/0042_merge_20260522_0410.py +12 -0
  318. trueppm_api/apps/projects/migrations/0042_program_rollup_config.py +95 -0
  319. trueppm_api/apps/projects/migrations/0042_workflow_color_and_custom_fields.py +94 -0
  320. trueppm_api/apps/projects/migrations/0043_merge_20260522_1118.py +10 -0
  321. trueppm_api/apps/projects/migrations/0044_merge_20260522_rollup.py +10 -0
  322. trueppm_api/apps/projects/migrations/0044_project_archive_program_close.py +119 -0
  323. trueppm_api/apps/projects/migrations/0045_program_risk_policy.py +78 -0
  324. trueppm_api/apps/projects/migrations/0046_merge_20260523_2248.py +12 -0
  325. trueppm_api/apps/projects/migrations/0047_apitokenauditentry_program_and_more.py +55 -0
  326. trueppm_api/apps/projects/migrations/0048_historicalprogram_color_program_color.py +32 -0
  327. trueppm_api/apps/projects/migrations/0049_backlog_item.py +112 -0
  328. trueppm_api/apps/projects/migrations/0050_backlog_item_trgm_search.py +26 -0
  329. trueppm_api/apps/projects/migrations/0051_alter_calendar_working_days_alter_dependency_lag_and_more.py +144 -0
  330. trueppm_api/apps/projects/migrations/0052_recurring_tasks.py +278 -0
  331. trueppm_api/apps/projects/migrations/0053_dependency_dep_pred_serverver_idx_and_more.py +56 -0
  332. trueppm_api/apps/projects/migrations/0054_sprintscopechange_goal_impact_and_more.py +117 -0
  333. trueppm_api/apps/projects/migrations/0055_historicaltask_sprint_pending_and_more.py +51 -0
  334. trueppm_api/apps/projects/migrations/0056_historicalproject_prioritization_model_and_more.py +276 -0
  335. trueppm_api/apps/projects/migrations/0057_historicalsprint_binding_committed_snapshot_and_more.py +58 -0
  336. trueppm_api/apps/projects/migrations/0058_historicaltask_delivery_mode_and_more.py +72 -0
  337. trueppm_api/apps/projects/migrations/0059_forecastsnapshot.py +80 -0
  338. trueppm_api/apps/projects/migrations/0060_historicalprojectsignalprivacypolicy_and_more.py +90 -0
  339. trueppm_api/apps/projects/migrations/0061_baselinetask_story_points.py +17 -0
  340. trueppm_api/apps/projects/migrations/0062_project_is_sample.py +22 -0
  341. trueppm_api/apps/projects/migrations/0063_historicalsprint_wip_limit_sprint_wip_limit.py +22 -0
  342. trueppm_api/apps/projects/migrations/0064_sprinttaskoutcome.py +97 -0
  343. trueppm_api/apps/projects/migrations/0065_historicalsprint_goal_outcome_sprint_goal_outcome.py +32 -0
  344. trueppm_api/apps/projects/migrations/0066_historicalproject_lead_project_lead.py +38 -0
  345. trueppm_api/apps/projects/migrations/0067_sprint_exclude_from_velocity.py +22 -0
  346. trueppm_api/apps/projects/migrations/0068_project_recalculated_at.py +23 -0
  347. trueppm_api/apps/projects/migrations/0069_iteration_label.py +22 -0
  348. trueppm_api/apps/projects/migrations/0070_historicalprogram_iteration_label_and_more.py +32 -0
  349. trueppm_api/apps/projects/migrations/0071_backfill_iteration_label_inherit.py +35 -0
  350. trueppm_api/apps/projects/migrations/0072_pulseresponse_retroboarditem.py +129 -0
  351. trueppm_api/apps/projects/migrations/0073_sprinttaskoutcome_demo_ready.py +17 -0
  352. trueppm_api/apps/projects/migrations/0074_historicaltask_blocked_reason_task_blocked_reason.py +30 -0
  353. trueppm_api/apps/projects/migrations/0075_risk_decimal_short_id.py +42 -0
  354. trueppm_api/apps/projects/migrations/0076_sprinttaskoutcome_review_polish.py +45 -0
  355. trueppm_api/apps/projects/migrations/0077_task_blocker_fields.py +111 -0
  356. trueppm_api/apps/projects/migrations/0078_alter_risktask_unique_together_and_more.py +22 -0
  357. trueppm_api/apps/projects/migrations/0079_historicalproject_status_date_project_status_date.py +22 -0
  358. trueppm_api/apps/projects/migrations/0080_alter_historicaltask_type_alter_task_type.py +46 -0
  359. trueppm_api/apps/projects/migrations/0081_historicalprogram_allow_guests_and_more.py +52 -0
  360. trueppm_api/apps/projects/migrations/0082_project_last_sync_version.py +90 -0
  361. trueppm_api/apps/projects/migrations/0083_historicalprogram_mc_history_attribution_audience_and_more.py +108 -0
  362. trueppm_api/apps/projects/migrations/0084_tasknote.py +71 -0
  363. trueppm_api/apps/projects/migrations/0085_sprint_ix_sprint_velocity.py +33 -0
  364. trueppm_api/apps/projects/migrations/0086_board_card_search_trgm.py +33 -0
  365. trueppm_api/apps/projects/migrations/0087_historicalprogram_task_duration_change_percent_policy_and_more.py +155 -0
  366. trueppm_api/apps/projects/migrations/0088_historicalprogram_allowed_attachment_types_and_more.py +61 -0
  367. trueppm_api/apps/projects/migrations/0089_signalceilingraiseproposal_signalceilingraisevote_and_more.py +157 -0
  368. trueppm_api/apps/projects/migrations/0090_historicaltask_proj_histdate_index.py +44 -0
  369. trueppm_api/apps/projects/migrations/0091_project_board_cadence.py +39 -0
  370. trueppm_api/apps/projects/migrations/0092_program_target_date.py +22 -0
  371. trueppm_api/apps/projects/migrations/0093_cross_project_dependency_consent.py +58 -0
  372. trueppm_api/apps/projects/migrations/0094_project_decisions_policy.py +90 -0
  373. trueppm_api/apps/projects/migrations/0095_poker_session_vote.py +127 -0
  374. trueppm_api/apps/projects/migrations/0095_squashed_0097_release_0_3.py +225 -0
  375. trueppm_api/apps/projects/migrations/0096_crossprojectslipconflict.py +91 -0
  376. trueppm_api/apps/projects/migrations/0097_backlogitem_backlogitem_tags_gin_and_more.py +32 -0
  377. trueppm_api/apps/projects/migrations/0098_historicalproject_show_baselines_and_more.py +52 -0
  378. trueppm_api/apps/projects/migrations/0099_apitoken_scopes.py +48 -0
  379. trueppm_api/apps/projects/migrations/0100_task_dep_serverver_idx_concurrent.py +61 -0
  380. trueppm_api/apps/projects/migrations/0101_dependency_deleted_at_task_deleted_at.py +22 -0
  381. trueppm_api/apps/projects/migrations/0102_project_deleted_at_project_proj_isdel_deletedat_idx.py +25 -0
  382. trueppm_api/apps/projects/migrations/0103_taskdurationchangeevent_task_dur_evt_sprint_idx.py +18 -0
  383. trueppm_api/apps/projects/migrations/0104_historicalproject_stale_task_threshold_days_and_more.py +32 -0
  384. trueppm_api/apps/projects/migrations/0104_trash_restore_1113.py +38 -0
  385. trueppm_api/apps/projects/migrations/0105_historical_changelog_indexes.py +62 -0
  386. trueppm_api/apps/projects/migrations/0106_boardsavedview_schema_version.py +20 -0
  387. trueppm_api/apps/projects/migrations/0107_task_activity_event.py +70 -0
  388. trueppm_api/apps/projects/migrations/0108_remove_apitoken_api_token_scope_xor_and_more.py +117 -0
  389. trueppm_api/apps/projects/migrations/0109_projectexportjob.py +82 -0
  390. trueppm_api/apps/projects/migrations/0110_sharelink.py +123 -0
  391. trueppm_api/apps/projects/migrations/0111_projectcalendarlayer.py +67 -0
  392. trueppm_api/apps/projects/migrations/0112_sharelink_expires_at_alter_sharelink_content_kind.py +31 -0
  393. trueppm_api/apps/projects/migrations/0113_alter_historicaltask_percent_complete_and_more.py +35 -0
  394. trueppm_api/apps/projects/migrations/0114_historicalproject_default_member_role_and_more.py +28 -0
  395. trueppm_api/apps/projects/migrations/0115_historicalproject_end_date_shift_threshold_days_and_more.py +22 -0
  396. trueppm_api/apps/projects/migrations/0116_alter_taskactivityevent_event_type.py +28 -0
  397. trueppm_api/apps/projects/migrations/0117_label_tasklabel_label_tasks_and_more.py +126 -0
  398. trueppm_api/apps/projects/migrations/0118_programexportjob.py +82 -0
  399. trueppm_api/apps/projects/migrations/0119_historicalprogram_calendar_program_calendar.py +36 -0
  400. trueppm_api/apps/projects/migrations/0120_alter_backlogitem_item_type.py +29 -0
  401. trueppm_api/apps/projects/migrations/0121_task_three_point_estimate_ordered.py +64 -0
  402. trueppm_api/apps/projects/migrations/0122_task_relation.py +173 -0
  403. trueppm_api/apps/projects/migrations/0123_remove_historicalproject_agile_features_and_more.py +20 -0
  404. trueppm_api/apps/projects/migrations/0124_dependency_is_driving.py +17 -0
  405. trueppm_api/apps/projects/migrations/0125_historicalprogram_estimation_scale_and_more.py +68 -0
  406. trueppm_api/apps/projects/migrations/0126_projectcustomfield_show_on_card_taskcustomfieldvalue.py +80 -0
  407. trueppm_api/apps/projects/migrations/0127_historicalprogram_mcp_enabled_and_more.py +32 -0
  408. trueppm_api/apps/projects/migrations/0128_acceptancecriterion_sync_seq_apitoken_sync_seq_and_more.py +192 -0
  409. trueppm_api/apps/projects/migrations/0129_sharelink_show_milestone_dates.py +20 -0
  410. trueppm_api/apps/projects/migrations/0130_programimportjob.py +85 -0
  411. trueppm_api/apps/projects/migrations/0131_historicalprogram_sprint_picker_ready_only_default_and_more.py +32 -0
  412. trueppm_api/apps/projects/migrations/0132_task_scheduled_start.py +17 -0
  413. trueppm_api/apps/projects/migrations/0133_project_status_date_floor_armed_at.py +17 -0
  414. trueppm_api/apps/projects/migrations/0134_task_edited_at_task_seeded_at_task_source_id_and_more.py +65 -0
  415. trueppm_api/apps/projects/migrations/0135_projecttemplate_templateapplication_and_more.py +175 -0
  416. trueppm_api/apps/projects/migrations/0136_schedule_outline_batch_operations.py +118 -0
  417. trueppm_api/apps/projects/migrations/0137_collapse_dual_scope_api_tokens.py +54 -0
  418. trueppm_api/apps/projects/migrations/0138_apitokenauditentry_api_token_audit_owner_idx.py +18 -0
  419. trueppm_api/apps/projects/migrations/0139_historicaltask_duration_unit_task_duration_unit.py +32 -0
  420. trueppm_api/apps/projects/migrations/0140_historicaltask_auto_container_and_more.py +113 -0
  421. trueppm_api/apps/projects/migrations/0141_historicalproject_draft_started_at_and_more.py +44 -0
  422. trueppm_api/apps/projects/migrations/0142_baseline_calendar_hours_per_day_and_more.py +31 -0
  423. trueppm_api/apps/projects/migrations/0143_sprintcloserequest_failure_reason_and_more.py +42 -0
  424. trueppm_api/apps/projects/migrations/0144_projecttemplate_source_project_and_more.py +35 -0
  425. trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py +65 -0
  426. trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py +32 -0
  427. trueppm_api/apps/projects/migrations/0147_structuraloperation.py +128 -0
  428. trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py +76 -0
  429. trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py +42 -0
  430. trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py +130 -0
  431. trueppm_api/apps/projects/migrations/0151_config_notice_request.py +70 -0
  432. trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py +20 -0
  433. trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py +22 -0
  434. trueppm_api/apps/projects/migrations/__init__.py +0 -0
  435. trueppm_api/apps/projects/models.py +8946 -0
  436. trueppm_api/apps/projects/poker_services.py +154 -0
  437. trueppm_api/apps/projects/poker_views.py +398 -0
  438. trueppm_api/apps/projects/product_backlog_services.py +450 -0
  439. trueppm_api/apps/projects/program_label_services.py +94 -0
  440. trueppm_api/apps/projects/program_label_views.py +189 -0
  441. trueppm_api/apps/projects/program_rollup.py +575 -0
  442. trueppm_api/apps/projects/program_schedule.py +745 -0
  443. trueppm_api/apps/projects/program_views.py +3220 -0
  444. trueppm_api/apps/projects/project_templates.py +422 -0
  445. trueppm_api/apps/projects/receivers.py +234 -0
  446. trueppm_api/apps/projects/refusal_codes.py +140 -0
  447. trueppm_api/apps/projects/reorder_services.py +145 -0
  448. trueppm_api/apps/projects/restructure_hooks.py +54 -0
  449. trueppm_api/apps/projects/retro_board_services.py +368 -0
  450. trueppm_api/apps/projects/retro_services.py +285 -0
  451. trueppm_api/apps/projects/risk_import.py +396 -0
  452. trueppm_api/apps/projects/row_identity.py +113 -0
  453. trueppm_api/apps/projects/schema_migrations.py +228 -0
  454. trueppm_api/apps/projects/schemas/seed_v1.json +493 -0
  455. trueppm_api/apps/projects/schemas/seed_v2.json +892 -0
  456. trueppm_api/apps/projects/seed/__init__.py +61 -0
  457. trueppm_api/apps/projects/seed/exporter.py +1644 -0
  458. trueppm_api/apps/projects/seed/forecast_backfill.py +247 -0
  459. trueppm_api/apps/projects/seed/importer.py +2390 -0
  460. trueppm_api/apps/projects/seed/reanchor.py +551 -0
  461. trueppm_api/apps/projects/seed/reldates.py +126 -0
  462. trueppm_api/apps/projects/seed/replace.py +126 -0
  463. trueppm_api/apps/projects/seed/replay.py +1691 -0
  464. trueppm_api/apps/projects/seed/replay_ctx.py +41 -0
  465. trueppm_api/apps/projects/seed/samples.py +427 -0
  466. trueppm_api/apps/projects/seed/validation.py +1149 -0
  467. trueppm_api/apps/projects/serializers.py +12310 -0
  468. trueppm_api/apps/projects/services.py +6966 -0
  469. trueppm_api/apps/projects/share_serializers.py +132 -0
  470. trueppm_api/apps/projects/share_services.py +325 -0
  471. trueppm_api/apps/projects/share_views.py +374 -0
  472. trueppm_api/apps/projects/sharing_settings.py +187 -0
  473. trueppm_api/apps/projects/signal_privacy_services.py +909 -0
  474. trueppm_api/apps/projects/signal_privacy_views.py +476 -0
  475. trueppm_api/apps/projects/signals.py +132 -0
  476. trueppm_api/apps/projects/slip_conflict.py +266 -0
  477. trueppm_api/apps/projects/sprint_cadence.py +453 -0
  478. trueppm_api/apps/projects/sprint_picker_settings.py +132 -0
  479. trueppm_api/apps/projects/standup.py +304 -0
  480. trueppm_api/apps/projects/standup_views.py +99 -0
  481. trueppm_api/apps/projects/structural_operation_services.py +727 -0
  482. trueppm_api/apps/projects/structural_operation_views.py +311 -0
  483. trueppm_api/apps/projects/surface_visibility.py +126 -0
  484. trueppm_api/apps/projects/task_batch_services.py +379 -0
  485. trueppm_api/apps/projects/task_bulk.py +1152 -0
  486. trueppm_api/apps/projects/task_classification.py +561 -0
  487. trueppm_api/apps/projects/task_classification_defaults.py +95 -0
  488. trueppm_api/apps/projects/task_duration_settings.py +142 -0
  489. trueppm_api/apps/projects/task_grouping.py +754 -0
  490. trueppm_api/apps/projects/tasks.py +1917 -0
  491. trueppm_api/apps/projects/template_divergence.py +168 -0
  492. trueppm_api/apps/projects/template_services.py +160 -0
  493. trueppm_api/apps/projects/template_tasks.py +258 -0
  494. trueppm_api/apps/projects/template_views.py +799 -0
  495. trueppm_api/apps/projects/throttles.py +311 -0
  496. trueppm_api/apps/projects/urls.py +1011 -0
  497. trueppm_api/apps/projects/utilization.py +885 -0
  498. trueppm_api/apps/projects/views.py +20572 -0
  499. trueppm_api/apps/projects/wbs_paths.py +119 -0
  500. trueppm_api/apps/resources/__init__.py +0 -0
  501. trueppm_api/apps/resources/apps.py +8 -0
  502. trueppm_api/apps/resources/capacity.py +121 -0
  503. trueppm_api/apps/resources/migrations/0001_initial.py +68 -0
  504. trueppm_api/apps/resources/migrations/0001_squashed_0013_alter_projectresource_unique_together_and_more.py +281 -0
  505. trueppm_api/apps/resources/migrations/0002_alter_uuid_pk_serialize_false.py +36 -0
  506. trueppm_api/apps/resources/migrations/0003_resource_soft_delete.py +30 -0
  507. trueppm_api/apps/resources/migrations/0004_add_taskresource_resource_index.py +25 -0
  508. trueppm_api/apps/resources/migrations/0005_resource_job_role.py +20 -0
  509. trueppm_api/apps/resources/migrations/0006_skill.py +34 -0
  510. trueppm_api/apps/resources/migrations/0007_resource_skill.py +63 -0
  511. trueppm_api/apps/resources/migrations/0008_project_resource.py +63 -0
  512. trueppm_api/apps/resources/migrations/0009_task_skill_requirement.py +60 -0
  513. trueppm_api/apps/resources/migrations/0010_alter_resourceskill_options_and_more.py +20 -0
  514. trueppm_api/apps/resources/migrations/0011_alter_projectresource_notes.py +17 -0
  515. trueppm_api/apps/resources/migrations/0012_add_resource_user_fk.py +26 -0
  516. trueppm_api/apps/resources/migrations/0013_alter_projectresource_unique_together_and_more.py +53 -0
  517. trueppm_api/apps/resources/migrations/0014_projectresource_sync_seq_resource_sync_seq_and_more.py +37 -0
  518. trueppm_api/apps/resources/migrations/0015_projectresource_deactivated_with_resource.py +17 -0
  519. trueppm_api/apps/resources/migrations/__init__.py +0 -0
  520. trueppm_api/apps/resources/models.py +298 -0
  521. trueppm_api/apps/resources/serializers.py +426 -0
  522. trueppm_api/apps/resources/services.py +465 -0
  523. trueppm_api/apps/resources/urls.py +28 -0
  524. trueppm_api/apps/resources/views.py +1749 -0
  525. trueppm_api/apps/scheduling/__init__.py +0 -0
  526. trueppm_api/apps/scheduling/apps.py +153 -0
  527. trueppm_api/apps/scheduling/calendars.py +119 -0
  528. trueppm_api/apps/scheduling/deadletter.py +91 -0
  529. trueppm_api/apps/scheduling/forecast_history_settings.py +215 -0
  530. trueppm_api/apps/scheduling/forecast_staleness.py +313 -0
  531. trueppm_api/apps/scheduling/graph_guard.py +263 -0
  532. trueppm_api/apps/scheduling/management/__init__.py +0 -0
  533. trueppm_api/apps/scheduling/management/commands/__init__.py +0 -0
  534. trueppm_api/apps/scheduling/management/commands/prune_forecast_snapshots.py +53 -0
  535. trueppm_api/apps/scheduling/migrations/0001_failed_task.py +62 -0
  536. trueppm_api/apps/scheduling/migrations/0001_squashed_0007_projectforecastsnapshot.py +309 -0
  537. trueppm_api/apps/scheduling/migrations/0002_schedulerequest.py +78 -0
  538. trueppm_api/apps/scheduling/migrations/0003_add_schedule_request_reason.py +27 -0
  539. trueppm_api/apps/scheduling/migrations/0004_velocity_suggestion.py +94 -0
  540. trueppm_api/apps/scheduling/migrations/0005_montecarlorun.py +61 -0
  541. trueppm_api/apps/scheduling/migrations/0006_montecarlorun_distribution.py +17 -0
  542. trueppm_api/apps/scheduling/migrations/0007_projectforecastsnapshot.py +65 -0
  543. trueppm_api/apps/scheduling/migrations/0008_alter_schedulerequest_reason.py +28 -0
  544. trueppm_api/apps/scheduling/migrations/0008_folded_schedulerequest_reason.py +34 -0
  545. trueppm_api/apps/scheduling/migrations/0009_alter_schedulerequest_reason.py +29 -0
  546. trueppm_api/apps/scheduling/migrations/0010_failedtask_resolution_note_failedtask_resolved_at_and_more.py +43 -0
  547. trueppm_api/apps/scheduling/migrations/0011_failedtask_project.py +26 -0
  548. trueppm_api/apps/scheduling/migrations/0012_montecarlorun_diagnostic.py +17 -0
  549. trueppm_api/apps/scheduling/migrations/0013_montecarlorun_status_date.py +17 -0
  550. trueppm_api/apps/scheduling/migrations/0014_montecarlorun_plan_version.py +17 -0
  551. trueppm_api/apps/scheduling/migrations/__init__.py +0 -0
  552. trueppm_api/apps/scheduling/models.py +516 -0
  553. trueppm_api/apps/scheduling/receivers.py +160 -0
  554. trueppm_api/apps/scheduling/risk_premium.py +283 -0
  555. trueppm_api/apps/scheduling/serializers.py +564 -0
  556. trueppm_api/apps/scheduling/services.py +1182 -0
  557. trueppm_api/apps/scheduling/signals.py +56 -0
  558. trueppm_api/apps/scheduling/tasks.py +1984 -0
  559. trueppm_api/apps/scheduling/telemetry.py +80 -0
  560. trueppm_api/apps/scheduling/units.py +35 -0
  561. trueppm_api/apps/scheduling/urls.py +57 -0
  562. trueppm_api/apps/scheduling/views.py +2564 -0
  563. trueppm_api/apps/sso/__init__.py +0 -0
  564. trueppm_api/apps/sso/apps.py +19 -0
  565. trueppm_api/apps/sso/extensions.py +130 -0
  566. trueppm_api/apps/sso/management/__init__.py +0 -0
  567. trueppm_api/apps/sso/management/commands/__init__.py +0 -0
  568. trueppm_api/apps/sso/management/commands/seed_sso_keycloak.py +172 -0
  569. trueppm_api/apps/sso/migrations/0001_initial.py +119 -0
  570. trueppm_api/apps/sso/migrations/0002_remove_oidcprovider_workspace_ssoproviderpolicy_and_more.py +169 -0
  571. trueppm_api/apps/sso/migrations/__init__.py +0 -0
  572. trueppm_api/apps/sso/models.py +148 -0
  573. trueppm_api/apps/sso/serializers.py +437 -0
  574. trueppm_api/apps/sso/services.py +1385 -0
  575. trueppm_api/apps/sso/urls.py +47 -0
  576. trueppm_api/apps/sso/views.py +935 -0
  577. trueppm_api/apps/sync/__init__.py +0 -0
  578. trueppm_api/apps/sync/apps.py +15 -0
  579. trueppm_api/apps/sync/backfill.py +208 -0
  580. trueppm_api/apps/sync/broadcast.py +320 -0
  581. trueppm_api/apps/sync/conflict.py +262 -0
  582. trueppm_api/apps/sync/consumers.py +471 -0
  583. trueppm_api/apps/sync/migrations/0001_initial.py +59 -0
  584. trueppm_api/apps/sync/migrations/0001_squashed_0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +77 -0
  585. trueppm_api/apps/sync/migrations/0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +41 -0
  586. trueppm_api/apps/sync/migrations/0003_boardevent.py +46 -0
  587. trueppm_api/apps/sync/migrations/0004_seed_sync_seq.py +24 -0
  588. trueppm_api/apps/sync/migrations/0005_program_sync_sequence.py +35 -0
  589. trueppm_api/apps/sync/migrations/__init__.py +0 -0
  590. trueppm_api/apps/sync/models.py +225 -0
  591. trueppm_api/apps/sync/pagination.py +231 -0
  592. trueppm_api/apps/sync/sequence.py +371 -0
  593. trueppm_api/apps/sync/serializers.py +687 -0
  594. trueppm_api/apps/sync/tasks.py +260 -0
  595. trueppm_api/apps/sync/throttles.py +175 -0
  596. trueppm_api/apps/sync/upload.py +501 -0
  597. trueppm_api/apps/sync/urls.py +17 -0
  598. trueppm_api/apps/sync/views.py +930 -0
  599. trueppm_api/apps/sync/ws_auth.py +193 -0
  600. trueppm_api/apps/taskruns/__init__.py +0 -0
  601. trueppm_api/apps/taskruns/apps.py +11 -0
  602. trueppm_api/apps/taskruns/migrations/0001_initial.py +92 -0
  603. trueppm_api/apps/taskruns/migrations/__init__.py +0 -0
  604. trueppm_api/apps/taskruns/models.py +68 -0
  605. trueppm_api/apps/taskruns/serializers.py +92 -0
  606. trueppm_api/apps/taskruns/tasks.py +60 -0
  607. trueppm_api/apps/taskruns/tracker.py +286 -0
  608. trueppm_api/apps/taskruns/urls.py +46 -0
  609. trueppm_api/apps/taskruns/views.py +195 -0
  610. trueppm_api/apps/teams/__init__.py +8 -0
  611. trueppm_api/apps/teams/apps.py +16 -0
  612. trueppm_api/apps/teams/migrations/0001_initial.py +139 -0
  613. trueppm_api/apps/teams/migrations/0001_squashed_0002_default_teams.py +142 -0
  614. trueppm_api/apps/teams/migrations/0002_default_teams.py +62 -0
  615. trueppm_api/apps/teams/migrations/0003_team_sync_seq_teammembership_sync_seq.py +22 -0
  616. trueppm_api/apps/teams/migrations/__init__.py +0 -0
  617. trueppm_api/apps/teams/models.py +145 -0
  618. trueppm_api/apps/teams/permissions.py +149 -0
  619. trueppm_api/apps/teams/serializers.py +95 -0
  620. trueppm_api/apps/teams/services.py +434 -0
  621. trueppm_api/apps/teams/signals.py +61 -0
  622. trueppm_api/apps/teams/urls.py +34 -0
  623. trueppm_api/apps/teams/views.py +201 -0
  624. trueppm_api/apps/timetracking/__init__.py +0 -0
  625. trueppm_api/apps/timetracking/apps.py +9 -0
  626. trueppm_api/apps/timetracking/migrations/0001_initial.py +117 -0
  627. trueppm_api/apps/timetracking/migrations/0002_timesheetsubmission.py +46 -0
  628. trueppm_api/apps/timetracking/migrations/0003_timeentry_deleted_at_timeentry_deleted_by.py +31 -0
  629. trueppm_api/apps/timetracking/migrations/0004_timeentry_sync_seq_and_more.py +24 -0
  630. trueppm_api/apps/timetracking/migrations/__init__.py +0 -0
  631. trueppm_api/apps/timetracking/models.py +178 -0
  632. trueppm_api/apps/timetracking/serializers.py +175 -0
  633. trueppm_api/apps/timetracking/services.py +117 -0
  634. trueppm_api/apps/timetracking/urls.py +47 -0
  635. trueppm_api/apps/timetracking/views.py +526 -0
  636. trueppm_api/apps/webhooks/__init__.py +0 -0
  637. trueppm_api/apps/webhooks/apps.py +8 -0
  638. trueppm_api/apps/webhooks/backfill.py +90 -0
  639. trueppm_api/apps/webhooks/dispatch.py +144 -0
  640. trueppm_api/apps/webhooks/migrations/0001_initial.py +146 -0
  641. trueppm_api/apps/webhooks/migrations/0001_squashed_0007_sprint_lifecycle_events.py +243 -0
  642. trueppm_api/apps/webhooks/migrations/0002_alter_webhook_events.py +32 -0
  643. trueppm_api/apps/webhooks/migrations/0003_delivery_status_created_idx.py +17 -0
  644. trueppm_api/apps/webhooks/migrations/0004_webhook_program_alter_webhook_project_and_more.py +64 -0
  645. trueppm_api/apps/webhooks/migrations/0005_webhook_delivery_sequence_numbers.py +30 -0
  646. trueppm_api/apps/webhooks/migrations/0006_webhook_format_alter_webhook_events_and_more.py +61 -0
  647. trueppm_api/apps/webhooks/migrations/0007_sprint_lifecycle_events.py +63 -0
  648. trueppm_api/apps/webhooks/migrations/0008_risk_baseline_comment_events.py +73 -0
  649. trueppm_api/apps/webhooks/migrations/0009_encrypt_webhook_secret_and_failure_counters.py +90 -0
  650. trueppm_api/apps/webhooks/migrations/__init__.py +0 -0
  651. trueppm_api/apps/webhooks/models.py +372 -0
  652. trueppm_api/apps/webhooks/serializers.py +318 -0
  653. trueppm_api/apps/webhooks/tasks.py +663 -0
  654. trueppm_api/apps/webhooks/urls.py +22 -0
  655. trueppm_api/apps/webhooks/views.py +383 -0
  656. trueppm_api/apps/workflow_engine/__init__.py +0 -0
  657. trueppm_api/apps/workflow_engine/apps.py +23 -0
  658. trueppm_api/apps/workflow_engine/migrations/0001_initial.py +230 -0
  659. trueppm_api/apps/workflow_engine/migrations/0001_squashed_0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +234 -0
  660. trueppm_api/apps/workflow_engine/migrations/0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +16 -0
  661. trueppm_api/apps/workflow_engine/migrations/0003_workflowoutboxrow_workflow_outbox_recovery_idx.py +21 -0
  662. trueppm_api/apps/workflow_engine/migrations/__init__.py +0 -0
  663. trueppm_api/apps/workflow_engine/models.py +265 -0
  664. trueppm_api/apps/workflow_engine/tasks.py +368 -0
  665. trueppm_api/apps/workspace/__init__.py +0 -0
  666. trueppm_api/apps/workspace/apps.py +10 -0
  667. trueppm_api/apps/workspace/backfill.py +111 -0
  668. trueppm_api/apps/workspace/export.py +242 -0
  669. trueppm_api/apps/workspace/migrations/0001_initial.py +326 -0
  670. trueppm_api/apps/workspace/migrations/0001_squashed_0014_workspacemembership_availability_effective_from_and_more.py +829 -0
  671. trueppm_api/apps/workspace/migrations/0002_remove_workspace_fiscal_year_start_and_more.py +85 -0
  672. trueppm_api/apps/workspace/migrations/0003_workspaceexportjob.py +73 -0
  673. trueppm_api/apps/workspace/migrations/0004_alter_workspaceinvite_status.py +27 -0
  674. trueppm_api/apps/workspace/migrations/0005_workspace_iteration_label_and_more.py +26 -0
  675. trueppm_api/apps/workspace/migrations/0006_alter_groupmembership_unique_together_and_more.py +45 -0
  676. trueppm_api/apps/workspace/migrations/0007_workspace_public_sharing_override_policy.py +21 -0
  677. trueppm_api/apps/workspace/migrations/0008_workspace_mc_history_attribution_audience_and_more.py +44 -0
  678. trueppm_api/apps/workspace/migrations/0009_workspace_methodology_and_more.py +186 -0
  679. trueppm_api/apps/workspace/migrations/0010_workspace_logo.py +38 -0
  680. trueppm_api/apps/workspace/migrations/0011_historicalworkspace_task_duration_change_percent_override_policy_and_more.py +56 -0
  681. trueppm_api/apps/workspace/migrations/0012_historicalworkspace_allowed_attachment_types_and_more.py +64 -0
  682. trueppm_api/apps/workspace/migrations/0013_auditevent.py +70 -0
  683. trueppm_api/apps/workspace/migrations/0014_workspacemembership_availability_effective_from_and_more.py +39 -0
  684. trueppm_api/apps/workspace/migrations/0015_trash_restore_1113.py +34 -0
  685. trueppm_api/apps/workspace/migrations/0016_historicalworkspace_calendar_and_more.py +55 -0
  686. trueppm_api/apps/workspace/migrations/0017_historicalworkspace_estimation_scale_and_more.py +38 -0
  687. trueppm_api/apps/workspace/migrations/0018_historicalworkspace_feedback_enabled_and_more.py +32 -0
  688. trueppm_api/apps/workspace/migrations/0019_historicalworkspace_mcp_enabled_and_more.py +22 -0
  689. trueppm_api/apps/workspace/migrations/0020_viewer_ordinal_one.py +34 -0
  690. trueppm_api/apps/workspace/migrations/0021_group_sync_seq_groupmembership_sync_seq_and_more.py +27 -0
  691. trueppm_api/apps/workspace/migrations/0022_historicalworkspace_sprint_picker_ready_only_default_and_more.py +22 -0
  692. trueppm_api/apps/workspace/migrations/0023_alter_auditevent_event_type.py +32 -0
  693. trueppm_api/apps/workspace/migrations/0024_alter_auditevent_event_type.py +33 -0
  694. trueppm_api/apps/workspace/migrations/0025_alter_auditevent_event_type.py +36 -0
  695. trueppm_api/apps/workspace/migrations/0026_alter_auditevent_event_type.py +37 -0
  696. trueppm_api/apps/workspace/migrations/0027_alter_auditevent_event_type.py +42 -0
  697. trueppm_api/apps/workspace/migrations/__init__.py +0 -0
  698. trueppm_api/apps/workspace/models.py +857 -0
  699. trueppm_api/apps/workspace/permissions.py +187 -0
  700. trueppm_api/apps/workspace/serializers.py +590 -0
  701. trueppm_api/apps/workspace/services.py +919 -0
  702. trueppm_api/apps/workspace/signals.py +37 -0
  703. trueppm_api/apps/workspace/tasks.py +555 -0
  704. trueppm_api/apps/workspace/urls.py +113 -0
  705. trueppm_api/apps/workspace/views.py +1502 -0
  706. trueppm_api/asgi.py +42 -0
  707. trueppm_api/celery.py +31 -0
  708. trueppm_api/core/__init__.py +0 -0
  709. trueppm_api/core/admin_site.py +206 -0
  710. trueppm_api/core/auth_views.py +916 -0
  711. trueppm_api/core/constant_time.py +51 -0
  712. trueppm_api/core/csp.py +54 -0
  713. trueppm_api/core/db.py +87 -0
  714. trueppm_api/core/db_session.py +37 -0
  715. trueppm_api/core/exception_handlers.py +157 -0
  716. trueppm_api/core/export_downloads.py +56 -0
  717. trueppm_api/core/extension_providers.py +56 -0
  718. trueppm_api/core/extension_signals.py +147 -0
  719. trueppm_api/core/idempotent.py +260 -0
  720. trueppm_api/core/metadata.py +42 -0
  721. trueppm_api/core/middleware.py +51 -0
  722. trueppm_api/core/openapi.py +949 -0
  723. trueppm_api/core/password_reset.py +500 -0
  724. trueppm_api/core/protect_conflict.py +100 -0
  725. trueppm_api/core/ratelimit.py +148 -0
  726. trueppm_api/core/redis_throttle.py +82 -0
  727. trueppm_api/core/refresh_cookie_policy.py +156 -0
  728. trueppm_api/core/request_body.py +86 -0
  729. trueppm_api/core/security_checks.py +884 -0
  730. trueppm_api/core/storage_config.py +105 -0
  731. trueppm_api/core/text_decode.py +168 -0
  732. trueppm_api/core/throttling.py +344 -0
  733. trueppm_api/core/valkey.py +214 -0
  734. trueppm_api/core/valkey_cache.py +66 -0
  735. trueppm_api/core/valkey_checks.py +104 -0
  736. trueppm_api/core/valkey_config.py +39 -0
  737. trueppm_api/core/worker_broker_wait.py +149 -0
  738. trueppm_api/core/worker_heartbeat.py +134 -0
  739. trueppm_api/fields.py +36 -0
  740. trueppm_api/permissions.py +30 -0
  741. trueppm_api/py.typed +0 -0
  742. trueppm_api/routing.py +11 -0
  743. trueppm_api/settings/__init__.py +0 -0
  744. trueppm_api/settings/base.py +2455 -0
  745. trueppm_api/settings/dev.py +273 -0
  746. trueppm_api/settings/prod.py +228 -0
  747. trueppm_api/urls.py +153 -0
  748. trueppm_api/workflows/__init__.py +38 -0
  749. trueppm_api/workflows/backends/__init__.py +6 -0
  750. trueppm_api/workflows/backends/default.py +297 -0
  751. trueppm_api/workflows/consumers/__init__.py +11 -0
  752. trueppm_api/workflows/consumers/requeue_failed_task.py +65 -0
  753. trueppm_api/workflows/interface.py +148 -0
  754. trueppm_api/workflows/registry.py +106 -0
  755. trueppm_api/workflows/services.py +90 -0
  756. trueppm_api/wsgi.py +11 -0
  757. trueppm_api-0.4.0b2.dist-info/METADATA +70 -0
  758. trueppm_api-0.4.0b2.dist-info/RECORD +759 -0
  759. trueppm_api-0.4.0b2.dist-info/WHEEL +4 -0
@@ -0,0 +1,1385 @@
1
+ """Multi-provider SSO service layer (ADR-0517 §3.2, supersedes ADR-0187 §2).
2
+
3
+ Pure functions for the Authorization Code + PKCE (OIDC) and Authorization Code
4
+ (GitHub OAuth2) flows, kept out of the views so the security-critical logic
5
+ (state/PKCE/nonce, token exchange, ID-token validation, GitHub userinfo, identity
6
+ resolution, membership creation) is testable in isolation.
7
+
8
+ ADR-0517 adopts ``allauth.socialaccount`` as the provider **registry** — the
9
+ per-provider endpoint/claim knowledge — but **not** its network layer. Every
10
+ outbound call (OIDC discovery / token / JWKS, GitHub ``/user`` + ``/user/emails``
11
+ + org membership) still routes through the shared SSRF egress chokepoint
12
+ (``apps/integrations/http``). allauth is used only for endpoint constants and
13
+ claim shape; **it never opens a socket** (control 1). We keep our own
14
+ ``validate_id_token`` (alg allow-list + nonce, JWKS via egress) rather than
15
+ delegating to allauth's verification, which would fetch JWKS off-egress and not
16
+ enforce our alg allow-list (control 4).
17
+
18
+ Config lives in allauth's ``SocialApp`` (``provider``, ``provider_id``,
19
+ ``client_id``, ``settings.server_url``) + our :class:`SsoProviderPolicy` side row
20
+ (the Fernet-encrypted client secret + policy fields); per-user bindings live in
21
+ allauth's ``SocialAccount``. The only ephemeral state (``state`` → provider slug +
22
+ PKCE verifier + nonce + the exact redirect_uri) lives in the Django cache (Valkey
23
+ in prod) with a short TTL and is **single-use** (deleted on read).
24
+ """
25
+
26
+ from __future__ import annotations
27
+
28
+ import base64
29
+ import hashlib
30
+ import logging
31
+ import secrets
32
+ from dataclasses import dataclass
33
+ from typing import Any
34
+ from urllib.parse import urlencode
35
+
36
+ import jwt
37
+ from allauth.socialaccount.models import SocialApp
38
+ from django.conf import settings
39
+ from django.contrib.auth import get_user_model
40
+ from django.core.cache import cache
41
+ from django.core.mail import EmailMultiAlternatives
42
+ from django.db import transaction
43
+ from django.utils import timezone
44
+ from django.utils.html import escape
45
+ from jwt import PyJWK, PyJWKSet
46
+ from jwt.exceptions import PyJWKError, PyJWKSetError
47
+
48
+ from trueppm_api.apps.integrations import http as egress
49
+ from trueppm_api.apps.sso.extensions import oidc_role_for
50
+ from trueppm_api.apps.sso.models import SsoProviderPolicy
51
+ from trueppm_api.apps.workspace.models import MemberStatus, WorkspaceMembership
52
+
53
+ logger = logging.getLogger("trueppm.sso")
54
+
55
+ User = get_user_model()
56
+
57
+ # The two allauth provider modules we enable (ADR-0517 §1). Every OIDC IdP maps to
58
+ # ``openid_connect``; GitHub is the one non-OIDC OAuth2 IdP.
59
+ ALLAUTH_OPENID_CONNECT = "openid_connect"
60
+ ALLAUTH_GITHUB = "github"
61
+
62
+
63
+ @dataclass(frozen=True)
64
+ class RegistryEntry:
65
+ """A fixed, server-defined SSO provider type (ADR-0517 §2).
66
+
67
+ ``slug`` is the admin-facing registry id **and** the openid_connect
68
+ ``provider_id`` / SocialAccount ``provider`` key. ``allauth_provider`` selects
69
+ the flow branch (OIDC vs GitHub OAuth2). ``kind`` is display metadata for the
70
+ admin picker (the FE composes ``server_url`` for the ``derived`` types and the
71
+ server re-validates it as an absolute https URL).
72
+ """
73
+
74
+ slug: str
75
+ display: str
76
+ allauth_provider: str
77
+ kind: str # free | fixed | derived | oauth
78
+
79
+
80
+ # The fixed provider registry (ADR-0517 §2, design handoff table). Every OIDC IdP
81
+ # uses allauth's ``openid_connect`` provider as a named app keyed by our slug; only
82
+ # GitHub uses the dedicated ``github`` OAuth2 module.
83
+ REGISTRY: dict[str, RegistryEntry] = {
84
+ "generic": RegistryEntry("generic", "Generic OIDC", ALLAUTH_OPENID_CONNECT, "free"),
85
+ "google": RegistryEntry("google", "Google", ALLAUTH_OPENID_CONNECT, "fixed"),
86
+ "entra": RegistryEntry("entra", "Microsoft Entra ID", ALLAUTH_OPENID_CONNECT, "derived"),
87
+ "gitlab": RegistryEntry("gitlab", "GitLab", ALLAUTH_OPENID_CONNECT, "derived"),
88
+ "keycloak": RegistryEntry("keycloak", "Keycloak", ALLAUTH_OPENID_CONNECT, "derived"),
89
+ "authentik": RegistryEntry("authentik", "Authentik", ALLAUTH_OPENID_CONNECT, "derived"),
90
+ "zitadel": RegistryEntry("zitadel", "Zitadel", ALLAUTH_OPENID_CONNECT, "derived"),
91
+ "okta": RegistryEntry("okta", "Okta", ALLAUTH_OPENID_CONNECT, "derived"),
92
+ "auth0": RegistryEntry("auth0", "Auth0", ALLAUTH_OPENID_CONNECT, "derived"),
93
+ "github": RegistryEntry("github", "GitHub", ALLAUTH_GITHUB, "oauth"),
94
+ }
95
+
96
+
97
+ def registry_entry(slug: str) -> RegistryEntry | None:
98
+ return REGISTRY.get(slug)
99
+
100
+
101
+ # Server-fixed scopes (ADR-0517 §3.4). The admin cannot widen them; ``groups`` /
102
+ # custom claims are an enterprise widening. Mirrors SOCIALACCOUNT_PROVIDERS.
103
+ OIDC_SCOPES = ["openid", "email", "profile"]
104
+ GITHUB_SCOPES = ["read:user", "user:email"]
105
+
106
+ # GitHub OAuth2 endpoints (ADR-0517 §3.2). Kept as module constants — allauth's
107
+ # github adapter (GitHubOAuth2Adapter) is used only as a reference for these
108
+ # values and the claim shape; the network call is ours, through egress.
109
+ GITHUB_AUTHORIZE_URL = "https://github.com/login/oauth/authorize"
110
+ GITHUB_TOKEN_URL = "https://github.com/login/oauth/access_token"
111
+ GITHUB_USER_URL = "https://api.github.com/user"
112
+ GITHUB_EMAILS_URL = "https://api.github.com/user/emails"
113
+ # The synthetic "issuer" recorded in SocialAccount.extra_data for GitHub bindings
114
+ # (GitHub has no OIDC issuer). Preserves parity with the OIDC ``iss`` disambiguator.
115
+ GITHUB_ISSUER = "https://github.com"
116
+
117
+ # ID-token signature algorithms we accept. Asymmetric only — a symmetric ``HS*``
118
+ # token would be "verified" with the client secret, and ``none`` must never be
119
+ # honored. PyJWT rejects any ``alg`` not in this allow-list (and ``none`` outright
120
+ # when a key is supplied), closing the alg-confusion class.
121
+ _ALLOWED_ID_TOKEN_ALGS = ["RS256", "RS384", "RS512", "ES256", "ES384", "ES512"]
122
+
123
+ # Short, single-use login state. 5 minutes is ample for an interactive IdP
124
+ # round-trip (consent screen included) and bounds how long a leaked ``state`` URL
125
+ # parameter is replayable (it's also deleted on first read).
126
+ _STATE_TTL_SECONDS = getattr(settings, "OIDC_STATE_TTL_SECONDS", 300)
127
+
128
+ # Discovery documents are stable; caching avoids re-fetching the well-known doc
129
+ # on every login (perf) without holding it so long that an issuer reconfiguration
130
+ # is invisible for hours.
131
+ _DISCOVERY_TTL_SECONDS = getattr(settings, "OIDC_DISCOVERY_TTL_SECONDS", 3600)
132
+
133
+ # JWKS documents change only when the IdP rotates keys, so re-fetching one on
134
+ # every single login is pure added latency plus an avoidable outbound request per
135
+ # sign-in. Shorter than the discovery TTL on purpose: the kid-miss refetch in
136
+ # ``_signing_key_for`` already makes a *newly added* key visible immediately, so
137
+ # the only thing the TTL bounds is how long a *withdrawn* key stays trusted — and
138
+ # that window should be minutes, not an hour.
139
+ _JWKS_TTL_SECONDS = getattr(settings, "OIDC_JWKS_TTL_SECONDS", 600)
140
+
141
+ # Clock-skew allowance when validating an ID token's time claims. 60 seconds is
142
+ # the conventional OIDC/JWT allowance (RFC 7519 §4.1.4 explicitly provides for
143
+ # "some small leeway"; the mainstream IdP SDKs default to a minute). With the
144
+ # PyJWT default of 0 an IdP whose clock is even a second ahead of ours issues
145
+ # tokens we reject as not-yet-valid, which surfaces to the user as an
146
+ # undiagnosable login failure on a correctly configured provider. It is held to
147
+ # one minute rather than the several some libraries allow because the same
148
+ # allowance symmetrically extends how long an *expired* token stays acceptable,
149
+ # and an ID token is consumed once, immediately after issuance.
150
+ _ID_TOKEN_LEEWAY_SECONDS = 60
151
+
152
+ _STATE_KEY_PREFIX = "oidc:state:"
153
+ _DISCOVERY_KEY_PREFIX = "oidc:discovery:"
154
+ _JWKS_KEY_PREFIX = "oidc:jwks:"
155
+
156
+ # Accept header for provider metadata / JWKS / token-endpoint fetches.
157
+ _ACCEPT_JSON = "application/json"
158
+
159
+
160
+ class OIDCError(Exception):
161
+ """Base error for the SSO flow, carrying a stable machine code + HTTP status.
162
+
163
+ ``code`` is the non-sensitive identifier surfaced to the SPA (in a redirect
164
+ query param) or returned in a JSON body. It never carries PII or token
165
+ material. (The ``OIDC`` prefix is retained from ADR-0187 for continuity even
166
+ though the hierarchy now also covers GitHub OAuth2.)
167
+ """
168
+
169
+ code = "oidc_error"
170
+ http_status = 400
171
+
172
+ def __init__(
173
+ self, message: str = "", *, code: str | None = None, http_status: int | None = None
174
+ ) -> None:
175
+ super().__init__(message or (code or self.code))
176
+ if code is not None:
177
+ self.code = code
178
+ if http_status is not None:
179
+ self.http_status = http_status
180
+
181
+
182
+ class OIDCNotConfigured(OIDCError):
183
+ code = "sso_not_configured"
184
+ http_status = 400
185
+
186
+
187
+ class OIDCStateError(OIDCError):
188
+ code = "invalid_state"
189
+ http_status = 400
190
+
191
+
192
+ class OIDCTokenExchangeError(OIDCError):
193
+ code = "token_exchange_failed"
194
+ http_status = 400
195
+
196
+
197
+ class OIDCIDTokenError(OIDCError):
198
+ code = "invalid_id_token"
199
+ http_status = 400
200
+
201
+
202
+ class OIDCEmailUnverified(OIDCError):
203
+ code = "email_unverified"
204
+ http_status = 403
205
+
206
+
207
+ class OIDCNoMember(OIDCError):
208
+ code = "sso_no_member"
209
+ http_status = 403
210
+
211
+
212
+ class OIDCAccountDisabled(OIDCError):
213
+ """The identity resolved to a local account that has been deactivated (#2875).
214
+
215
+ Distinct from :class:`OIDCNoMember` because the remedy is different: the user
216
+ *is* a member, their account was switched off. Telling them to ask for an
217
+ invite (the ``sso_no_member`` copy) would send them down a path that cannot
218
+ resolve it.
219
+ """
220
+
221
+ code = "sso_account_disabled"
222
+ http_status = 403
223
+
224
+
225
+ class OIDCProviderUnreachable(OIDCError):
226
+ code = "provider_unreachable"
227
+ http_status = 502
228
+
229
+
230
+ @dataclass(frozen=True)
231
+ class LoginRedirect:
232
+ """The result of starting a login: where to send the browser, and the state key."""
233
+
234
+ authorization_url: str
235
+ state: str
236
+
237
+
238
+ @dataclass(frozen=True)
239
+ class ProviderContext:
240
+ """A resolved, enabled provider: an allauth ``SocialApp`` + its policy side row.
241
+
242
+ Wraps the two rows so the flow reads config uniformly regardless of provider
243
+ type. ``is_github`` selects the OAuth2 (no-OIDC) branch; everything else is an
244
+ OIDC IdP whose ``issuer`` is the ``server_url`` stored on the ``SocialApp``.
245
+ """
246
+
247
+ social_app: SocialApp
248
+ policy: SsoProviderPolicy
249
+
250
+ @property
251
+ def slug(self) -> str:
252
+ return self.policy.slug
253
+
254
+ @property
255
+ def is_github(self) -> bool:
256
+ return bool(self.social_app.provider == ALLAUTH_GITHUB)
257
+
258
+ @property
259
+ def display_name(self) -> str:
260
+ return str(self.social_app.name)
261
+
262
+ @property
263
+ def client_id(self) -> str:
264
+ return str(self.social_app.client_id)
265
+
266
+ def get_client_secret(self) -> str:
267
+ return self.policy.get_client_secret()
268
+
269
+ @property
270
+ def issuer(self) -> str:
271
+ """The OIDC issuer (``server_url``), or the synthetic GitHub issuer."""
272
+ if self.is_github:
273
+ return GITHUB_ISSUER
274
+ return str(self.social_app.settings.get("server_url", ""))
275
+
276
+ @property
277
+ def scopes(self) -> list[str]:
278
+ return GITHUB_SCOPES if self.is_github else OIDC_SCOPES
279
+
280
+
281
+ # ---------------------------------------------------------------------------
282
+ # Provider resolution — fail closed
283
+ # ---------------------------------------------------------------------------
284
+
285
+
286
+ def _is_configured(ctx: ProviderContext) -> bool:
287
+ """Whether a provider is complete enough to attempt a handshake.
288
+
289
+ A half-configured provider (missing client id / secret, or — for OIDC —
290
+ missing issuer) is treated as "not usable" so the flow fails closed rather
291
+ than attempting a broken handshake.
292
+ """
293
+ if not (ctx.client_id and ctx.policy.secret_set):
294
+ return False
295
+ # OIDC needs an issuer; GitHub derives its endpoints from module constants.
296
+ return ctx.is_github or bool(ctx.issuer)
297
+
298
+
299
+ def _context_for_policy(policy: SsoProviderPolicy) -> ProviderContext:
300
+ return ProviderContext(social_app=policy.social_app, policy=policy)
301
+
302
+
303
+ def get_provider_for_slug(slug: str) -> ProviderContext | None:
304
+ """Return the enabled, fully-configured provider for ``slug``, or ``None``.
305
+
306
+ Fails closed: a disabled or half-configured provider yields ``None`` so the
307
+ login/callback flow refuses to proceed.
308
+ """
309
+ policy = (
310
+ SsoProviderPolicy.objects.select_related("social_app")
311
+ .filter(enabled=True, slug=slug)
312
+ .first()
313
+ )
314
+ if policy is None:
315
+ return None
316
+ ctx = _context_for_policy(policy)
317
+ return ctx if _is_configured(ctx) else None
318
+
319
+
320
+ def get_enabled_providers() -> list[ProviderContext]:
321
+ """Return every enabled, fully-configured provider (for the login screen)."""
322
+ contexts = [
323
+ _context_for_policy(policy)
324
+ for policy in SsoProviderPolicy.objects.select_related("social_app").filter(enabled=True)
325
+ ]
326
+ return [ctx for ctx in contexts if _is_configured(ctx)]
327
+
328
+
329
+ def domain_matches_any_enabled(email: str) -> ProviderContext | None:
330
+ """Return the first enabled provider whose domain allow-list admits ``email``.
331
+
332
+ Used by ``discover`` to answer "does this *domain* use SSO?" without leaking
333
+ account existence. ``None`` when no enabled provider admits the domain.
334
+ """
335
+ if "@" not in email:
336
+ return None
337
+ for ctx in get_enabled_providers():
338
+ if _domain_allowed(ctx.policy, email):
339
+ return ctx
340
+ return None
341
+
342
+
343
+ # ---------------------------------------------------------------------------
344
+ # Discovery (OIDC)
345
+ # ---------------------------------------------------------------------------
346
+
347
+
348
+ def _discovery_url(issuer_url: str) -> str:
349
+ return f"{issuer_url.rstrip('/')}/.well-known/openid-configuration"
350
+
351
+
352
+ def get_discovery_document(issuer_url: str) -> dict[str, Any]:
353
+ """Fetch and validate the OIDC discovery document for ``issuer_url``.
354
+
355
+ SSRF-guarded; cached for a short TTL. Validates that the document's ``issuer``
356
+ claim is identical to the configured issuer (OIDC Discovery §4.3 — a mismatch
357
+ is a misconfigured or hostile IdP) and that the endpoints the flow needs are
358
+ present.
359
+
360
+ Raises:
361
+ OIDCProviderUnreachable: discovery could not be fetched.
362
+ OIDCIDTokenError: the document is malformed or the issuer does not match.
363
+ """
364
+ cache_key = _DISCOVERY_KEY_PREFIX + issuer_url
365
+ cached = cache.get(cache_key)
366
+ if isinstance(cached, dict):
367
+ return cached
368
+
369
+ url = _discovery_url(issuer_url)
370
+ try:
371
+ resp = egress.get(url, headers={"Accept": _ACCEPT_JSON})
372
+ except egress.EgressBlocked as exc:
373
+ raise OIDCProviderUnreachable(f"issuer URL blocked by SSRF guard: {exc}") from exc
374
+ except (egress.EgressTimeout, egress.EgressError) as exc:
375
+ raise OIDCProviderUnreachable(f"could not reach issuer discovery: {exc}") from exc
376
+
377
+ if resp.status != 200:
378
+ raise OIDCProviderUnreachable(f"discovery returned HTTP {resp.status}")
379
+
380
+ doc = resp.json()
381
+ if not isinstance(doc, dict):
382
+ raise OIDCIDTokenError("discovery document is not valid JSON")
383
+
384
+ # The issuer in the document MUST match the configured issuer exactly.
385
+ if doc.get("issuer") != issuer_url:
386
+ raise OIDCIDTokenError("discovery issuer does not match configured issuer")
387
+
388
+ for required in ("authorization_endpoint", "token_endpoint", "jwks_uri"):
389
+ if not doc.get(required):
390
+ raise OIDCIDTokenError(f"discovery document missing {required}")
391
+
392
+ cache.set(cache_key, doc, _DISCOVERY_TTL_SECONDS)
393
+ return doc
394
+
395
+
396
+ # ---------------------------------------------------------------------------
397
+ # PKCE + state
398
+ # ---------------------------------------------------------------------------
399
+
400
+
401
+ def _pkce_pair() -> tuple[str, str]:
402
+ """Return ``(code_verifier, code_challenge)`` for PKCE method S256 (RFC 7636)."""
403
+ verifier = secrets.token_urlsafe(64) # 43–128 chars after urlsafe encoding
404
+ digest = hashlib.sha256(verifier.encode("ascii")).digest()
405
+ challenge = base64.urlsafe_b64encode(digest).rstrip(b"=").decode("ascii")
406
+ return verifier, challenge
407
+
408
+
409
+ def start_login(ctx: ProviderContext, *, redirect_uri: str) -> LoginRedirect:
410
+ """Mint single-use login state and build the provider authorization URL.
411
+
412
+ OIDC: mints ``state`` + PKCE verifier + nonce, stores the verifier/nonce/exact
413
+ redirect_uri server-side (never sent to the browser), and binds the nonce to
414
+ the ID token. GitHub: mints ``state`` and stores the redirect_uri (GitHub's
415
+ OAuth2 has no PKCE/nonce). In both cases the provider ``slug`` is stored under
416
+ the state key so the callback knows which ``SocialApp`` is completing without a
417
+ new callback path segment (ADR-0517 §3.5).
418
+ """
419
+ state = secrets.token_urlsafe(32)
420
+
421
+ if ctx.is_github:
422
+ cache.set(
423
+ _STATE_KEY_PREFIX + state,
424
+ {"slug": ctx.slug, "redirect_uri": redirect_uri},
425
+ _STATE_TTL_SECONDS,
426
+ )
427
+ params = {
428
+ "response_type": "code",
429
+ "client_id": ctx.client_id,
430
+ "redirect_uri": redirect_uri,
431
+ "scope": " ".join(ctx.scopes),
432
+ "state": state,
433
+ }
434
+ authorization_url = f"{GITHUB_AUTHORIZE_URL}?{urlencode(params)}"
435
+ return LoginRedirect(authorization_url=authorization_url, state=state)
436
+
437
+ doc = get_discovery_document(ctx.issuer)
438
+ nonce = secrets.token_urlsafe(24)
439
+ verifier, challenge = _pkce_pair()
440
+
441
+ cache.set(
442
+ _STATE_KEY_PREFIX + state,
443
+ {"slug": ctx.slug, "verifier": verifier, "nonce": nonce, "redirect_uri": redirect_uri},
444
+ _STATE_TTL_SECONDS,
445
+ )
446
+
447
+ params = {
448
+ "response_type": "code",
449
+ "client_id": ctx.client_id,
450
+ "redirect_uri": redirect_uri,
451
+ "scope": " ".join(ctx.scopes),
452
+ "state": state,
453
+ "nonce": nonce,
454
+ "code_challenge": challenge,
455
+ "code_challenge_method": "S256",
456
+ }
457
+ authorization_url = f"{doc['authorization_endpoint']}?{urlencode(params)}"
458
+ return LoginRedirect(authorization_url=authorization_url, state=state)
459
+
460
+
461
+ def consume_state(state: str) -> dict[str, Any]:
462
+ """Pop the stored login state (single-use; deleted on read).
463
+
464
+ Returns the stored ``{slug, redirect_uri, ...}``. A missing / expired /
465
+ already-consumed state raises :class:`OIDCStateError` — the callback fails
466
+ closed, which is the CSRF / replay mitigation.
467
+ """
468
+ if not state:
469
+ raise OIDCStateError("missing state")
470
+ key = _STATE_KEY_PREFIX + state
471
+ data = cache.get(key)
472
+ # Delete before doing anything else, so even concurrent callbacks race to a
473
+ # single winner (the small get/delete TOCTOU window is acceptable — the token
474
+ # endpoint also rejects a re-used authorization code).
475
+ cache.delete(key)
476
+ if not isinstance(data, dict):
477
+ raise OIDCStateError("unknown or expired state")
478
+ return data
479
+
480
+
481
+ # ---------------------------------------------------------------------------
482
+ # Token exchange + ID-token validation (OIDC)
483
+ # ---------------------------------------------------------------------------
484
+
485
+
486
+ def exchange_code(
487
+ ctx: ProviderContext, doc: dict[str, Any], *, code: str, redirect_uri: str, verifier: str
488
+ ) -> dict[str, Any]:
489
+ """Exchange the authorization ``code`` + PKCE ``verifier`` for OIDC tokens.
490
+
491
+ Uses ``client_secret_post`` (confidential client) against the discovered
492
+ ``token_endpoint``, SSRF-guarded. The decrypted client secret is read from the
493
+ policy side row at call time and sent only to the IdP — never returned to a
494
+ client or logged.
495
+
496
+ Raises:
497
+ OIDCProviderUnreachable: the token endpoint could not be reached.
498
+ OIDCTokenExchangeError: the IdP returned an OAuth error or no id_token.
499
+ """
500
+ data = {
501
+ "grant_type": "authorization_code",
502
+ "code": code,
503
+ "redirect_uri": redirect_uri,
504
+ "client_id": ctx.client_id,
505
+ "client_secret": ctx.get_client_secret(),
506
+ "code_verifier": verifier,
507
+ }
508
+ try:
509
+ resp = egress.post_form(doc["token_endpoint"], data=data)
510
+ except egress.EgressBlocked as exc:
511
+ raise OIDCProviderUnreachable(f"token endpoint blocked by SSRF guard: {exc}") from exc
512
+ except (egress.EgressTimeout, egress.EgressError) as exc:
513
+ raise OIDCProviderUnreachable(f"could not reach token endpoint: {exc}") from exc
514
+
515
+ payload = resp.json()
516
+ if not isinstance(payload, dict):
517
+ raise OIDCTokenExchangeError("token endpoint returned a non-JSON body")
518
+ if resp.status != 200 or "error" in payload:
519
+ # Surface a stable code to the user; log the IdP's machine-readable error
520
+ # for ops. The logged value is the OAuth2 ``error`` *code* (RFC 6749 §5.2:
521
+ # invalid_grant, invalid_client, …) — a public enumerated value, not a
522
+ # credential — and we deliberately never log ``error_description``.
523
+ # semgrep's `python-logger-credential-disclosure` flags the `error=`
524
+ # token as a possible secret leak; this is a reviewed false positive. The
525
+ # bare `# nosemgrep` (vs the rule-id form) is deliberate: the fully
526
+ # qualified rule id is 92 chars, so an id-scoped directive cannot fit the
527
+ # 100-col limit without tripping E501/RUF100. Scope here is this one line.
528
+ logger.warning( # nosemgrep
529
+ "oidc token exchange failed: status=%s error=%s",
530
+ resp.status,
531
+ payload.get("error"),
532
+ )
533
+ raise OIDCTokenExchangeError("token exchange failed")
534
+ if not payload.get("id_token"):
535
+ raise OIDCTokenExchangeError("token response did not include an id_token")
536
+ return payload
537
+
538
+
539
+ def _fetch_jwks(jwks_uri: str, *, force_refresh: bool = False) -> tuple[dict[str, Any], bool]:
540
+ """Fetch the JWKS through the SSRF-guarded egress, cached. Returns ``(doc, was_cached)``.
541
+
542
+ PyJWT's ``PyJWKClient`` is deliberately **not** used: it fetches the JWKS with
543
+ urllib's default opener, which follows redirects and re-resolves DNS *after*
544
+ any point-in-time host check — a TOCTOU/redirect SSRF bypass of the egress
545
+ chokepoint. Fetching the JWKS ourselves via ``egress.get`` keeps every
546
+ outbound call on the redirect-disabled, allow-listed path (ADR-0187 Boundary 6
547
+ / SSRF).
548
+
549
+ ``was_cached`` is returned rather than kept private because it is what lets
550
+ the caller decide whether a ``kid`` miss is worth a second request: on a cold
551
+ cache the document in hand *is* the IdP's current one, so retrying would just
552
+ fetch the same bytes again.
553
+ """
554
+ cache_key = _JWKS_KEY_PREFIX + jwks_uri
555
+ if not force_refresh:
556
+ cached = cache.get(cache_key)
557
+ if isinstance(cached, dict):
558
+ return cached, True
559
+
560
+ try:
561
+ egress.assert_url_allowed(jwks_uri)
562
+ resp = egress.get(jwks_uri, headers={"Accept": _ACCEPT_JSON})
563
+ except egress.EgressBlocked as exc:
564
+ raise OIDCProviderUnreachable(f"jwks URL blocked by SSRF guard: {exc}") from exc
565
+ except (egress.EgressTimeout, egress.EgressError) as exc:
566
+ raise OIDCProviderUnreachable(f"could not reach jwks: {exc}") from exc
567
+ if resp.status != 200:
568
+ raise OIDCProviderUnreachable(f"jwks endpoint returned HTTP {resp.status}")
569
+
570
+ data = resp.json()
571
+ if not isinstance(data, dict) or not data.get("keys"):
572
+ raise OIDCIDTokenError("jwks document is empty or malformed")
573
+ cache.set(cache_key, data, _JWKS_TTL_SECONDS)
574
+ return data, False
575
+
576
+
577
+ def _select_signing_key(data: dict[str, Any], id_token: str) -> PyJWK | None:
578
+ """Pick the key from a JWKS document that signed ``id_token``, or ``None``.
579
+
580
+ Matches PyJWKClient's selection: the token's ``kid`` (when present) against a
581
+ signing-use key. ``public_key_use`` is "sig" or absent for signing keys.
582
+ """
583
+ try:
584
+ jwk_set = PyJWKSet.from_dict(data)
585
+ header = jwt.get_unverified_header(id_token)
586
+ except (PyJWKError, PyJWKSetError, jwt.InvalidTokenError, ValueError) as exc:
587
+ raise OIDCIDTokenError(f"could not parse jwks or token header: {exc}") from exc
588
+
589
+ kid = header.get("kid")
590
+ candidates = [
591
+ key
592
+ for key in jwk_set.keys
593
+ if getattr(key, "public_key_use", None) in ("sig", None)
594
+ and (kid is None or key.key_id == kid)
595
+ ]
596
+ return candidates[0] if candidates else None
597
+
598
+
599
+ def _signing_key_for(jwks_uri: str, id_token: str) -> PyJWK:
600
+ """Return the JWKS key that signed ``id_token``, refetching on a ``kid`` miss.
601
+
602
+ A ``kid`` the cached document does not carry is the signature of an IdP that
603
+ rotated its signing keys after we cached — a routine operator action. Failing
604
+ outright there would break every login until the TTL expired even though the
605
+ correct key is one request away, so a miss forces exactly one cache-bypassing
606
+ refetch before giving up. The retry is bounded to the cached case (see
607
+ ``_fetch_jwks``) so an unknown ``kid`` cannot be replayed to drive two
608
+ outbound requests per attempt.
609
+ """
610
+ data, was_cached = _fetch_jwks(jwks_uri)
611
+ key = _select_signing_key(data, id_token)
612
+ if key is None and was_cached:
613
+ data, _ = _fetch_jwks(jwks_uri, force_refresh=True)
614
+ key = _select_signing_key(data, id_token)
615
+ if key is None:
616
+ raise OIDCIDTokenError("no matching signing key in jwks")
617
+ return key
618
+
619
+
620
+ def validate_id_token(
621
+ ctx: ProviderContext, doc: dict[str, Any], id_token: str, *, expected_nonce: str
622
+ ) -> dict[str, Any]:
623
+ """Verify the ID token's signature and claims, returning the claim set.
624
+
625
+ Verifies the RS256/ES256 signature against the discovered JWKS (fetched
626
+ through the SSRF-guarded egress, never PyJWKClient's own socket), and enforces
627
+ ``iss == issuer``, ``aud == client_id``, ``exp``/``iat`` presence, and
628
+ ``nonce`` equality with the value bound at login. Time claims are checked with
629
+ ``_ID_TOKEN_LEEWAY_SECONDS`` of clock-skew tolerance. We keep this rather than
630
+ delegating to allauth's verification (control 4). Any failure raises
631
+ :class:`OIDCIDTokenError`.
632
+ """
633
+ signing_key = _signing_key_for(doc["jwks_uri"], id_token)
634
+
635
+ try:
636
+ claims: dict[str, Any] = jwt.decode(
637
+ id_token,
638
+ signing_key.key,
639
+ algorithms=_ALLOWED_ID_TOKEN_ALGS,
640
+ audience=ctx.client_id,
641
+ issuer=ctx.issuer,
642
+ leeway=_ID_TOKEN_LEEWAY_SECONDS,
643
+ options={"require": ["exp", "iat", "aud", "iss"]},
644
+ )
645
+ except jwt.InvalidTokenError as exc:
646
+ raise OIDCIDTokenError(f"id token validation failed: {exc}") from exc
647
+
648
+ # ``nonce`` binds this ID token to *our* login request (replay defense). PyJWT
649
+ # does not check it, so we enforce equality with the value stored under state.
650
+ if not expected_nonce or claims.get("nonce") != expected_nonce:
651
+ raise OIDCIDTokenError("id token nonce mismatch")
652
+
653
+ return claims
654
+
655
+
656
+ # ---------------------------------------------------------------------------
657
+ # GitHub OAuth2 (no OIDC discovery / JWKS / id_token) — ADR-0517 §3.2
658
+ # ---------------------------------------------------------------------------
659
+
660
+
661
+ def exchange_github_code(ctx: ProviderContext, *, code: str, redirect_uri: str) -> str:
662
+ """Exchange a GitHub authorization ``code`` for an access token (SSRF-guarded).
663
+
664
+ GitHub's OAuth2 has no PKCE/id_token; the token endpoint returns an opaque
665
+ ``access_token`` used to call the user API. The decrypted client secret is read
666
+ from the policy side row at call time and sent only to GitHub.
667
+
668
+ Raises:
669
+ OIDCProviderUnreachable: the token endpoint could not be reached.
670
+ OIDCTokenExchangeError: GitHub returned an OAuth error or no access_token.
671
+ """
672
+ data = {
673
+ "grant_type": "authorization_code",
674
+ "code": code,
675
+ "redirect_uri": redirect_uri,
676
+ "client_id": ctx.client_id,
677
+ "client_secret": ctx.get_client_secret(),
678
+ }
679
+ try:
680
+ resp = egress.post_form(GITHUB_TOKEN_URL, data=data)
681
+ except egress.EgressBlocked as exc:
682
+ raise OIDCProviderUnreachable(
683
+ f"github token endpoint blocked by SSRF guard: {exc}"
684
+ ) from exc
685
+ except (egress.EgressTimeout, egress.EgressError) as exc:
686
+ raise OIDCProviderUnreachable(f"could not reach github token endpoint: {exc}") from exc
687
+
688
+ payload = resp.json()
689
+ if not isinstance(payload, dict):
690
+ raise OIDCTokenExchangeError("github token endpoint returned a non-JSON body")
691
+ if resp.status != 200 or "error" in payload:
692
+ logger.warning( # nosemgrep
693
+ "github token exchange failed: status=%s error=%s",
694
+ resp.status,
695
+ payload.get("error"),
696
+ )
697
+ raise OIDCTokenExchangeError("github token exchange failed")
698
+ access_token = payload.get("access_token")
699
+ if not access_token or not isinstance(access_token, str):
700
+ raise OIDCTokenExchangeError("github token response did not include an access_token")
701
+ return str(access_token)
702
+
703
+
704
+ def _github_get(url: str, access_token: str) -> egress.EgressResponse:
705
+ headers = {
706
+ "Authorization": f"token {access_token}",
707
+ "Accept": "application/vnd.github+json",
708
+ }
709
+ try:
710
+ return egress.get(url, headers=headers)
711
+ except egress.EgressBlocked as exc:
712
+ raise OIDCProviderUnreachable(f"github API blocked by SSRF guard: {exc}") from exc
713
+ except (egress.EgressTimeout, egress.EgressError) as exc:
714
+ raise OIDCProviderUnreachable(f"could not reach github API: {exc}") from exc
715
+
716
+
717
+ def fetch_github_identity(ctx: ProviderContext, access_token: str) -> dict[str, Any]:
718
+ """Fetch the GitHub user identity and normalize it into OIDC-shaped claims.
719
+
720
+ Calls ``GET /user`` (profile) and ``GET /user/emails`` (to pick the verified
721
+ primary email — GitHub's ``email_verified`` analog is the ``verified`` flag on
722
+ the primary entry) through egress, and — if the policy restricts an org —
723
+ verifies membership fail-closed. Returns a claims dict mirroring the OIDC
724
+ shape (``sub``/``email``/``email_verified``/``given_name``) so ``resolve_user``
725
+ is provider-agnostic. ``sub`` is the GitHub numeric user id as a string
726
+ (stable; never the mutable login/email).
727
+
728
+ Raises:
729
+ OIDCIDTokenError: the ``/user`` response was malformed or had no id.
730
+ OIDCEmailUnverified: no verified primary email is available.
731
+ OIDCNoMember: org restriction set and the user is not a member.
732
+ OIDCProviderUnreachable: the GitHub API could not be reached.
733
+ """
734
+ resp = _github_get(GITHUB_USER_URL, access_token)
735
+ if resp.status != 200:
736
+ raise OIDCTokenExchangeError(f"github /user returned HTTP {resp.status}")
737
+ profile = resp.json()
738
+ if not isinstance(profile, dict) or not profile.get("id"):
739
+ raise OIDCIDTokenError("github /user response is malformed or has no id")
740
+
741
+ # Optional org restriction — fail closed if the user is not a member.
742
+ org = (ctx.policy.github_org or "").strip()
743
+ if org:
744
+ login = str(profile.get("login") or "")
745
+ if not login or not _github_user_in_org(access_token, org=org, username=login):
746
+ raise OIDCNoMember("github user is not a member of the required organization")
747
+
748
+ email, email_verified = _github_primary_email(access_token, profile)
749
+
750
+ name = str(profile.get("name") or "")
751
+ given_name = name.split(" ", 1)[0] if name else ""
752
+ family_name = name.split(" ", 1)[1] if " " in name else ""
753
+
754
+ return {
755
+ "sub": str(profile["id"]),
756
+ "email": email,
757
+ "email_verified": email_verified,
758
+ "given_name": given_name,
759
+ "family_name": family_name,
760
+ }
761
+
762
+
763
+ def _github_primary_email(access_token: str, profile: dict[str, Any]) -> tuple[str, bool]:
764
+ """Return ``(email, verified)`` from the user's verified primary GitHub email.
765
+
766
+ Prefers ``GET /user/emails`` (authoritative on primary + verified). Falls back
767
+ to the profile's public ``email`` only when the emails endpoint is unavailable,
768
+ in which case ``verified`` is unknown → reported ``False`` so the fail-closed
769
+ verified-email gate rejects it.
770
+ """
771
+ resp = _github_get(GITHUB_EMAILS_URL, access_token)
772
+ if resp.status == 200:
773
+ emails = resp.json()
774
+ if isinstance(emails, list):
775
+ for entry in emails:
776
+ if isinstance(entry, dict) and entry.get("primary"):
777
+ return str(entry.get("email") or ""), bool(entry.get("verified"))
778
+ # Fallback: the public profile email, treated as unverified (fail closed).
779
+ return str(profile.get("email") or ""), False
780
+
781
+
782
+ def _github_user_in_org(access_token: str, *, org: str, username: str) -> bool:
783
+ """Whether ``username`` is a member of GitHub org ``org`` (fail closed).
784
+
785
+ Uses ``GET /orgs/{org}/members/{username}`` — 204 = member, anything else
786
+ (404/302/403) = not a member / not visible. Any transport error propagates as
787
+ :class:`OIDCProviderUnreachable` from ``_github_get``, so the caller fails
788
+ closed rather than admitting on an ambiguous result.
789
+ """
790
+ resp = _github_get(f"https://api.github.com/orgs/{org}/members/{username}", access_token)
791
+ return resp.status == 204
792
+
793
+
794
+ # ---------------------------------------------------------------------------
795
+ # Identity resolution + account rules
796
+ # ---------------------------------------------------------------------------
797
+
798
+
799
+ def _domain_allowed(policy: SsoProviderPolicy, email: str) -> bool:
800
+ """Whether ``email``'s domain is in the policy allow-list.
801
+
802
+ Empty allow-list = fail closed (no domain permitted). This forces an admin to
803
+ name the domains that may sign in / be created before any account is linked,
804
+ and is the takeover gate alongside ``email_verified``.
805
+ """
806
+ domains = [d.lower() for d in (policy.allowed_email_domains or [])]
807
+ if not domains:
808
+ return False
809
+ domain = email.rsplit("@", 1)[-1].lower()
810
+ return domain in domains
811
+
812
+
813
+ def _unique_username(email: str) -> str:
814
+ """Derive a unique username for a newly auto-created SSO user.
815
+
816
+ The local part of the email is the human-friendly base; a short random suffix
817
+ is appended on collision so two ``alice@`` from different domains (or a
818
+ pre-existing username) never clash.
819
+ """
820
+ base = (email.split("@", 1)[0] or "user")[:140]
821
+ candidate = base
822
+ while User.objects.filter(username=candidate).exists():
823
+ candidate = f"{base}-{secrets.token_hex(3)}"
824
+ return candidate
825
+
826
+
827
+ def _require_active(user: Any, ctx: ProviderContext) -> Any:
828
+ """Refuse a resolved-but-deactivated account before a session is minted (#2875).
829
+
830
+ ``User.is_active = False`` **is** the deactivation mechanism —
831
+ ``workspace/views.py::_apply_member_status_change`` sets it as the thing that
832
+ stops a member logging in — and every other credential path in the auth chain
833
+ honors it: simplejwt rejects an inactive user, DRF's ``SessionAuthentication``
834
+ checks the flag, and the Personal Access Token authenticator was taught to in
835
+ #2832. The SSO callback was the one login path with no reference to it at all,
836
+ so a revoked account ran the entire handshake and was issued a **fresh refresh
837
+ token after the admin revoked it**.
838
+
839
+ ``JWTAuthentication`` refuses the inactive user on every subsequent request, so
840
+ this is defense in depth rather than privilege escalation. It still has to be
841
+ fixed here: a login that reports success and is then 401ed on every call is
842
+ indistinguishable from a broken install, and the refusal belongs where the
843
+ credential is issued rather than where it is spent.
844
+
845
+ Only the two branches that resolve a **pre-existing** user need this. The
846
+ auto-create branch builds the user in this request, so it is active by
847
+ construction — guarding it would be dead code.
848
+
849
+ The refusal is **logged, not audited**. Repeated SSO attempts against a revoked
850
+ account is exactly the signal an operator wants after an off-boarding, and
851
+ before this fix there was nothing distinctive to record because the login simply
852
+ succeeded. It is a log line rather than an ``AuditEvent`` row because the caller
853
+ is unauthenticated at this point: an audit row per attempt would let anyone who
854
+ can drive the callback write unbounded rows, the same amplification the Personal
855
+ Access Token authenticator bounds deliberately. The record carries the user's
856
+ primary key, never their email or any token material.
857
+ """
858
+ if not user.is_active:
859
+ logger.warning(
860
+ "sso login refused: account is deactivated (user_id=%s provider=%s issuer=%s)",
861
+ user.pk,
862
+ ctx.slug,
863
+ ctx.issuer,
864
+ )
865
+ raise OIDCAccountDisabled("account is deactivated")
866
+ return user
867
+
868
+
869
+ def _workspace_role_of(user: Any) -> int | None:
870
+ """The user's current workspace role, or ``None`` when they hold no membership.
871
+
872
+ Recorded on ``sso_account_linked`` so the row answers *what access did this federated
873
+ identity just get?* without a second lookup against state that may since have moved.
874
+ ``None`` is a real answer, not a failure: an account can exist with no membership (a
875
+ superuser holding implicit ownership, or a user provisioned outside the workspace).
876
+ """
877
+ membership = (
878
+ WorkspaceMembership.objects.filter(user=user, is_deleted=False)
879
+ .values_list("role", flat=True)
880
+ .first()
881
+ )
882
+ return int(membership) if membership is not None else None
883
+
884
+
885
+ def _audit_account_linked(user: Any, ctx: ProviderContext, *, subject: str, email: str) -> None:
886
+ """Record that an IdP identity bound itself to a pre-existing local account (#3552).
887
+
888
+ Branch 3 of :func:`resolve_user`. Its sibling — the auto-create branch — has written
889
+ ``MEMBER_ADDED`` since the feature shipped, so the path that mints a *new* account was
890
+ legible while the path that hands a federated credential to an account that already
891
+ has one was not (ADR-1120).
892
+
893
+ Written inside :func:`resolve_user`'s transaction, so a link that fails afterwards
894
+ cannot leave a row claiming it happened. The actor is the **linked user**, matching the
895
+ ``member_added`` / ``invite_accepted`` convention for this unauthenticated join path:
896
+ there is no administrator in the request to attribute it to.
897
+
898
+ The metadata is enumerated deliberately and is **not** derived from the ``claims``
899
+ dict beyond ``subject``. ``record_audit_event`` stores ``metadata`` verbatim, and for
900
+ an OIDC provider ``claims`` is whatever the IdP chose to sign — group lists, phone
901
+ numbers, the nonce, sometimes an embedded token. ``subject`` is the durable
902
+ ``(issuer, subject)`` half an operator needs to correlate this row against their IdP's
903
+ own logs, and is already stored on the ``SocialAccount``.
904
+ """
905
+ # Lazily imported to avoid a workspace→sso import cycle at module load, matching the
906
+ # auto-create branch below and ``projects/views.py::_record_project_audit_event``.
907
+ from trueppm_api.apps.workspace.models import AuditEventType
908
+ from trueppm_api.apps.workspace.services import record_audit_event
909
+
910
+ record_audit_event(
911
+ event_type=AuditEventType.SSO_ACCOUNT_LINKED,
912
+ actor=user,
913
+ target_type="user",
914
+ target_id=user.pk,
915
+ target_label=email,
916
+ metadata={
917
+ "via": "sso",
918
+ "provider": ctx.slug,
919
+ "issuer": ctx.issuer,
920
+ "subject": subject,
921
+ "role": _workspace_role_of(user),
922
+ },
923
+ )
924
+
925
+
926
+ def _render_sso_account_linked_email(
927
+ *, greeting_name: str, provider_name: str, linked_at: Any
928
+ ) -> tuple[str, str, str]:
929
+ """Render (subject, plain-text body, html body) for the account-linked notice (#3554).
930
+
931
+ Follows the inline-render idiom used by password-reset/invites/notifications (no
932
+ templates directory exists in the API). Names the provider and the approximate time
933
+ of the link so the recipient — who, unlike a password-reset request, is guaranteed to
934
+ already hold this mailbox — has enough to judge whether the sign-in was theirs, without
935
+ a link or token that would need its own expiry/replay handling.
936
+
937
+ Takes plain strings rather than the ``User``/``ProviderContext`` objects they were
938
+ read from — see :func:`_send_sso_account_linked_email`.
939
+ """
940
+ subject = "A new sign-in method was added to your TruePPM account"
941
+ when = linked_at.strftime("%Y-%m-%d %H:%M UTC")
942
+
943
+ text_body = "\n".join(
944
+ [
945
+ f"Hi {greeting_name},",
946
+ "",
947
+ f"Your TruePPM account was just linked to a {provider_name} sign-in, at "
948
+ f"{when}. From now on you can sign in with either your password or "
949
+ f"{provider_name}.",
950
+ "",
951
+ "If this was you, no action is needed.",
952
+ "",
953
+ "If you did not do this, someone who controls a mailbox matching your "
954
+ "account's email address may have signed in through your identity "
955
+ "provider. Contact your workspace administrator right away so they can "
956
+ "review your account.",
957
+ ]
958
+ )
959
+
960
+ html_body = "".join(
961
+ [
962
+ f"<p>Hi {escape(greeting_name)},</p>",
963
+ f"<p>Your TruePPM account was just linked to a {escape(provider_name)} "
964
+ f"sign-in, at {escape(when)}. From now on you can sign in with either "
965
+ f"your password or {escape(provider_name)}.</p>",
966
+ "<p>If this was you, no action is needed.</p>",
967
+ "<p>If you did not do this, someone who controls a mailbox matching your "
968
+ "account's email address may have signed in through your identity "
969
+ "provider. Contact your workspace administrator right away so they can "
970
+ "review your account.</p>",
971
+ ]
972
+ )
973
+ return subject, text_body, html_body
974
+
975
+
976
+ def _send_sso_account_linked_email(
977
+ *, user_id: Any, recipient: str, greeting_name: str, provider_name: str, linked_at: Any
978
+ ) -> bool:
979
+ """Best-effort notify the linked account that an SSO identity was just bound to it (#3554).
980
+
981
+ Called only from :func:`resolve_user` branch 3 (first-time link by verified email),
982
+ deferred with ``transaction.on_commit`` by the caller so a link that is rolled back
983
+ (e.g. :func:`_require_active` raising) never sends a notice for a binding that was
984
+ never actually created. Never called on branch 1 (repeat login by durable
985
+ ``(issuer, subject)``), so an established SSO user is not re-notified on every sign-in.
986
+
987
+ Takes plain strings, not the ``User``/``ProviderContext`` the caller read them from:
988
+ an ``on_commit`` closure that instead captured those live objects would be reading
989
+ them well after the transaction that produced them closed, and — though this one
990
+ fires synchronously in the same request, not via Celery — nothing about the
991
+ ``on_commit`` contract promises that stays true, so the closure must not depend on it.
992
+ The caller resolves ``greeting_name``/``recipient``/``provider_name`` before
993
+ registering this call.
994
+
995
+ Mirrors ``core.password_reset.send_password_reset_email``'s failure posture: a mail
996
+ transport that is unconfigured, unusable, or errors mid-send is logged and swallowed
997
+ rather than raised. The caller runs this from an ``on_commit`` hook fired at the tail
998
+ of the SSO callback view, so an unhandled exception here would surface as a 500 on a
999
+ login that has, from the user's perspective, already succeeded — worse than a
1000
+ best-effort notice that occasionally does not arrive.
1001
+ """
1002
+ if not recipient:
1003
+ return False
1004
+
1005
+ from trueppm_api.apps.notifications.delivery_limits import (
1006
+ note_unbudgeted_send,
1007
+ workspace_throttle_per_min,
1008
+ )
1009
+ from trueppm_api.apps.notifications.email_backend import (
1010
+ resolve_email_connection,
1011
+ resolve_from_email,
1012
+ resolve_reply_to,
1013
+ )
1014
+
1015
+ try:
1016
+ connection = resolve_email_connection()
1017
+ except Exception:
1018
+ logger.warning("sso account-linked email: mail transport unusable")
1019
+ return False
1020
+
1021
+ # A one-time security notice tied to a specific login event: like the password-reset
1022
+ # email, it charges the shared per-minute delivery budget but is never refused by it
1023
+ # (#2887 item 3) — a batch of invites spending the minute must not suppress a notice
1024
+ # about who can now sign in to this account.
1025
+ note_unbudgeted_send(workspace_throttle_per_min())
1026
+
1027
+ subject, text_body, html_body = _render_sso_account_linked_email(
1028
+ greeting_name=greeting_name, provider_name=provider_name, linked_at=linked_at
1029
+ )
1030
+ msg = EmailMultiAlternatives(
1031
+ subject=subject,
1032
+ body=text_body,
1033
+ from_email=resolve_from_email(),
1034
+ to=[recipient],
1035
+ reply_to=resolve_reply_to() or None,
1036
+ connection=connection,
1037
+ )
1038
+ msg.attach_alternative(html_body, "text/html")
1039
+ try:
1040
+ msg.send(fail_silently=False)
1041
+ except Exception:
1042
+ logger.warning("sso account-linked email failed for user %s", user_id, exc_info=True)
1043
+ return False
1044
+ return True
1045
+
1046
+
1047
+ @transaction.atomic
1048
+ def resolve_user(ctx: ProviderContext, claims: dict[str, Any]) -> tuple[Any, bool]:
1049
+ """Resolve (and possibly create/link) the local user for a validated identity.
1050
+
1051
+ Resolution order (ADR-0517 §3.2, preserving ADR-0187 §2):
1052
+
1053
+ 1. **Durable key** — an existing ``SocialAccount`` on ``(provider=slug, uid=sub)``
1054
+ **whose stored issuer matches the current provider issuer** wins outright.
1055
+ Later logins always route here, never by email. The provider slug
1056
+ disambiguates distinct OIDC IdPs that share allauth's ``openid_connect``
1057
+ type; the ``(issuer, subject)`` pair is the real durable key (ADR-0187 §2 /
1058
+ ADR-0517 §3.1). Requiring the issuer match on resolve — not just storing it
1059
+ at bind time — closes a cross-issuer ``sub``-collision takeover: an admin who
1060
+ repoints a slug to a new issuer must not let a user at the new issuer whose
1061
+ ``sub`` collides with an old binding resolve to the wrong local user. On
1062
+ issuer mismatch we **fail closed** (``OIDCNoMember``) rather than fall
1063
+ through, because allauth's ``(provider, uid)`` unique key means a second
1064
+ binding for the same ``(slug, subject)`` under the new issuer cannot be
1065
+ created anyway.
1066
+ 2. **Verified email** — require ``email`` present and ``email_verified is True``
1067
+ and the domain in the allow-list; otherwise fail closed.
1068
+ 3. **Link** — exactly one existing local user with that email → bind a new
1069
+ ``SocialAccount`` and sign in. (Ambiguous: 0 or >1 → not a link.) A best-effort
1070
+ notice email is deferred to commit (#3554) so the local account learns a new
1071
+ sign-in method was just added — this is the one branch that hands a federated
1072
+ credential to an account whose owner may not have expected it.
1073
+ 4. **Auto-create** — no existing user, ``auto_create_members`` on → create the
1074
+ user + one ``WorkspaceMembership`` at the resolved role, bind the identity.
1075
+ 5. Otherwise → :class:`OIDCNoMember`.
1076
+
1077
+ Branches 1 and 3 additionally refuse a **deactivated** account with
1078
+ :class:`OIDCAccountDisabled` (see :func:`_require_active`, #2875) — the SSO
1079
+ callback was the one login path that never consulted ``is_active``.
1080
+
1081
+ Returns ``(user, created)``. Wrapped in a transaction so a half-created
1082
+ user/membership/identity never persists.
1083
+ """
1084
+ from allauth.socialaccount.models import SocialAccount
1085
+
1086
+ provider_key = ctx.slug
1087
+ issuer = ctx.issuer
1088
+ subject = str(claims.get("sub") or "")
1089
+ if not subject:
1090
+ raise OIDCIDTokenError("identity has no subject")
1091
+
1092
+ # 1. Durable identity — resolve by the stable (issuer, subject) pair, never the
1093
+ # mutable email. The (provider=slug, uid=subject) row is only trusted when its
1094
+ # stored issuer matches the current provider issuer: a slug repointed to a new
1095
+ # issuer must not resolve a colliding ``sub`` to the old issuer's user (takeover
1096
+ # defense). On mismatch we **fail closed** below rather than falling through to
1097
+ # the verified-email path, because allauth's (provider, uid) unique key means a
1098
+ # second binding under the new issuer could not be created anyway. For GitHub
1099
+ # the issuer is the fixed GITHUB_ISSUER constant, so bindings still match.
1100
+ account = (
1101
+ SocialAccount.objects.select_related("user")
1102
+ .filter(provider=provider_key, uid=subject)
1103
+ .first()
1104
+ )
1105
+ if account is not None:
1106
+ if account.extra_data.get("iss") == issuer:
1107
+ return _require_active(account.user, ctx), False
1108
+ # (provider=slug, uid=subject) is already bound to a DIFFERENT issuer. We
1109
+ # must never resolve to the old issuer's user (cross-issuer sub-collision
1110
+ # takeover), and — because allauth's SocialAccount key is (provider, uid),
1111
+ # with the issuer disambiguator only in extra_data — we cannot create a
1112
+ # second binding for the same (slug, subject) under the new issuer either.
1113
+ # Fail closed.
1114
+ raise OIDCNoMember("subject is bound to a different issuer for this provider")
1115
+
1116
+ # 2. Verified-email gate.
1117
+ email = (claims.get("email") or "").strip()
1118
+ if not email or claims.get("email_verified") is not True:
1119
+ raise OIDCEmailUnverified("IdP did not assert a verified email")
1120
+ if not _domain_allowed(ctx.policy, email):
1121
+ raise OIDCNoMember("email domain is not permitted")
1122
+
1123
+ # 3. Link to an existing local account (only when unambiguous).
1124
+ existing = list(User.objects.filter(email__iexact=email)[:2])
1125
+ if len(existing) == 1:
1126
+ # Checked BEFORE the binding is written: a refused login must not leave a
1127
+ # SocialAccount row behind, or reactivating the member later would silently
1128
+ # skip the verified-email link step that created it.
1129
+ _require_active(existing[0], ctx)
1130
+ SocialAccount.objects.create(
1131
+ user=existing[0], provider=provider_key, uid=subject, extra_data={"iss": issuer}
1132
+ )
1133
+ _audit_account_linked(existing[0], ctx, subject=subject, email=email)
1134
+ # Notify the local account that an SSO identity was just bound to it (#3554).
1135
+ # Deferred to commit so a link that unwinds (e.g. a later error in this same
1136
+ # transaction) never sends a notice for a binding that was never persisted.
1137
+ # Every value the closure needs is resolved to a plain string/datetime *now*,
1138
+ # before it is registered — not read from `existing[0]`/`ctx` inside the lambda —
1139
+ # so the callback cannot depend on either row still reflecting live state (or
1140
+ # still existing at all) by the time it actually runs.
1141
+ notify_user_id = existing[0].pk
1142
+ notify_recipient = existing[0].email
1143
+ notify_greeting_name = existing[0].get_short_name() or existing[0].get_username()
1144
+ notify_provider_name = ctx.display_name
1145
+ notify_linked_at = timezone.now()
1146
+ transaction.on_commit(
1147
+ lambda: _send_sso_account_linked_email(
1148
+ user_id=notify_user_id,
1149
+ recipient=notify_recipient,
1150
+ greeting_name=notify_greeting_name,
1151
+ provider_name=notify_provider_name,
1152
+ linked_at=notify_linked_at,
1153
+ )
1154
+ )
1155
+ return existing[0], False
1156
+ if len(existing) > 1:
1157
+ # Email is not unique in Django's auth model; an ambiguous match must not
1158
+ # silently pick one account (takeover risk). Fail closed.
1159
+ raise OIDCNoMember("ambiguous account for email")
1160
+
1161
+ # 4. Auto-create.
1162
+ if not ctx.policy.auto_create_members:
1163
+ raise OIDCNoMember("no account and auto-create disabled")
1164
+
1165
+ user = User.objects.create(
1166
+ username=_unique_username(email),
1167
+ email=email,
1168
+ first_name=(claims.get("given_name") or "")[:150],
1169
+ last_name=(claims.get("family_name") or "")[:150],
1170
+ )
1171
+ # SSO-only account — no usable local password. Account-linking (branch 3)
1172
+ # preserves an existing user's password; freshly created users have none.
1173
+ user.set_unusable_password()
1174
+ user.save(update_fields=["password"])
1175
+
1176
+ role = oidc_role_for(claims, ctx.policy)
1177
+ WorkspaceMembership.objects.create(
1178
+ workspace=ctx.policy.workspace,
1179
+ user=user,
1180
+ role=role,
1181
+ status=MemberStatus.ACTIVE,
1182
+ )
1183
+ SocialAccount.objects.create(
1184
+ user=user, provider=provider_key, uid=subject, extra_data={"iss": issuer}
1185
+ )
1186
+
1187
+ # Audit the join. Imported lazily to avoid a workspace→sso import cycle at
1188
+ # module load; the helper writes the row inside this transaction (rolls back
1189
+ # with us) and fans out the signal on commit.
1190
+ from trueppm_api.apps.workspace.models import AuditEventType
1191
+ from trueppm_api.apps.workspace.services import record_audit_event
1192
+
1193
+ record_audit_event(
1194
+ event_type=AuditEventType.MEMBER_ADDED,
1195
+ actor=user,
1196
+ target_type="user",
1197
+ target_id=user.pk,
1198
+ target_label=email,
1199
+ # ``role`` added in #3552: ``administration/audit-log.md`` has documented
1200
+ # ``member_added`` as carrying it since the verb shipped, and this emission site
1201
+ # omitted it while having just computed it — leaving "what access did this
1202
+ # federated identity get?" unanswerable from the row that grants it.
1203
+ metadata={"via": "sso", "issuer": issuer, "provider": provider_key, "role": int(role)},
1204
+ )
1205
+ return user, True
1206
+
1207
+
1208
+ # ---------------------------------------------------------------------------
1209
+ # Removal impact — what an admin is about to break (#2874)
1210
+ # ---------------------------------------------------------------------------
1211
+
1212
+
1213
+ @dataclass(frozen=True)
1214
+ class RemovalImpact:
1215
+ """What removing one provider costs, surfaced to the admin before they confirm.
1216
+
1217
+ ``locked_out_accounts`` is the number that matters: members whose **only**
1218
+ sign-in method is this provider's binding.
1219
+ """
1220
+
1221
+ linked_accounts: int
1222
+ locked_out_accounts: int
1223
+
1224
+
1225
+ def removal_impact(slugs: list[str]) -> dict[str, RemovalImpact]:
1226
+ """Per-slug removal impact for every slug in ``slugs`` (#2874).
1227
+
1228
+ Why this has to exist: the DELETE path purges the provider's ``SocialAccount``
1229
+ rows, and that purge is **load-bearing** — it is exactly what lets users
1230
+ re-link by verified email when an admin follows the documented remove-and-re-add
1231
+ route to move a provider to a new issuer. Keeping the rows instead would leave
1232
+ every binding stamped with the old ``iss``, and ``resolve_user`` would fail
1233
+ them closed forever.
1234
+
1235
+ The cost of that purge is a member who has no other credential.
1236
+ :func:`resolve_user` calls ``set_unusable_password()`` on every JIT-created
1237
+ user, and ``core/password_reset.py`` gates the request path on
1238
+ ``has_usable_password()`` — so an SSO-only account receives the
1239
+ anti-enumeration 200 and no email. Until the provider (or another configured
1240
+ provider that admits their email domain) is set up again they cannot sign in by
1241
+ any route, and no admin set-password endpoint exists. That is a real,
1242
+ unrecoverable-by-self-service state, so the admin has to be given the number
1243
+ before they confirm it.
1244
+
1245
+ "No other sign-in method" means: no usable local password, **and** no surviving
1246
+ binding to any *other* still-configured provider. Deactivated accounts are
1247
+ excluded — they cannot sign in either way, so counting them would inflate the
1248
+ warning and train admins to ignore it.
1249
+
1250
+ Costs **two queries regardless of how many providers are configured**: the
1251
+ bindings and the credential-less user set are each fetched once and paired in
1252
+ Python, rather than running a per-slug aggregate that would make the admin list
1253
+ page's query count scale with the registry.
1254
+ """
1255
+ from allauth.socialaccount.models import SocialAccount
1256
+ from django.contrib.auth.hashers import UNUSABLE_PASSWORD_PREFIX
1257
+ from django.db.models import Q
1258
+
1259
+ wanted = list(slugs)
1260
+ if not wanted:
1261
+ return {}
1262
+
1263
+ # Scope the bindings to *configured* providers: a leftover row for a provider
1264
+ # that no longer exists is not a sign-in method, so it must not count as the
1265
+ # "other" credential that makes a user safe to strand.
1266
+ configured = list(SsoProviderPolicy.objects.values_list("slug", flat=True))
1267
+ bindings = list(
1268
+ SocialAccount.objects.filter(provider__in=configured).values_list("user_id", "provider")
1269
+ )
1270
+
1271
+ per_user: dict[Any, set[str]] = {}
1272
+ for user_id, provider in bindings:
1273
+ per_user.setdefault(user_id, set()).add(provider)
1274
+
1275
+ # The DB-pushable subset of ``has_usable_password()``: the two shapes this
1276
+ # codebase actually produces — ``set_unusable_password()``'s "!"-prefixed
1277
+ # sentinel and an empty column. Django additionally treats a hash no hasher can
1278
+ # parse as unusable; such a value would be missed here, which under-counts (the
1279
+ # admin is warned about fewer members than are really stranded) rather than
1280
+ # over-counts. Accepted: no code path in this repo writes a malformed hash, and
1281
+ # pulling every bound user into Python to call ``has_usable_password()`` would
1282
+ # trade a real per-request cost for a state that cannot occur.
1283
+ credential_less = set(
1284
+ User.objects.filter(
1285
+ Q(password="") | Q(password__startswith=UNUSABLE_PASSWORD_PREFIX),
1286
+ pk__in=list(per_user),
1287
+ is_active=True,
1288
+ ).values_list("pk", flat=True)
1289
+ )
1290
+
1291
+ linked = dict.fromkeys(wanted, 0)
1292
+ locked_out = dict.fromkeys(wanted, 0)
1293
+ for user_id, providers in per_user.items():
1294
+ sole_binding = len(providers) == 1
1295
+ strands = sole_binding and user_id in credential_less
1296
+ for provider in providers:
1297
+ if provider not in linked:
1298
+ continue
1299
+ linked[provider] += 1
1300
+ if strands:
1301
+ locked_out[provider] += 1
1302
+
1303
+ return {
1304
+ slug: RemovalImpact(linked_accounts=linked[slug], locked_out_accounts=locked_out[slug])
1305
+ for slug in wanted
1306
+ }
1307
+
1308
+
1309
+ # ---------------------------------------------------------------------------
1310
+ # Test connection (admin)
1311
+ # ---------------------------------------------------------------------------
1312
+
1313
+
1314
+ def check_provider_reachability(ctx: ProviderContext) -> dict[str, Any]:
1315
+ """Probe a provider's reachability for the admin "Test connection" button.
1316
+
1317
+ OIDC: fetch discovery (cache-bypassed) + confirm JWKS reachability. GitHub:
1318
+ confirm the token endpoint host is reachable (a HEAD-equivalent GET of the API
1319
+ root). Never raises — returns a structured ``{ok, ...}`` result so the admin
1320
+ page can render a clear pass/fail.
1321
+ """
1322
+ if ctx.is_github:
1323
+ return _check_github_reachability()
1324
+ return _check_oidc_reachability(ctx.issuer)
1325
+
1326
+
1327
+ def _check_oidc_reachability(issuer_url: str) -> dict[str, Any]:
1328
+ cache.delete(_DISCOVERY_KEY_PREFIX + issuer_url)
1329
+ try:
1330
+ doc = get_discovery_document(issuer_url)
1331
+ except OIDCError as exc:
1332
+ return {"ok": False, "issuer": issuer_url, "error": exc.code, "detail": str(exc)}
1333
+
1334
+ jwks_uri = doc.get("jwks_uri", "")
1335
+ # Deliberately its own egress call rather than ``_fetch_jwks``: "Test
1336
+ # connection" must prove the endpoint is reachable *now* (a cached hit would
1337
+ # report a healthy provider whose keys endpoint has since died), and it must
1338
+ # not populate the login path's cache from a probe. It also keeps the probe's
1339
+ # own error taxonomy, which folds a non-200 into ``jwks_empty`` — for an admin
1340
+ # "the keys are not usable" and "the keys are not there" need the same fix.
1341
+ try:
1342
+ egress.assert_url_allowed(jwks_uri)
1343
+ jwks_resp = egress.get(jwks_uri, headers={"Accept": _ACCEPT_JSON})
1344
+ except (egress.EgressBlocked, egress.EgressTimeout, egress.EgressError) as exc:
1345
+ return {"ok": False, "issuer": issuer_url, "error": "jwks_unreachable", "detail": str(exc)}
1346
+
1347
+ keys = jwks_resp.json() if jwks_resp.status == 200 else None
1348
+ if not isinstance(keys, dict) or not keys.get("keys"):
1349
+ return {"ok": False, "issuer": issuer_url, "error": "jwks_empty"}
1350
+
1351
+ return {
1352
+ "ok": True,
1353
+ "issuer": issuer_url,
1354
+ "endpoints": {
1355
+ "authorization_endpoint": doc.get("authorization_endpoint", ""),
1356
+ "token_endpoint": doc.get("token_endpoint", ""),
1357
+ "jwks_uri": jwks_uri,
1358
+ },
1359
+ }
1360
+
1361
+
1362
+ def _check_github_reachability() -> dict[str, Any]:
1363
+ try:
1364
+ egress.assert_url_allowed(GITHUB_USER_URL)
1365
+ resp = egress.get(GITHUB_USER_URL)
1366
+ except (egress.EgressBlocked, egress.EgressTimeout, egress.EgressError) as exc:
1367
+ return {
1368
+ "ok": False,
1369
+ "issuer": GITHUB_ISSUER,
1370
+ "error": "github_unreachable",
1371
+ "detail": str(exc),
1372
+ }
1373
+ # An unauthenticated GET /user returns 401 — that still proves the endpoint is
1374
+ # reachable (which is all "test connection" verifies before credentials are used).
1375
+ if resp.status in (200, 401):
1376
+ return {
1377
+ "ok": True,
1378
+ "issuer": GITHUB_ISSUER,
1379
+ "endpoints": {
1380
+ "authorization_endpoint": GITHUB_AUTHORIZE_URL,
1381
+ "token_endpoint": GITHUB_TOKEN_URL,
1382
+ "jwks_uri": "",
1383
+ },
1384
+ }
1385
+ return {"ok": False, "issuer": GITHUB_ISSUER, "error": "github_unreachable"}