Ephemere User-Verification kann nicht aktiviert werden

[larsUE]

Gemäss Changelogs von Decidim wurde mit Version 0.31 die ephemeral user verification hinzugefügt. Diese sollte eigentlich im System Backend unter der Authorifizierungsformen aktiviert und dann auf Komponentenebene eingestellt werden. Leider fehlt mir im System Backend, die Möglichkeit, diese Form zu aktivieren.

Link zu den Docs dazu: https://docs.decidim.org/en/v0.31/admin/participants/authorizations/ephemeral_verifications.html

Aufgabe: Bitte hinzufügen

[larsUE]

Kommentar: Gemäss den Doks muss dies an eine bestehenden Verifizierung angedockt werden: https://docs.decidim.org/en/develop/admin/participants/authorizations/ephemeral_verifications.html

Bitte deshalb im Zusammenhang mit #612 prüfen und an die SMS-Verifizierung andocken.

[larsUE]

Kein Bug, existiert deshalb noch auf 0.31.5

[carlobeltrame]

@larsUE wie du sagst müsste man das gemäss Doku einfach im System Dashboard aktivieren können. Allerdings sehe ich auch keine Option dafür, und auch im Code von Decidim 0.31 fürs /system Dashboard ist "ephemeral" nirgends erwähnt. Auch im Changelog ist nichts davon erwähnt, dass das jetzt verfügbar sein sollte.

Kann es sein, dass die Doku lückenhaft ist und man dafür dieses Modul installieren muss? https://github.com/OpenSourcePolitics/decidim-module-ephemeral_authorization_handler

Oder kann es sein, dass die Doku komplett falsch ist, und diese Ephemeral Verifications nur für Initiativen funktionieren, und nur via Code statt im /system Dashboard konfiguriert werden können? Siehe https://github.com/decidim/decidim/releases/tag/v0.31.0 Kapitel 5.8 Initiatives digital signature process change:

Signature workflows can be defined as ephemeral, in which case users can sign initiatives without prior registration. For a workflow of this type to work correctly, an authorization handler form must be defined in authorization_handler_form and authorizations saving must not be disabled using the save_authorizations setting, in order to ensure that user verifications are saved based on the personal data they provide.

Ich habe den Change auf das Issue decidim/decidim#13951 getrackt, der Text in der Dokumentation basiert auf der Issue-Beschreibung. Im Issue und im dazugehörigen PR geht es nur um Initiativen-Signaturen, und es wurden keinerlei Änderungen am /system Dashboard gemacht.

[larsUE]

Ich glaube nicht, dass das mit anderen Modulen verknüpft ist. Das ist mit 0.31 ein Core-Feature für zahlreiche Komponenten, welches verschiedene Provider aber mittels Modul gebackported haben. Auf anderen Plattformen, kommt es standardmässig mit. Dort habe ich es bereits getestet. So wie ich es verstehe, muss die ephemerale Möglichkeit direkt bei der Definition des SMS-Workflows (oder einer anderen Authentifizierungsart) registriert/angedockt sein. Aber ja, die Dokumentation dazu scheint sehr spärlich zu sein 😅

KI meint (deckt sich mit wie ich die Regsitrierung erwartet hätte):

What's missing in Decidim Zürich

I searched the entire puzzle/decidim-zuerich codebase (commit 2a72253). There is:

• No config/initializers/verifications.rb (or equivalent)
• No Decidim::Verifications.register_workflow(...) call anywhere
• No ephemeral authorization handler class
• No ephemeral references in locales or app code

The only register_workflow mention is a comment inside an old migration file.

By contrast, Decidim's own generator template (verifications_initializer.rb) registers an example:

Decidim::Verifications.register_workflow(:ephemeral_dummy_authorization_handler) do |workflow|
  workflow.ephemeral = true
  workflow.form = "EphemeralDummyAuthorizationHandler"
  # ...
end

That file is only created for new Decidim apps — it is not added automatically during an upgrade.

How other cities do it

Barcelona (decidim-barcelona) registers a dedicated ephemeral workflow in config/initializers/decidim.rb:

Decidim::Verifications.register_workflow(:ephemeral_census_authorization_handler) do |auth|
  auth.form = "EphemeralCensusAuthorizationHandler"
  auth.ephemeral = true
  # links to their census handler via a subclass
end

The "link to an existing verification method" from the Decidim docs is done in code — typically by subclassing the existing handler (e.g. EphemeralCensusAuthorizationHandler < CensusAuthorizationHandler), not via a UI setting.

What you should see vs. what's missing
In the system panel under "Available authorizations" you should currently see checkboxes for the built-in methods (SMS, CSV census, ID documents, postal letter). You will not see an ephemeral option until you implement and register it.

What needs to be done

To get the ephemeral checkbox to appear, you need application-level setup:

1. Create an ephemeral authorization handler — for Zürich, likely an SMS-based one such as EphemeralSmsAuthorizationHandler, reusing your existing SMS verification logic.
2. Register the workflow in a new initializer, e.g. config/initializers/verifications.rb:

Decidim::Verifications.register_workflow(:ephemeral_sms_authorization_handler) do |workflow|
workflow.ephemeral = true
workflow.form = "EphemeralSmsAuthorizationHandler"
# or workflow.engine = ... if reusing the SMS engine
end

3. Add locale strings under decidim.authorization_handlers for the handler name/description.
4. Restart the app, then enable the new method in the system backend.
5. In the org admin, enable ephemeral permissions on the relevant component (budgets, surveys, etc.).

This is new configuration work for 0.31, not something the upgrade applies automatically.