Das TAN Modul kann für zwei verschiedene Arten von TAN Abfragen verwendet werden. Zum einen für einmalige TANs um bestimmte Aktionen zu bestätigen. Hierfür kann die PHP Funktion TyTan::checkTan() verwendet werden, die zurückliefert ob die eingegebene TAN gültig ist. Zum anderen kann es auch für Session-TANs verwendet werden, die nach dem Login eingegeben werden um den Login zu bestätigen. Hierfür gibt es eine Reihe von Tags um den Ablauf im Frontend darzustellen.

Der Inhalt innerhalb dieses Tags wird ausgegeben, wenn das System die Eingabe einer TAN für die Login Bestätigung erwartet. Das innere des Tags sollte also ein Formular zur Eingabe einer TAN enthalten.

Das Gegenstück zum vorherigen Tag. Der Inhalt wird ausgegeben, wenn nicht die Eingabe einer TAN erwartet wird. In diesem Tag kann sich z.B. das Login Formular befinden.

Beispiel für die beiden Tags:

<ty:siteroles mode="loggedout">
 <ty:tan mode="notanrequest">
  <form action="" method="post"> 
   Email<input type="text" name="login_email" />
   Password<input type="password" name="login_password" />
   <input type="submit" name="login" value="LOGIN"/>
  </form> 
 </ty:tan>
 <ty:tan mode="tanrequest">
  <form action="" method="post">
   Bitte TAN Nr. <ty:tan mode="tanid"/> eingeben
   <input type="text" name="tan" value=""/>
   <input type="submit" name="tanlogin" value="TAN senden"/>
  </form>
 </ty:tan>
</ty:siteroles>

Der Inhalt dieses Tags wird ausgegeben, wenn der Nutzer noch mindestens eine TAN zur Verfügung hat. Mit dem Attribut prelogin kann festgelegt werden, ob sich die Ausgabe auf den aktuellen Nutzer bezieht (in diesem Fall ist prelogin nicht gesetzt oder hat der Wert false), oder auf den Nutzer der sich gerade anmelden möchte (prelogin hat hier den Wert true).

Gegenstück zum vorherigen Tag. Wird ausgegeben wenn der Nutzer keine TAN mehr besitzt. Kann zur Ausgabe einer Warnmeldung beim Login genutzt werden.

Beispiel für beide Tags:

<ty:tan mode="tansleft" prelogin="true">
Bitte geben Sie TAN Nummer <ty:tan mode="tanid"/> ein!
...
</ty:tan>
<ty:tan mode="notansleft" prelogin="true">
Sie besitzen keine TANs mehr, bitte kontaktieren Sie einen Administrator!
</ty:tan>

Wählt eine TAN zur Eingabe aus und liefert die Nummer der ausgewählten TAN zurück. Die ausgewählte TAN bleibt immer gleich, bis der Nutzer sie erfolgreich eingegeben hat. Beispiel siehe vorheriges Tag.

Liefert die Anzahl der noch verfügbaren TANs für den aktuellen Nutzer zurück.

Der Inhalt dieses Tags wird ausgegeben, wenn der bei name angegebene Fehler auftritt. Soll auf alle Fehler reagiert werden, so wird das name Attribut einfach weggelassen.

Gegenstück zum vorherigen Tag.