Product Documentation

This section will guide you through the process of downloading and building SKFS from source.

Prerequisites

  • Apache Maven 3.8.4+.

  • OpenJDK 21 for building the project.

Build Steps

  • Follow the link to clone the latest version of SKFS source (usually on branch master) from SourceForge:

    https://sourceforge.net/p/strongkeyfido/fido2/
    and click "Download Snapshot".

  • Unzip the downloaded snapshot and change directories to the source's server/ directory Example:
    shell> unzip strongkeyfido-fido2-154470980e90934072f1cad48bb221384b56bce5.zip
    shell> cd strongkeyfido-fido2-154470980e90934072f1cad48bb221384b56bce5
    shell> cd server/
  • Build the source from command line by running the command below in the  <path to source>/server directory.
    shell > path-to-maven/bin/mvn clean install 
  • After initiating the clean and install process, the initial build may encounter failure if the two dependencies necessary for building the FIDO server have not been added. These essential maven dependencies can be located within the server/lib folder.
    • replicationEJB-4.14.0.jar
    • replicationWAR-4.14.0.war
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Summary for fidoserver 4.14.0:
    [INFO] 
    [INFO] fidoserver ......................................... SUCCESS [  0.149 s]
    [INFO] crypto ............................................. SUCCESS [  1.635 s]
    [INFO] common ............................................. SUCCESS [  1.077 s]
    [INFO] authenticationBeans ................................ SUCCESS [  0.220 s]
    [INFO] fidoserverbeans .................................... FAILURE [  0.771 s]
    [INFO] keymanager ......................................... SKIPPED
    [INFO] skfs ............................................... SKIPPED
    [INFO] FIDO2Simulator ..................................... SKIPPED
    [INFO] skfsclient ......................................... SKIPPED
    [INFO] skfsadminclient .................................... SKIPPED
    [INFO] FIDO2SSOVerify ..................................... SKIPPED
    [INFO] fidoanalyzer ....................................... SKIPPED
    [INFO] SKFSPolicyManager .................................. SKIPPED
    [INFO] fidoserverEAR ...................................... SKIPPED
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD FAILURE
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  3.957 s
    [INFO] Finished at: 2024-12-05T17:18:29-08:00
    [INFO] ------------------------------------------------------------------------
    [ERROR] Failed to execute goal on project fidoserverbeans: Could not resolve dependencies for project com.strongkey:fidoserverbeans:ejb:4.14.0: The following artifacts could not be resolved: com.strongkey:replicationEJB:jar:4.14.0 (absent): Could not find artifact com.strongkey:replicationEJB:jar:4.14.0 in central (https://repo.maven.apache.org/maven2) -> [Help 1]
  • Add the missing maven dependencies through command line tool:

    How to add Maven Dependencies

  • Once the dependencies have been installed, clean and build the fidoserver project again and it will build successfully.

 

COMMAND LINE OUTPUT

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for fidoserver 4.14.0:
[INFO] 
[INFO] fidoserver ......................................... SUCCESS [  0.175 s]
[INFO] crypto ............................................. SUCCESS [  2.327 s]
[INFO] common ............................................. SUCCESS [  1.122 s]
[INFO] authenticationBeans ................................ SUCCESS [  0.252 s]
[INFO] fidoserverbeans .................................... SUCCESS [  2.331 s]
[INFO] keymanager ......................................... SUCCESS [  0.478 s]
[INFO] skfs ............................................... SUCCESS [  0.641 s]
[INFO] FIDO2Simulator ..................................... SUCCESS [  0.434 s]
[INFO] skfsclient ......................................... SUCCESS [  0.464 s]
[INFO] skfsadminclient .................................... SUCCESS [  0.372 s]
[INFO] FIDO2SSOVerify ..................................... SUCCESS [  0.165 s]
[INFO] fidoanalyzer ....................................... SUCCESS [  0.290 s]
[INFO] SKFSPolicyManager .................................. SUCCESS [  0.194 s]
[INFO] fidoserverEAR ...................................... SUCCESS [  0.365 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  9.730 s
[INFO] Finished at: 2024-12-05T17:14:51-08:00
[INFO] ------------------------------------------------------------------------