Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated to Smart ID names

This article describes how to ensure that card encoding works properly, when an authenticating reverse proxy, such as Smart ID Digital Access component (Hybrid Access Gateway), is used in front of Smart ID Identity Manager (PRIME). Certain PRIME . Certain Identity Manager endpoints must be allowed, as is described below. 


Example setup

Expand
titleExamples with Hybrid Digital Access Gateway

In the following examples, it is assumed that you access PRIME Explorer access Identity Manager Operator via the following external URL of the reverse proxy:

Code Block
https://prime.with.hag/prime_explorer/


...which then connects to the internal Prime internal Identity Manager server:

Code Block
https://prime.internal:8443/prime_explorer/


Step-by-step instruction

Expand
titleAllow JPKIEncoder download endpoints

To enable Card SDK to download the JPKIEncoder, you must allow the download endpoints for JAR files:

  1. Enable everything in the /eclnt/lib/ folder to pass through without authentication. For example: 

    Code Block
    titleExample with Hybrid Digital Access Gateway component as reverse proxy
    https://prime.with.hag/prime_explorer/eclnt/lib/* 
    =>
    https://prime.internal:8443/prime_explorer/eclnt/lib/*

    This covers the following parts: 
    /prime_explorer/eclnt/lib//filelist - list of JARs to download

    /prime_explorer/eclnt/lib//*.jar - the actual JAR files listed in filelist
Note

Make sure you use the correct syntax for your reverse proxy.



Expand
titleAllow CA connector endpoints

The CA connectors of PRIME of Identity Manager use a session ID cookie embedded in the cardjob to allow the JPKIEncoder to authenticate any CA requests it has to make. The reverse proxy's authentication layer must allow the CA connector cookies without authentication. Calls will still be authenticated, via PRIME via Identity Manager itself. 

  1. Enable everything in the /ws/ca_connectors/ folder to pass through without authentication. For example:  

    Code Block
    titleExample with Hybrid Access Gateway as reverse proxy
    https://prime.with.hag/prime_explorer/ws/ca_connectors/*
    =>
    https://prime.internal:8443/prime_explorer/ws/ca_connectors/*


Note

Make sure you use the correct syntax for your reverse proxy.

Make sure that cookies, at least JSESSIONID, are forwarded on these endpoints.