FinTS: TAN-Verfahren 946 (SecureGo plus) – Automatisches Polling bei HKTAN#7

[TWeinsberg]

FinTS – Unterstützung für TAN-Verfahren 946 (SecureGo plus / Decoupled HKTAN#7)

Hallo zusammen,

ich beschäftige mich aktuell mit der Implementierung des TAN-Verfahrens 946 (SecureGo plus) in der Bibliothek libfintx.FinTS.

Als Testbank verwende ich die PSD Bank Rhein-Ruhr eG, die das Decoupled-Verfahren mit HKTAN Segmentversion 7 unterstützt.

Die grundlegende Kommunikation mit der Bank funktioniert bereits. Dazu gehören:

• Verbindungsaufbau und Dialoginitialisierung
• Authentifizierung mit Benutzerkennung und PIN
• Erkennung des TAN-Verfahrens 946
• Abruf von Kontoinformationen und Kontoständen
• Abruf von Kontoumsätzen (CAMT)

1. Problemstellung

Beim Decoupled-Verfahren erfolgt die Freigabe einer Transaktion ausschließlich über die SecureGo plus App.

Im Gegensatz zu klassischen TAN-Verfahren wird keine TAN manuell eingegeben.

Die Bank liefert über das HITAN-Segment eine entsprechende Aufforderung, beispielsweise:

Bitte bestätigen Sie den Vorgang in Ihrer SecureGo plus App.

Die eigentliche Herausforderung besteht darin, nach der Freigabe automatisch zu erkennen, ob die Transaktion erfolgreich autorisiert wurde.

2. Bisherige Implementierung

Ich habe die bestehenden Klassen FinTsClient, TANDialog und Tanverfahren entsprechend erweitert.

In TANDialog stehen unter anderem folgende Eigenschaften zur Verfügung:

public bool IsDecoupled { get; set; }
public string DecoupledMessage { get; set; }

Damit lässt sich zwischen einer klassischen TAN-Eingabe und dem Decoupled-Verfahren unterscheiden.

In der Konsolenanwendung wird bei IsDecoupled == true die Aufforderung zur Freigabe angezeigt.

Aktuell muss der Benutzer nach erfolgreicher Freigabe in der App zusätzlich die Enter-Taste drücken, damit die Verarbeitung fortgesetzt wird.

Das funktioniert als Übergangslösung, ist aber insbesondere für eine spätere Integration in eine Blazor-Anwendung nicht optimal.

3. Gewünschte Lösung: Automatisches Polling

Mein Ziel ist es, die Freigabe vollständig ohne zusätzliche Benutzereingabe abzuwickeln.

Der gewünschte Ablauf:

1. Eine FinTS-Transaktion wird gestartet.
2. Die Bank fordert die Freigabe über SecureGo plus an.
3. Der Benutzer bestätigt den Vorgang in der App.
4. Der Client fragt den Status der Freigabe regelmäßig über das vorgesehene HKTAN-Verfahren ab.
5. Sobald die Freigabe bestätigt wurde, wird die ursprüngliche Transaktion automatisch fortgesetzt.
6. Bei Ablehnung oder Zeitüberschreitung wird der Vorgang entsprechend beendet.

Dabei sollte der Polling-Vorgang asynchron erfolgen und keine blockierende Konsoleneingabe benötigen.

4. Offene Fragen

Mich interessieren insbesondere folgende Punkte:

• Unterstützt libfintx.FinTS bereits einen vollständigen Polling-Ablauf für HKTAN#7?
• Falls ja, wie muss dieser korrekt angestoßen werden?
• Wird die Auftragsreferenz aus dem HITAN-Segment für die wiederholte Statusabfrage verwendet?
• Wie werden Polling-Intervall und maximale Wartezeit anhand der Bankparameter berücksichtigt?
• Ist es möglich, während des Pollings Statusmeldungen an den TANDialog beziehungsweise die aufrufende Anwendung weiterzugeben?
• Wie sollte die Integration in eine asynchrone Benutzeroberfläche (z. B. Blazor Server) idealerweise erfolgen?

5. Ziel

Ich möchte die Unterstützung des Decoupled-Verfahrens möglichst direkt in die bestehende Bibliothek integrieren, sodass sowohl Konsolenanwendungen als auch grafische Benutzeroberflächen davon profitieren können.

Die angehängte ZIP-Datei enthält meinen aktuellen Entwicklungsstand mit den angepassten Klassen:

• FinTsClient.cs
• TANDialog.cs
• Tanverfahren.cs
• Program.cs (Konsolenbeispiel)

TanDialog-946.zip

Über Hinweise zur korrekten Umsetzung des Polling-Verfahrens oder Anregungen zur Integration in die bestehende Architektur würde ich mich freuen.

Gerne würde ich meine Anpassungen nach entsprechender Abstimmung auch als Pull Request zur Verfügung stellen.

Vielen Dank!

[leo-schick]

Hallo,

danke für die ausführliche Beschreibung! Das Polling für HKTAN#7 ist in libfintx.FinTS bereits eingebaut. Dass du Enter drücken musst, liegt an deinem Callback.

Ablauf: Bei Rückmeldung 3955 ruft FinTsClient.ProcessSCA() einmal waitForTanAsync auf. Danach sendet die Library alle 2 Sekunden HKTAN mit Prozess S, solange die Bank 3956 meldet. Am Ende wird onTransactionEndAsync(bool success) aufgerufen. Das Polling startet aber erst, wenn dein Callback zurückkehrt, und im Sample-Projekt blockiert er mit Console.ReadLine(). Lösung:

var tanDialog = new TANDialog(
    dlg => dlg.DialogResult.IsApprovalRequired
        ? Task.FromResult<string>(null)          // decoupled: sofort zurück
        : Task.FromResult(Console.ReadLine()),   // klassische TAN
    success => { Console.WriteLine(success ? "Freigegeben" : "Abgelehnt"); return Task.CompletedTask; });

Anstelle von IsDecoupled wäre es besser, auf IsApprovalRequired zu prüfen.

Auftragsreferenz: Ja, sie wird aus HITAN gelesen und in der Statusabfrage mitgeschickt (HKTAN:…:7+S++++<Referenz>+N').

Grenzen der aktuellen Version:

• Das Intervall ist fest auf 2 Sekunden. Die Decoupled-Parameter aus HITANS#7 (Wartezeiten, max. Anzahl Abfragen) werden nicht ausgewertet, und es gibt keinen Timeout.
• Statusmeldungen während des Pollings werden nicht weitergegeben.
• IsCancelWaitForApproval beendet die Schleife nicht (Bug).

Sehr gerne kannst du einen PR reinschicken. Ich könnte mir es so vorstellen: HITANS#7-Parameter parsen und nutzen, den Abbruch per CancellationToken korrigieren, einen Status-Callback pro Abfrage und Code 946 in Tanverfahren.

[TWeinsberg]

Dieser TanDialog,
funktioniert einwandfrei!

Danke

[TWeinsberg]

Hallo und guten Tag,
ich hatte in TANDialog.cs folgenden Hinweis entdeckt:

        /// <summary>
        /// Bei Verwendung des Decoupled-Verfahren (HKTAN#7) setzen.
        /// </summary>
        public bool IsDecoupled { get; set; }

Deswegen hatte ich eine Möglichkeit gesucht, ohne andere Tanverfahren zu stören, diesen Parameter zu setzen.

In der MainForm.cs wird dies nur bei TanVerfahren 922 gesetzt.

        private TANDialog CreateTANDialog(FinTsClient client)
        {
            var dialog = new TANDialog(WaitForTanAsync, pBox_tan);
            if (client.HIRMS == "922")
                dialog.IsDecoupled = true;

            return dialog;
        }

Zu mindestens bei meiner Bank funktioniert diese Lösung

Der Intervall ist bei meiner Bank auch Okay, hier zur Info das passende Segment:

HITANS:75:7:4+1+1+1+N:N:0:946:2:DECOUPLED:Decoupled::SecureGo plus (Direktfreigabe):::TAN:2048:J:1:N:0:2:N:J:00:0:N:1:150:2:2:J:J'

Wert Bedeutung
150 Maximale Wartezeit: 150 Anfragen
2 Mindestabstand zwischen Statusabfragen: 2 Sekunden
2 Weitere Zeitangabe für Statusabfragen (verfahrensabhängig)
J:J Weitere Verfahrensmerkmale

Grüße