Websteuer::Base Perl-Modul

Allgemeine Funktionsweise

Das Modul umfasst alle Kernfunktionen zum erstellen, prüfen und versenden von Anmeldesteuern mit Elster/Coala. Hinweis: der JavaKern wird weiterhin benötigt.

Hinweise:

• Flexibilität: Beliebige Anbindungen sind erstellbar (GUI, Shell, Datenbankanbindung)
• HerstellerID: Die Beantragung einer eigenen HerstellerID für eigene Entwicklungen wird nötig. Im Paket enthalten ist eine Test-ID, die aber nicht für offizielle Einträge freigeschalten ist.

JavaKlassen, Anbindungen an andere Systeme oder GUI sind derzeit nicht enthalten.

Funktionen

Vorgehensweisen

Funktionen

check_antrag
Antrag auf formelle Korrektheit prüfen

Beispiel:

use strict;
use Websteuer::Base;

my $antrag = {
               'type' => 'ustva',
               'data' => {
                              'kz83' => 12.34,
                            }
             };

my %erg = check_antrag($antrag);

if ( $erg{'errorcode'} )
{
    print STDERR 'Fehler: ('.$erg{'errorcode'}.') - '.$erg{'errormsg'}."\n";
    exit 1;
}

decrypt
Daten entschlüsseln

Beispiel:

use strict;
use Websteuer::Base;

my $datei = /tmp/decrypt.me;
my $key = 'foobar';
my %decrypt = decrypt($datei, $key);

print <<EOF;
 Dateien: $datei
   ERROR: $decrypt{'errorcode'}
errormsg: $decrypt{'errormsg'}
 crypted:
      $decrypt{'daten'}
EOF

encrypt
Daten verschlüsseln

Beispiel:

use strict;
use Websteuer::Base;

my $datei = '/tmp/encrypt.me';
my $key = 'foobar';
my %encrypt = encrypt($datei, $key);

print <<EOF;
 Dateien: $datei
   ERROR: $encrypt{'errorcode'}
errormsg: $encrypt{'errormsg'}
 crypted:
$encrypt{'daten'}
EOF

gen_antrag
XML-Antrag zum Einpacken und verschicken generieren

Beispiel:

use strict;
use Websteuer::Base;

my $antrag = {
               'type' => 'ustva',
               'data' => {
                              'kz83' => 12.34,
                            }
             };

my %erg = gen_antrag($antrag);

get_user_permission
Eingetragene Permissions eines bestimmten Users einlesen

Beispiel:

use strict;
use Websteuer::Base;

my $user = 'joetester'
my %erg = get_user_permission($user);

init_antrag
blanken Antrag (mit defaulteintragungen) erstellen.
Notiz: vorhandene Daten werden derzeit gnadenlos entsorgt.

Beispiel:

use strict;
use Websteuer::Base;

my %erg = init_antrag($type);

make_md5_hash
MD5 Hash über eine anzugebende Anzahl Dateien erstellen

Beispiel:

use strict;
use Websteuer::Base;

my @dateien = @ARGV;
if ( $#ARGV < 0 )
{ @dateien = ('Websteuer/Base.pm'); }

my %md5_hash = make_md5_hash(@dateien);

print <<EOF;
 RESULT
 Dateien: @dateien
 hashkey: $md5_hash{'key'}
   ERROR: $md5_hash{'errorcode'}
errormsg: $md5_hash{'errormsg'}
EOF

normalize_data
Daten bereinigen
Ganze Zahlen in ganze Zahlen umrechnen, Zahlen mit Nachkommastellen auf 2 Nachkommastellen zurechtstutzen. Alles numerisch (int, float %1.2f).
Beispiel:

use strict;
use Websteuer::Base;

my %erg = normalize_data($antrag);

parse_herstellerID
HerstellerID holen

Beispiel:

use strict;
use Websteuer::Base;

my %datenfeld = parse_herstellerID($data);

read_antrag
gespeicherte Antragsdaten lesen und im ArbeitsHash ablegen

Beispiel:

use strict;
use Websteuer::Base;

my %erg = read_antrag(\%data);

read_user_config
Benutzerspezifische Configuration einlesen

Beispiel:

use strict;
use Websteuer::Base;

send_antrag
Antrag abschicken

Beispiel:

use strict;
use Websteuer::Base;

# not implemented

sign_data
Signatur über Datenblock erstellen

Beispiel:

use strict;
use Websteuer::Base;

my %sign_data = sign_data($data, $privKey);

verify_signature
gelesene Signatur, bzw. erstellte Signatur verifizieren

Beispiel:

use strict;
use Websteuer::Base;

my %sign_data = sign_data($data1, 'XXX');
my %verify_sig = verify_signature($data2, 'XXX', $sign_data{'signature'});

Vorgehensweisen

HerstellerID entschlüsseln

1. md5 hashkey base64 der entsprechenden Files
2. als Schlüssel für TrippleDES Entschlüsselung verwenden
3. Ergebnis-Datei hat Format:
   HerstellerID: <ID>
   Version: <Versionsnummer>
   Hersteller: NekoSoft Simone Demmel
   Key: <verwendeter Schluessel>
   Product: <Produktname>
   ENDE
   
   
4. bei Bedarf/Verdacht die Signatur (gegen den pub.Key) pruefen

HerstellerID verschlüsseln

1. md5 hashkey base64 der entsprechenden Files
2. Datei erstellen im Format: HerstellerID: <ID>
   Version: <Versionsnummer>
   Hersteller: NekoSoft Simone Demmel
   Key: <verwendeter Schluessel>
   Product: <Produktname>
   ENDE
   
3. RSA Signatur über die Datei mit priv.Key erstellen und hinten anhängen
4. MD5Hashkey als Schlüssel für TrippleDES Verschlüsselung verwenden