de.osci.osci12.extinterfaces.crypto
Class Signer

java.lang.Object
  extended by de.osci.osci12.extinterfaces.crypto.Signer

public abstract class Signer
extends java.lang.Object

Diese abstrakte Klasse stellt die Schnittstelle der Bibliothek für die Anbindung von Signier-Modulen (Crypto-Token) dar. Anwendungen, die OSCI-Nachrichten signieren wollen, müssen an das signierende Rollenobjekt eine Implementation dieser Klasse übergeben.

Copyright © 2010 Freie Hansestadt Bremen

Erstellt von bremen online services Entwicklungs- und Betriebsgesellschaft GmbH & Co. KG

Diese Bibliothek kann von jedermann nach Maßgabe der Bremer Lizenz für freie Softwarebibliotheken genutzt werden.

Die Lizenzbestimmungen können unter der URL www.osci.de abgerufen oder bei der OSCI-Leitstelle, Senator für Finanzen, Freie Hansestadt Bremen, Postfach 10 15 40, 28015 Bremen schriftlich angefordert werden.

Version:
1.5
See Also:
Role.setSignatureAlgorithm(String)

Constructor Summary
Signer()
           
 
Method Summary
abstract  java.lang.String getAlgorithm()
          Diese Methode sollte den Signaturalgorithmus als XML-Identifier zurückgeben, den die Implementierung bei der Erzeugung einer Signatur verwendet.
abstract  java.security.cert.X509Certificate getCertificate()
          Die Implementierung dieser Methode muss das Signaturzertifikat zurückgeben.
abstract  java.lang.String getVendor()
          Sollte den Namen des Herstellers zurückgeben.
abstract  java.lang.String getVersion()
          Liefert die Versionsnummer.
abstract  byte[] sign(byte[] hash, java.lang.String algorithm)
          Die Implementierung dieser Methode muss das übergebene Byte-Array signieren.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Signer

public Signer()
Method Detail

getVersion

public abstract java.lang.String getVersion()
Liefert die Versionsnummer.

Returns:
Versionsnummer

getVendor

public abstract java.lang.String getVendor()
Sollte den Namen des Herstellers zurückgeben.

Returns:
Herstellername

getCertificate

public abstract java.security.cert.X509Certificate getCertificate()
Die Implementierung dieser Methode muss das Signaturzertifikat zurückgeben.

Returns:
Signaturzertifikat

getAlgorithm

public abstract java.lang.String getAlgorithm()
Diese Methode sollte den Signaturalgorithmus als XML-Identifier zurückgeben, den die Implementierung bei der Erzeugung einer Signatur verwendet. Gibt diese Methode null zurück, wird der im DialogHandler gesetzte Default-Algorithmus verwendet.

Returns:
Signaturalgorithmus
See Also:
Constants.SIGNATURE_ALGORITHM_RSA_SHA256, Constants.SIGNATURE_ALGORITHM_RSA_SHA512, Constants.SIGNATURE_ALGORITHM_RSA_RIPEMD160, Constants.SIGNATURE_ALGORITHM_ECDSA_SHA256, Constants.SIGNATURE_ALGORITHM_ECDSA_SHA512, DialogHandler.setSignatureAlgorithm(String)

sign

public abstract byte[] sign(byte[] hash,
                            java.lang.String algorithm)
                     throws java.security.SignatureException,
                            OSCICancelledException
Die Implementierung dieser Methode muss das übergebene Byte-Array signieren. Der algorithm-Parameter hat keine weitere Bedeutung mehr, da ab Version 1.3 die Signer-Implemetierung über die Methode getAlgorithm() den Algorithmus festlegt. Die OSCI-Bibliothek fragt vor dem Aufruf von sign(byte[], String) den Signaturalgorithmus ab und übergibt den String wieder an die sign-Methode.

Parameters:
hash - zu signierendes Byte-Array
algorithm - Signaturalgorithmus
Returns:
Signatur-Wert
Throws:
java.security.SignatureException - wenn beim Erstellen der Signatur ein Fehler auftritt
OSCICancelledException - wenn der Vorgang vom Anwender abgebrochen wird


Copyright © 2010. All Rights Reserved.