Laden sie das Java-API Zip-Archiv herunter und entpacken es. Die beiden JARs müssen ihrem Java-Projekt hinzugefügt werden.
In Eclipse z.B. über Einstellungen > Java > Build Path > User Libraries oder Sie legen die beiden JARs in das entsprechende Verzeichnis Ihres Java-Projekts. Eclipse erkennt dies automatisch und bindet die JARs ein.
Bei Application-Servern kommt es dagegen darauf an, wie die zugrunde liegende Struktur auszusehen hat. Bei Oracle Glassfish z.B. müssten die JARs in ein WAR gewandelt und anschließend deployed werden.

In den entsprechenden Klassen ihres Projektes importieren sie die benötigten Klassen aus dem Package ‚com.secsign.secsignid‘:

import com.secsign.secsignid.SecSignIDApi;
import com.secsign.secsignid.AuthenticationSession;
import com.secsign.secsignid.AuthenticationSessionState;
import com.secsign.secsignid.SecSignIDException;

Übersicht über die Struktur des Java-API Zip-Archivs:

README.md
secsign_logo.png
developer/
lib/SecPKIApi.jar
lib/SecSignIDApi.jar
lib/secpki.properties
lib/secsign.com-wildcard-rapidSSL-2014-09-29.der
src/com/secsign/secsignid/AuthenticationSession.java
src/com/secsign/secsignid/AuthenticationSessionState.java
src/com/secsign/secsignid/SecSignIDApi.java
src/com/secsign/secsignid/SecSignIDException.java
src/com/secsign/secsignid/example/SecSignIDApiJavaSwingExample.java

Um nun einen Nutzer mittels seiner SecSign ID in der Web-Anwendung oder einem Content-Management-System (CMS) anmelden zu können, fordert man beim SecSign ID Server eine sogenannte Authentifizierungs-Session an. Kurz: AuthSession.
Die AuthSession kann dann vom Nutzer auf seinem Smartphone akzeptiert werden, so dass der Nutzer anschließend im System angemeldet werden kann.
Zum Anfordern einer AuthSession nutzt man die Methode ‚SecSignIDApi.requestAuthenticationSession‘

// create the SecSignID-API instance which can send requests to the SecSignID server
SecSignIDApi secSignIdApi = new SecSignIDApi();
String secSignID = secSignIdTextField.getText();
AuthenticationSession authSession = null;
try
{
	authSession = secSignIdApi.requestAuthenticationSession(secSignID,
		"SecSignID Java integration example",
		"www.example.com",
		"127.0.0.1");
}
catch (SecSignIDException exception)
{
	exception.printStackTrace();
	JOptionPane.showMessageDialog(null, exception.getLocalizedMessage());
}

Als Rückgabewert erhält man ein Objekt vom Typ ‚AuthenticationSession‘. Die Klasse hält alle Informationen über die AuthSession wie SecSign ID, AuthSession ID, den Access Pass als PNG-Grafik und die gemachten Informationen beim Anmelden.
Die Methode ‚SecSignIDApi.requestAuthenticationSession‘ erhält als Parameter die SecSign ID, die angemeldet werden soll, daneben einen Namen der Web-Application, im Beispiel ‚SecSignID Java integration example‘ als auch eine URL.
Der gewählte Name der Web-Application wird dem Nutzer in der Push-Notification auf seinem Smartphone angezeigt. Die URL wird dagegen dem Nutzer beim der Auswahl des richtigen Access-Pass ausgewählt.

Swing Anwendung

Im Beispiel existiert in der Swing-Anwendung ein Label namens ‚accessPassImage‘. Auf diesem Label wird der erhaltene Access-Pass angezeigt, in dem das Byte-Array in eine ImageIcon-Instanz geladen wird.

/**The label to show the logo and access pass**/
private JLabel accessPassImage;
//etc.
if (authSession != null){
    // Show the Access Pass
    final byte[] passIcon = session.getAuthSessionIconData();
    javax.swing.SwingUtilities.invokeLater(new Runnable() {
        public void run() {
            accessPassImage.setIcon(new ImageIcon(passIcon));
        }
    });
}

JSF-Anwendung

In einer Java-Server-Faces-Webanwendung werden Daten üblicherweise in HTML-Pattern geschrieben, die dann an den Browser geschickt werden.
In der XHTML-Vorlage kann zum Beispiel Objekt und Klassenvariable eingebettet werden über:

#{secsignid.iconData}

Sobald die Vorlage gerendert wird, wird versucht ein Objekt ’secsignid‘ zu finden, das über Getter- und Setter-Methoden verfügt für eine Variable ‚iconData‘:

/**
 * The iconData of the access pass
 */
private String iconData;
try
{
	AuthenticationSession authSession = secSignIdApi.requestAuthenticationSession(secSignID,
		"SecSignID Java integration example",
		"www.example.com",
		"127.0.0.1");
	sessionID = authSession.getAuthSessionID();
	// this field is read when the xhtm pattern is rendered and the value is inserted at: #{secsignid.iconData}
	iconData = new BASE64Encoder().encode(authSession.getAuthSessionIconData());
	log.log(Level.INFO,"Received the authentication session with ID '" + sessionID + "' for SecSignID user ID '" + userId + "'.");
	return "accesspass?faces-redirect=true"; // go to the page showing the access pass and update the displayed URL in the browser
}
catch(SecSignIDException exception)
{
	log.log(Level.SEVERE, "Error when requesting an authentication session for SecSignID '" + secSignID + "'", ex);
}

