FDSM library

Swiss Army Knife for working with Fidesmo devices and Fidesmo API

License	MIT
Categories	IDE Development Tools
GroupId	com.fidesmo
ArtifactId	fdsm
Last Version	21.04.06
Release Date	Apr 6, 2021
Type	jar
Description	FDSM library Swiss Army Knife for working with Fidesmo devices and Fidesmo API
Project URL	https://developer.fidesmo.com/fdsm

Download fdsm

Filename	Size
fdsm-21.04.06.pom
fdsm-21.04.06.jar	53 KB
fdsm-21.04.06-sources.jar	31 KB
fdsm-21.04.06-javadoc.jar	85 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.fidesmo/fdsm/ -->
<dependency>
    <groupId>com.fidesmo</groupId>
    <artifactId>fdsm</artifactId>
    <version>21.04.06</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.fidesmo/fdsm/
implementation 'com.fidesmo:fdsm:21.04.06'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.fidesmo/fdsm/
implementation ("com.fidesmo:fdsm:21.04.06")

Apache Buildr

'com.fidesmo:fdsm:jar:21.04.06'

Apache Ivy

<dependency org="com.fidesmo" name="fdsm" rev="21.04.06">
  <artifact name="fdsm" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.fidesmo', module='fdsm', version='21.04.06')
)

Scala SBT

libraryDependencies += "com.fidesmo" % "fdsm" % "21.04.06"

Leiningen

[com.fidesmo/fdsm "21.04.06"]

Dependencies

compile (8)

Group / Artifact	Type	Version
com.github.martinpaljak : capfile	jar	21.04.05
com.github.martinpaljak : apdu4j-core	jar	2020r3
org.apache.httpcomponents : httpclient	jar	4.5.13
org.java-websocket : Java-WebSocket	jar	1.5.1
com.fasterxml.jackson.core : jackson-databind	jar	2.12.2
commons-io : commons-io	jar	2.8.0
org.slf4j : slf4j-api	jar	1.7.30
com.payneteasy : ber-tlv	jar	1.0-11

test (2)

Group / Artifact	Type	Version
org.testng : testng	jar	7.4.0
org.slf4j : slf4j-simple	jar	1.7.30

Project Modules

There are no modules declared in this project.

FiDeSMo Utility ·

FDSM is the developer's Swiss Army Knife for working with a Fidesmo device and the Fidesmo API. It supersedes gradle-fidesmo for interacting with the Fidesmo API and provides an alternative to Fidesmo Android app when delivering services to a device via a PC/SC reader (contact or contactless). All from the command line.

Getting started

You will need the following:

• Latest Java 11 for running the app
• a Fidesmo Developer account for your $FIDESMO_AUTH (appId:appKey)
• a Fidesmo device (get one from the shop)
• a PC/SC NFC reader (unless your developer device is the Yubikey NEO with Fidesmo)

Grab a copy of fdsm.jar (or fdsm.exe wrapper for Windows) from the release area. It is an executable JAR file, so start by running

java -jar fdsm.jar -h

or fdsm.exe -h on Windows. With Linux or macOS, it is recommended to add a handy alias to your ~/.bashrc or ~/.profile (assuming ~/Downloads is where you saved fdsm.jar):

alias fdsm="java -jar ~/Downloads/fdsm.jar"

HOWTO

FDSM should be easy to use for JavaCard developers with some knowledge of the Fidesmo API. We will cover the full development cycle with the following HOWTO-s

1. Develop and build your JavaCard applet with ant-javacard
2. Test your applet on a Fidesmo device with fdsm
3. Manage your application and associated applets in the Fidesmo API with fdsm

Support

• please open a new issue on Github if you find a mistake in code or documentation
• for general support, please contact Fidesmo support via [email protected]

License and development

FDSM is open source software, developed by Fidesmo AB and licensed under MIT license. Pull requests are most welcome, please refer to CONTRIBUTING.md.

To contribute you will need Apache Maven to build and test the software, but a wrapper to download the right version is included.

To produce a build, execute ./mvnw package and use the generated target/fdsm.jar.

Environment variables

fdsm is a command line application and takes most of its input from command line arguments but some behavior can be tuned by setting environment variables.

• FIDESMO_AUTH - the app ID and app key from developer portal in appId:appKey format, equivalent of using --auth appId:appKey
• FIDESMO_API_URL - the URL of the the Fidesmo backend (do not change if unsure)

Fidesmo

Versions

Version
21.04.06 Apr 6, 2021
20.01.09 Jan 9, 2020
19.09.16 Sep 16, 2019
19.04.11 Apr 11, 2019
19.03.29 Mar 29, 2019
19.02.22 Mar 5, 2019
19.01.31 Jan 31, 2019
18.10.01 Oct 2, 2018
18.08.22 Aug 27, 2018