PhenixID

PSD1122 – Navet Action for Identity Provisioning

Fact

  • PhenixID Identity Provisioning 4.8.0 or later
  • Customer ID for Navet
  • Certificate for Navet

Situation

This document will describe the action that can be used to get personal information for a Swedish person with a given personal number from the service Navet.

Solution

Download and install the action package

Download the zip file according to version of PIP.

PhenixID Identity Provisioning version 5.4.1 and earlier:
navetActionPackage.zip

PhenixID Identity Provisioning version 6.0.0 and later:
navetActionPackage600.zip

For instruction of how to install the action package, read PSD1149.

Version

The current version of the action is 1.4.

Configure the action

The action will make one call to Navet for each session object, with the configured personal number attribute value. If the personal number is correct, a number of new session attributes will be created with information from Navet. If some error occurs, an error message attribute can be created.

The parameters for the Navet V2 Person Lookup action:

Parameter

Description

Customer organisation no

[Mandatory] The organizational number, using 12 digits.

Customer ID

[Mandatory] Customer unique ID (syntax is often: XXXXXXXX-FOXX-XXXX).

Key store

[Mandatory] Path to key store.

Key store password

[Mandatory] Password to unlock the key store file

Key store type

[Optional] Key store type (default: PKCS12).

Personnummer attribute

[Mandatory] The session attribute where the Swedish personal number is located (syntax MUST be: XXXXXXXX-YYYY).

Verify syntax

[Optional] If set to “true” personal number syntax will be tested before online verification. (true/false). Default: false.

Error attribute

[Optional] The session attribute where any error will be placed. The attribute will have no value if no error occurred. Leave blank to not create any error attribute.

Endpoint URL

[Optional] Set endpoint URL if using another than the default.

Log result

[Optional] Set to true if the result from Navet should be logged in debug level. Set to false if no logging should be made. Default is false.

Example values

Parameter

Value

Customer organisation no

123456789012

Customer ID

12345678-FO12-1234

Key store

C:/certificates/navet.p12

Key store password

password

Key store type

PKCS12

Personnummer attribute

personalnumber

Verify syntax

true

Error attribute

navet-error

Endpoint URL

https://www2.skatteverket.se/na/V2/personpost

Log result

true

Result

The following session attributes will be created.

Session Attribute

Value

navetSN

Lastname, e.g. ‘Svensson’

navetAllGivenNames

All givennames, e.g. ‘Anna Karin’

navetPrefGivenName

The preferred givenname, e.g. ‘Anna’

If no preferred givenname is present for the person, the value will be ‘saknas’

navetMiddleName

Middle name, e.g. ‘Lindh’

navetNameIsPrivate

If the person has a private mark, value is ‘J’, else ‘N’

navetProtectedPublicRecords

If the person has a mark for protected public records, value is ‘J’, else ‘N’

navetSwedishPersonalNumber

If the personal number is a Swedish personal number, value is ‘J’, else ‘N’

navetStreetAddress1

Address row 1, e.g. Direktörshuset

navetStreetAddress2

Address row 2, e.g. Storgatan 5

navetPostalAddress

Postal address, e.g. Stockholm

navetPostalCode

Postal code, e.g. 12345

navetCareOf

Care of address, e.g. c/o Andersson

navetBornAbroadCountry

The country the person is born in, e.g. Tyskland

No value if the person is born in Sweden.

navetBornAbroadCity

The city abroad that the person is born in, e.g. Berlin

No value if the person is born in Sweden.

navetAbroadAddress1

Address row 1 for people living abroad, e.g. Big Street 4th

navetAbroadAddress2

Address row 2 for people living abroad, e.g. Miami

navetAbroadAddress3

Address row 3 for people living abroad, e.g. USA

navetAbroadAddressCountry

The country people living abroad, e.g. USA

navetCitizenships

Citizenships and the year the citizenship started, e.g SE, 2016

navetUnregisteringDate

Date of unregistering, e.g. 20160123

navetUnregisteringCode

Unregistering code, e.g. AV

navetEncounteredDeath

Date of encountered death, e.g. 20160123

navetChildren

List of personal numbers for the person’s children, including children who have died, e.g. 199902010123

navetChildrenAlive

List of personal numbers for the person’s living children, e.g. 199902010123

navetBirthdate

Birthdate for the person, e.g. 19720427


DISCLAIMER
Information provided in this document is for your information only. PhenixID makes no explicit or implied claims to the validity of this information. Any trademarks referenced in this document are the property of their respective owners.

The origin of this information may be internal or external to PhenixID. PhenixID makes all reasonable efforts to verify this information.

PhenixID - support.phenixid.se