AuthComponent/VerifyInfoboxes
Ab Version 1.4 bietet MOA-ID die Möglichkeit einer erweiterten Infobox-Validierung, das heißt, es können neben der Personenbindung auch weitere ausgelesene Infoboxen validiert werden. Die für die Validierung der Infoboxen notwendigen Parameter können über die Konfigurationsdatei durch das VerifyInfoboxes Element sowohl global als auch lokal je Online-Applikation gesetzt werden. MOA-ID übergibt diese Parameter der Applikation, die für die Verifikation des Inhaltes der jeweilgen von der BKU übermittelten Infobox verantwortlich ist. Im Folgenden wird eine derartige Applikation als Prüfapplikation bezeichnet.
Das Verifyinfoboxes Element ist optional und kann fehlen, wenn keine Infoboxen außer der der Personenbindung validiert werden müssen.
Das VerifyInfoboxes-Element hat folgende Kind-Elemente:

• DefaultTrustProfile: Dieses optionale Element kann nur einmal vorkommen und spezifiziert ein Trust-Profil, das von einer Prüfapplikation zur Validierung einer Infobox herangezogen werden kann, wenn für diese Infobox kein eigenes Trust-Profil gesetzt wurde. Es hat genau ein Kindelement namens TrustProfileID, das die ID eines in MOA-SP konfigurierten Trust-Profiles enthält.
  Anmerkung: Das Trust-Profil für die Personenbindung darf nicht zur Validierung anderer Infoboxen verwendet werden. Das Trust-Profil für die Bürgerkarte soll nur dann zur Validierung anderer Infoboxen verwendet werden, wenn die zur Verifikation der Zertifikate benötigten Wurzelzertifikate bereits im entsprechenden Trust-Store enthalten sind. (vgl. MOA-ID Spezifikation, Abschnitt 4.6).