Die vom ID-Server angeforderte AuthSession kann verschiedene Zustände haben. Zum Abfragen, ob der Nutzer die AuthSession akzeptiert oder abgelehnt hat, oder ob eventuell die Session abgelaufen ist, kann die API-Methode ‚SecSignIDApi.getAuthenticationSessionState‘ genutzt werden:

// Get the State
AuthenticationSessionState state = null;
try
{
	state = secSignIdApi.getAuthenticationSessionState();
}
catch (SecSignIDException exception)
{
	exception.printStackTrace();
}

Auf das Akzeptieren (‚AUTHENTICATED‘) oder Ablehnen (‚DENIED‘) der Sitzung durch den Nutzer muss reagiert werden. Die Sitzung kann entweder akzeptiert, abgelehnt oder im Schwebezustand (‚PENDING‘) oder (‚FETCHED‘) sein. Der Status kann mit den Konstanten aus der Klasse ‚AuthenticationSessionState‘ verglichen werden. Ist die Sitzung vom Nutzer akzeptiert worden, kann er im darunter liegenden System oder der Web-Anwendung angemeldet werden.

switch (state.getAuthSessionState()) {
	case AuthenticationSessionState.FETCHED:
	case AuthenticationSessionState.PENDING:
	{
		msg = "The session is still pending. Please accept the session in the SecSignApp on your smart phone.";
		break;
	}
	case AuthenticationSessionState.DENIED:
	{
		msg = "The session has been denied on the smart phone.";
		checkForState = false;
		break;
	}
	case AuthenticationSessionState.AUTHENTICATED:
	{
		try
		{
			secSignIdApi.releaseAuthenticationSession();
		} catch (SecSignIDException exception)
		{
			exception.printStackTrace();
		}
		msg = "Successfully Authenticated SecSign ID ""+state.getAuthenticatedSecSignId()+""";
		checkForState = false;
		break;
	}
//etc.
}

Wünscht der Nutzer, den gesamten Anmeldeprozess abzubrechen oder wünscht es allgemein der Client, wird hier zu die Methode ‚SecSignIDApi.cancelAuthenticationSession‘ genutzt. Anschließend kann mit der gleichen SecSignID API-Instanz erneut eine Anmeldung durchgeführt werden.

try
{
	secSignIdApi.cancelAuthenticationSession();
}
catch (SecSignIDException exception)
{
	exception.printStackTrace();
}

SECSIGN API Klassen

Im Zip-Archiv findet sich im Unterverzeichnis ‚developer‘ das JavaDoc zu den SecSign ID Java API Klassen.

Constructor und Beschreibung

• SecSignIDApi() – Constructor of the SecSign ID API bean
• SecSignIDApi(java.lang.String idServer, int idServerPort)
• requestAuthenticationSession(java.lang.String secSignID, java.lang.String serviceInfo, java.lang.String serviceAddress)
• getAuthenticationSessionState()
• cancelAuthenticationSession()
• releaseAuthenticationSession()

SECSIGN AUTHENTICATION SESSION

• byte[] getAuthSessionIconData()
• long getAuthSessionID()
• java.lang.String getRequestingServiceAddress()
• java.lang.String getRequestingServiceName()
• java.lang.String getSecSignID()
• void setAuthSessionIconData(byte[] authSessionIconData)
• void setAuthSessionID(long authSessionId)
• void setRequestingServiceAddress(java.lang.String requestingServiceAddress)
• void setRequestingServiceName(java.lang.String requestingServiceName)
• void setSecSignID(java.lang.String secSignId)

Wir haben eine stetig wachsende Liste an APIs und Plugins um die SecSign ID Zwei-Faktor Authentifizierung einfach und schnell in jedes Projekt zu integrieren.
Wir bieten nicht nur APIs in zahlreichen Programmiersprachen, sondern auch Plugins für CMS, Server und VPN Umgebungen, oAuth2 und zahlreiche mehr. Die Plugins nutzen unsere APIs und bieten zusätzliche Funktionen, zum Beispiel Nutzer Management, einfache und native Installation, Logging oder die Integration in Firewalls oder Active Directories.

Das JIRA Plugin beispielsweise nutzt die JAVA-API. Die PHP-API und JS-API wird von WordPress, Joomla, Drupal, Typo3 und vielen anderen genutzt. Die ASP.net/C#-API wird für die Windows und Cisco VPN genutzt und die C-API findet Verwendung um Unix SSH Services zu schützen. Die Objective-C API wird für unsere AppleTV und iPhone und iPad Apps genutzt.

Sie können die SecSign ID Zwei-Faktor Authentifizierung und den Zwei-Faktor Login durch eine einfach Integration des Plugins in Ihre Website oder Ihre Testumgebung kennenlernen. Oder testen Sie den Login auf unserer Website, ohne sich vorher zu registrieren. Sie haben bereits eine SecSign ID oder hätten gerne eine? Loggen Sie sich jetzt ein und nutzen Sie das Portal oder registrieren Sie sich ganz unkompliziert.

Erfahren Sie selbst, wie schnell und unkompliziert der Login Prozess mit der Challenge-Response Authentifizierung mit 2048-bit Schlüsselpaaren ist. Sie brauchen keine Passwörter, und es werden keine vertraulichen Logindaten übertragen. Einfache Integration und unkomplizierte Nutzung.

Für mehr Informationen zum patentierten SafeKey Verfahren finden Sie hier.

Falls Sie eine API für eine Programmiersprache vermissen kontaktieren Sie uns unverbindlich. Falls Sie Hilfe mit der Integration in ein existierendes System brauchen oder kein passendes Plugin für Ihr Content Management System finden, kontaktieren Sie unser Support Team und wir helfen Ihnen gerne weiter.