Freja eID Client - Developers' Guide

About Freja eID

Freja eID is an electronic identification (eID) solution that citizens and organisations can use for authentication and signing. The essential part of Freja eID service is a smartphone application used for login and signing to all the services that are connected to the user's eID. The second part is a web portal – My Pages – where the user can control how their eID is to be used and has a full record of user history. 

About this Document

This document describes the client library - Freja eID Client - that simplifies coding against the Freja ID Relying Party API when it comes to using Freja eID Services. Using this library will also make your code more robust, as the library provides error handling, parameter validation and other helpful features.

About the Client Library

Our client library is written in Java programming language. The intended reader of this document is a Java developer aiming to utilise the Freja eID Client for integrating the Relying Party's back-end system with Freja eID’s mobile service. We, therefore, assume a degree of proficiency in object-oriented programming, as well as developing applications using web services and microservices.

You can find the Java source code of our library on GitHub.

Table of Contents

This client library provides a set of classes, interfaces and utility methods designed for implementing the following:

  1. Quick Start Guide

  2. Initialising the Freja eID Client

  3. Authentication

    • initiation of an authentication request

    • fetching a single authentication result based on authentication reference

    • fetching multiple authentication results

    • cancelling authentication requests

  4. Signing

    • initiation of a signature request

    • fetching a single signature result based on signature reference

    • fetching multiple signature results

    • cancelling signature requests

  5. Organisation ID

    • adding an organisation identifier for a user

    • deleting an organisation identifier for a user

    • fetching the result of adding an organisation identifier for a user

    • cancelling adding the organisation identifier for a user

    • updating additional attributes for an issued organisation ID

  6. Custodianship

    • Fetch user custodianship status

  7. Custom Identifier Management

    • setting a custom identifier for a user

    • deleting a custom identifier

  8. Error Handling

  9. Additional Information for Integrators/Integrated Relying Parties

Changelog

Document Version

Client Library Version

Date

Notes

Document Version

Client Library Version

Date

Notes

2.21.0

2.21.0

2024-02-19

Added DOCUMENT_PHOTO as attributeToReturn and requestedAttributes parameter in Authentication and Signature Service Client.

2.20.0

2.20.1

2023-12-15

Added a new method allowing you to update additional attributes for users who have been assigned an Organisation ID.

2.19.0

2.19.0

2023-12-05

Supported userConfirmationMethod.

2.18

2.18.0

2023-05-10

Added Custodianship Client and new method to retrieve user custodianship status.

2.17

2.17.0

2023-02-06

Added support for generating authentication QR Codes to the Authentication Client.

2.16

2.16.0

2022-10-27

Supported XML_MINAMEDDELANDEN advanced signature type.

2.15

2.15.0

2022-10-10

Supported INFERRED user info type for SIGN transactions.

2.14

2.14.0

2022-09-15

Supported identifierDisplayTypes and additionalAttributes to initiateAddOrganisationId request and additionalAttributes as a part of ORGANISATION_ID attribute.

2.13

2.13.1

2022-04-29

Added ORGANISATION_ID as attributeToReturn and requestedAttributes parameter in Authentication and Signature Service Client.

2.12

2.12

2021-12-20

Added DOCUMENT as attributeToReturn and requestAttributes parameter in Authentication and Signature Service Client.

2.11

2.11

2021-10-21

Added PHOTO as attributeToReturn and requestAttributes parameter in Authentication and Signature Service Client.

2.10

2.10.0

2021-08-31

Supported ANY parameter for orgIdIssuer.

2.9

2.9.3

2021-06-04

Added COVID_CERTIFICATES as  attributeToReturn and requestAttributes parameter in Authentication and Signature Service Client.

2.8

2.8

2021-02-12

Added AGE as attributeToReturn and requestAttributes parameter in Authentication and Signature Service Client.

2.7

2.7

2020-12-21

Added REGISTRATION_LEVEL as attributeToReturn and requestAttributes parameter in Authentication and Signature Service Client.

2.6

2.6

2020-10-27

Added ALL_PHONE_NUMBERS as attributeToReturn and requestAttributes parameter in Authentication and Signature Service Client.

2.5

2.5

2020-08-04

Increased default polling timeout for Signature and Organisation ID client to 1min.

2.4

2.4

2020-07-20

Added a new method allowing you to fetch all users who have been assigned an Organisation ID.

2.3

2.3

2020-06-24

Provided logger with slf4j library/fasade.

2.2

2.2

2020-05-07

Added ALL_EMAIL_ADDRESSES as attributeToReturn and requestedAttributes parameter in Authentication and Signature Service Client.

2.1

2.1

2020-04-02

Added ADDRESSES as attributesToReturn and requestedAttributes parameter in Authentication and Signature Service Client.

2.0

2.0

2020-01-22

Added Initialising Freja eID Client.

1.0

1.0

2019-12-27

This document is a preliminary version. The content of this document is still under review and subject to change.