• Infobox: Dieses Element kann beliebig oft vorkommen und kapselt die Parameter, die für die Validierung einer Infobox an die jeweilige Prüfapplikation übergeben werden.
  Das Infobox-Element hat folgende Attribute:
  • Identifier: Dieses Attribut muss vorhanden sein und gibt den Namen der Infobox an. Er muss dabei exakt dem Bezeichner der jeweiligen zu validierenden Infobox aus der BKU entsprechen, also zum Beispiel Mandates für die Vollmachten-Infobox oder EHSPToken für die GDAToken-Infobox.
    
  • required: Dieses Attribut vom Typ boolean bestimmt, ob MOA-ID den Inhalt der entsprechenden Infobox für die Anmeldung zwingend benötigt. Ist es auf true gesetzt, und wird der entsprechende Infobox-Inhalt nicht von der BKU übermittelt, so bricht MOA-ID den Anmeldevorgang mit einer Fehlermeldung ab.
    Fehlt dieses Attribut, so wird als Defaultwert false gesetzt.
    
  • provideStammzahl: Dieses Attribut vom Typ boolean bestimmt, ob die Prüfapplikation die Stammzahl aus der Personenbindung erhalten darf. Fehlt dieses Attribut, so wird als Defaultwert false gesetzt.
    Anmerkung: Das Attribut steht in keinem Zusammenhang zum gleichnamigen Attribut OnlineApplication/AuthComponent/@provideStammzahl, das angibt ob die Stammzahl an die Online-Applikation weitergegeben werden darf.
  • provideIdentityLink: Dieses Attribut vom Typ boolean bestimmt, ob die Prüfapplikation die Personenbindung erhalten soll. Hat es den Wert true, so wird ein Klone des Wurzel-Elements der Personenbindung an die Prüfapplikation übergeben, wobei zu beachten ist, dass die darin enthaltene Stammzahl auf einen leeren String gesetzt wird, falls das Attribut provideStammzahl auf false gesetzt ist. Fehlt das provideIdentityLink-Attribut, so wird als Defaultwert false gesetzt.
    Anmerkung 1: Das Attribut steht in keinem Zusammenhang zum gleichnamigen Attribut OnlineApplication/AuthComponent/@provideIdentityLink, das angibt ob die Online-Applikation die Personenbindung erhalten soll.
    Anmerkung 2: Der Prüfapplikation werden defaultmäßig der Vorname, der Familienname, das Geburtsdatum, der Typ der Stammzahl, die Stammzahl (konfigurierbar) und die öffentlichen Schlüssel aus der Personenbindung übergeben. Das Attribut provideIdentityLink sollte deshalb wirklich nur dann auf true gesetzt werden, wenn von der Prüfapplikation noch andere Daten aus der Personenbindung benötigt werden.
  Das Infobox-Element hat folgende Kind-Elemente:
  • FriendlyName: Das Element ist optional und enthält einen Namen, der von MOA-ID zur Anzeige von, die jeweilige Infobox betreffende, Fehlermeldungen im Browser verwendet wird. Im Regelfall wird man hier den deutschen Namen der Infobox setzen, also z.B. Vollmachten oder Stellvertretungen für die Mandates-Infobox oder GDAToken für die EHSPToken-Infobox.
    Fehlt dieses Element, so wird für Fehlermeldungen der Wert des Identifier-Attributes verwendet.
  • TrustProfileID: Das Element ist optional und bezeichnet ein in MOA-SP konfiguriertes Trust-Profil, das von MOA-ID für die Validierung der Infobox verwendet wird. Dabei ist wieder zu beachten, dass das Trust-Profil für die Personenbindung nicht zur Validierung anderer Infoboxen verwendet werden darf, und das Trust-Profil für die Bürgerkarte nur dann zur Validierung anderer Infoboxen verwendet werden soll, wenn die zur Verifikation der Zertifikate benötigten Wurzelzertifikate bereits im entsprechenden Trust-Store enthalten sind. (vgl. MOA-ID Spezifikation, Abschnitt 4.6).
    Fehlt dieses Element, so wird das Default-Trust-Profil verwendet. Ist dieses auch nicht konfiguriert, so wird für die Validierung der entsprechenden Infobox keine Zertifikatsprüfung notwendig sein.
  • ValidatorClass: Das Element ist optional und bezeichnet den Namen der Klasse (voller Package-Name), die von MOA-ID zur Validierung der Infobox geladen werden soll. Fehlt dieses Element, so wird MOA-ID versuchen, eine Default-Klasse zu laden, deren Namen aus dem Identifier-Attribut der Infobox abgeleitet wird (vgl. MOA-ID-Spezifikation, Abschnitt 4.7.2.3, Zuordnung eines InfoboxReadResponse zu einer implementierenden Klasse).
    Anmerkung: Im Regelfall wird dieses Element fehlen, da bei der Entwicklung einer Infobox-Prüfapplikation der Default-Klassennamen verwendet werden sollte. Nur wenn es verschiedene Prüfapplikationen für eine Infobox gibt, wird man das ValidatorClass verwenden, um eine andere als die Default-Applikation zu laden.
  • SchemaLocations: Das Element ist optional und referenziert XML-Schemas, die von der Prüfapplikation zum validierenden Parsen von Infoboxen verwendet werden können. Das Element hat beliebig viele Schema-Kindelemente, dessen Attribute namespace und schemaLocation jeweils die Namespace-URI und den Ort (URI) des entsprechenden Schemas bezeichnen. Relative URIs im schemaLocation-Attribut sind dabei relativ zum Verzeichnis der MOA-ID-Konfigurationsdatei zu interpretieren.
    Beispiel:
    

        <SchemaLocations>
          <Schema namespace="http://ns1.ns1" schemaLocation="schemas/ns1.xsd"/>
          <Schema namespace="http://ns2.ns2" schemaLocation="schemas/ns2.xsd"/>
        </SchemaLocations>
                                  

    Weitere Möglichkeiten zur Übergabe von XML-Schemas an die Prüfapplikation können in der MOA-ID-Spezifikation im Abschnitt 4.7.2, Erweiterte Infoboxüberprüfung, nachgelesen werden.
  • ApplicationSpecificParameters: Das Element ist optional und nimmt Infobox-kontext-spezifische Parameter auf.
    Da MOA-ID die zusätzlichen zur Personenbindung abgefragten Infoboxen (bzw. deren Inhalte) nicht a priori kennt, ist es unmöglich vorherzusehen, welche Parameter eine Prüfapplikation zum Validieren einer Infobox benötigt. Die Konfiguration sieht daher das Element ApplicationSpecificParameters vor, um einer bestimmten Prüfapplikation kontext spezifische Parameter zu übermitteln. Dieses Element wird vollständig an die Prüfapplikation weitergegeben, und es obliegt der Prüfapplikation die Kindelemente des ApplicationSpecificParameters-Element zu extrahieren und zu interpretieren.
    Beispiel:
    

        <ApplicationSpecificParameters>
          <Parameter1>content1</Parameter1>
          <Parameter2>content2</Parameter2>
          <Parameter3>
            <Parameter3a>content3a</Parameter3a>
            <Parameter3b>content3b</Parameter3b>
          </Parameter3>
        </ApplicationSpecificParameters>
                                  

Eine Beispielkonfiguration finden sie am Ende das Abschnitts OnlineApplication/AuthComponent/VerifyInfoboxes.

AuthComponent/ForeignIdentities
Ab Version 1.4.7 bietet MOA-ID die Möglichkeit der Nutzung von ausländischen Karten. Hierfür ist ein Stammzahlenregister-Gateway nötig, dass einen entsprechenden Zugang zum Stammzahlenregister bereitstellt. Es ist hierzu ein ensprechenden ConnectionParameter zu definieren, der die Zugangsdaten zum Gateway bereithält (siehe ConnectionParameter). In der Default-Konfiguration ist der Zugang zum Stammzahlenregister-Gateway bereits aktiviert. Es muss nur noch das Client-Zertifikat für die SSL-Verbinung zum Gateway angegeben werden. Voraussetzung dafür ist ein Zertifikat von A-Trust bzw. A-CERT mit Verwaltungseigenschaft. Wenn ihr MOA-ID Zertifikat diese Voraussetzung erfüllt, können Sie dieses hier angeben.

ProxyComponent
ProxyComponent enthält Parameter, die nur die MOA-ID Proxykomponente betreffen. Das Element ist optional und muss nicht verwendet werden, wenn auf dem Server keine MOA-ID Proxykomponente installiert wird.

Das Element ProxyComponent hat nur das Kind-Element AuthComponent, das die Verbindung zur Authentisierungs-komponente beschreibt.

Baut die Proxykomponente die Verbindung zur Authentisierungs-komponente über ein Webservice auf, dann muss das Element ConnectionParameter spezifiziert werden.

Baut die Proxykomponente die Verbindung zur Authentisierungs-komponente über das API auf, dann wird das Element ConnectionParameter nicht spezifiziert.