DEVELOPERS’ SECTION

If you are curious about our API or you are a partner wishing to integrate with us, this is the place to be.

Below you will find the documentation and other resources that you need to be up and running in no time.

GET STARTED

You can integrate with Freja eID via:

To obtain client test certificates for accessing the test environment, please send an e-mail to onboarding@frejaeid.com with the following information:

Organisation name
Address
Organisation registration no.
Contact details of your technical representative (name, e-mail & phone)

If you have any other questions about integration, please contact partnersupport@frejaeid.com.

Below you will also find the Testing Instructions if you would like to test the Freja eID mobile app yourself, and our Welcome Pack.

Test Instructions

Welcome Pack

OPENID CONNECT INTEGRATION

OpenID Connect is a well established authentication and authorization technology that is based on the OAuth2 protocol.

We have a general integration guide on how to set it up, a specific guide on how to configure it on your WordPress website, as well as an Okta integration guide.

General Guide
WordPress Integration Guide
Okta Integration Guide
Login Button Generator

REST API INTEGRATION

If you would like to integrate via our REST API, we have an in-depth REST API reference guide, as well as a Java Client library.

Rest API Guide
Client Library
Client Library on Github
Design Recommendations

MICROSOFT AZURE IdP INTEGRATION

Freja eID is integrated with cloud services like Microsoft’s Office 365 and Azure.

Integration Guide

DEVELOPER FAQ

In the following section, you will find troubleshooting for some different scenarios you might encounter during the integration.

I AM UNABLE TO ESTABLISH THE SSL CONNECTION AGAINST FREJA eID TEST OR PRODUCTION ENVIRONMENT

Freja eID services require the SSL connection with both client and server SSL certificate verification. To establish the SSL connection, both client and server SSL certificate need to be configured in your application truststore/keystore. Contact our support to check that you have received proper client and server SSL certificates.

ERRORS IN THE FREJA eID MOBILE APPLICATION

Contact Freja eID support and provide them with the error code displayed in the Freja eID application.

THE SERVER RETURNS ERROR 404 (RESOURCE NOT FOUND)

Check the service URL you are using. The service URLs for all Freja eID services are documented in Freja eID Relying Party Developers’ Documentation under corresponding sections (refer to sections dedicated to Authentication services, Signature services or Custom identifier management respectively). If this doesn’t resolve your problem, contact Freja eID support.

I DON’T HAVE THE REQUIRED DOCUMENT/PERSONNUMMER TO TEST WITH

You don’t need to have the required document/personnummer for testing purposes. If you are testing/integrating our service, you can go to our Test Vetting Portal where you can auto-generate the data for testing purposes. This is explained in more detail in our Test Instructions.

THE SERVER RETURNS ERROR 422 (UNPROCESSABLE ENTITY)

This HTTP error code indicates that Freja eID back end could not process your request for some reason. Contact our support and provide them with the full HTTP response text in order for them to identify the exact reason of the request failure.

All application error codes are described in Freja eID Relying Party Developers’ Documentation (refer to sections dedicated to Authentication services, Signature services or Custom identifier management respectively).

STAY UPDATED

Every few weeks we will summarize what is new, what has changed and what we fixed in Freja eID.

Our Release notes offer brief, high-level descriptions of enhancements and new features, covering changes in the API but also the user-visible changes in the Freja eID app and My Pages.