File: geier-docs.sgml

package info (click to toggle)
libgeier 0.11-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 2,836 kB
  • ctags: 432
  • sloc: sh: 10,127; ansic: 4,881; xml: 1,346; makefile: 280
file content (55 lines) | stat: -rw-r--r-- 1,943 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
  <bookinfo>
    <title>GEIER Reference Manual</title>
    <releaseinfo>for GEIER &version;</releaseinfo>
  </bookinfo>

  <chapter id="overview">
    <title>GEIER Overview</title>
    <para>
      GEIER is the first free library to encrypt, digitally sign, decrypt,
      validate and send gathered tax declarations data to the
      German inland revenue offices.

      Furthermore it allows to generate XHTML transmission protocols using
      XSLT mechanisms.
    </para>

    <para>
      GEIER is short for <emphasis>GPL'd Elster Interface</emphasis> and
      part of the Taxbird project.
    </para>

    <para>
      GEIER uses the COALA interface supplied by the German inland revenue
      offices.  COALA is a publicly documented transmission interface,
      which heavily relies on XML.  The data is transmitted compressed with
      GZIP and symmetrically encrypted with a 3DES key.  The 3DES key, which
      is generated by the GEIER library, is sent to the Elster servers 
      after it has been asymmetrically encrypted using the RSA algorithm.
      For the actual transmission HTTP/Post is utilized.
    </para>

    <para>
      Besides plain transmission GEIER is capable of digitally signing the
      Elster XML-documents using software certificates (X.509 based).
      The latter approach is called <emphasis>Elster Basis</emphasis> by
      the fiscal authorities.
    </para>

    <para>
      Please mind, that GEIER heavily relies on Mozilla (xulrunner) NSS.
    </para>
  </chapter>

  <chapter id="core">
    <title>GEIER Core API</title>
    <xi:include href="xml/geier.xml"/>
    <xi:include href="xml/geierversion.xml"/>
  </chapter>
</book>