SAML - Configuring Siths Eid as an authentication method
The purpose of this document is to describe how to configure PhenixID Authentication Services for federation with SAML2 using Siths Eid as an authentication method.
Simplified Overview
Prerequisites
- PAS version 4.0 or higher
- PAS configured according to this instruction: "Federation - Username and password"
- Inera Siths EID relying party certificate ("förlitande part - certifikat")
- Inera Siths EID endpoint URL
- Access to Ineras infrastructure from the PhenixID Authentication Services (make sure the calling IP is whitelisted)
Add the Relying Party keystore to the configuration
- Follow this guide to import the Inera relying party certificate (in p12 or pfx format) as a keystore
- Note the ID of the keystore as the ID will be referred to later in this instruction
Convert the Federation - Username and Password scenario to SAML2SithsEID
1. Open the Advanced tab and locate the Authentication - HTTP entry that was configured in the previous "Federation - Username and password" scenario.
2. Change the value of the name parameter from "PostUidAndPasswordSAML" to "SAML2SithsEID"
3. Append new parameters (and patch the PAS installation if using version 4.0) according to this instruction.
Keep these values unchanged:
- pipeID
- idpID
- id
- alias
Use the keystore ID fetched in previous step as the keyStore value.
4. Click Stage changes and commit changes.
Configure the execution flow used for the SAML assertion to suit your needs
- Open the Execution flow tab and expand the flow.
- Delete the valve #1 (InputParameterExistsValidatorValve) and valve #3 (LDAPBindValve)
- Expand (Show) the LDAPSearchValve and modify the search filter to fetch users where serialNumber=<PersonalIdentificationNumber From the Siths Eid Authentication>: filter_template = serialNumber={{request.userPersonalNumber}}
- Add a parameter for attributes to fetch for the matched LDAP entry: attributes = serialNumber,sAMAccountName
- Expand (Show) the AssertionProvider and modify nameIDAttribute parameter: nameIDAttribute = serialNumber
- Click Save
NB! The logic above can be configured differently according to your needs.