Uppdatera till GRP2
Ändringshistorik
| Datum | Version | Kommentar |
|---|---|---|
| 2018-11-29 | 1.0 | Publicerad |
| 2019-03-12 | 1.1 | Uppdaterad med avvikelse för Visual Studio |
| 2019-05-16 | 1.2 | Tillägg av skillnader mellan SOAP 1.1 och SOAP 1.2 |
| 2019-08-26 | 1.3 | Skillander i notBefore och Expiredate |
Skillnader mellan GRP och GRP2
WSDL Test: https://grpt.funktionstjanster.se/grp/v2.3?wsdl
WSDL Produktion: https://grp.funktionstjanster.se/grp/v2.3?wsdl
Nyheter i GRP2
- Stöd för Freja eID+ genom att ange freja i parametern provider.
- SOAP 1.2 används istället för SOAP 1.1
Skillnader mellan SOAP 1.1 och SOAP 1.2
- SOAP 1.2 använder "application/soap+xml" som Content-Type, SOAP 1.1 använder "text/xml; charset=utf-8"
- SOAP 1.2 använder inte "SOAPAction" i headern
- SOAP 1.2 använder "http://www.w3.org/2003/05/soap-envelope" som envelope namespace, SOAP 1.1 använder "http://schemas.xmlsoap.org/soap/envelope/"
Borttagna funktioner
- FileSign – Borttaget ur GRP2 då det inte fungerade längre och BankID själva tagit bort denna.
Tillagda funktoner
- DisplayName – Ny funktion för att lista vilka DisplayName som finns tillgängliga för aktuellt ServiceID
- Cancel – Ny funktion för att avbryta påbörjad autentisering, reserverad för framtida bruk
- Status – Ny funktion för att kontrollera status, reserverad för framtida bruk
Övriga skillander
- Attributen notBefore och Expiredate kan innehålla olika format och även saknas. Fältens värden kommer från svaret från resp. utgivates valideringstjänst. Det kan skilja mellan de olika utgivarna och även mellan olika uppdateringar. Exempelvis så är formatet ISO8601 från BankID:s RPv4 men unix timestamp från BankID:s RPv5.
Parametrar
Följande förändringar i parameternamn har skett för samtliga funktioner.
- ”displayName” har bytt namn till ”rpDisplayName” och är nu obligatorisk.
- ”personalNumber” har bytt namn till ”subjectIdentifier”
Parametern provider används för att ange vilken typ av legitimation som önskas. I skrivande stund finns följande providers:
- bankid
- freja
Observera att rpDisplayName numera är obligatoriskt. Tidigare matchades detta mot tillgängliga DisplayName och plockade den första som matchades. Då detta inte alltid blev samma om man hade flera DisplayName som matchade (ex. saknad rpDisplayName mathade alla) är den nu obligatorisk. Formatet på rpDisplayName skiljer nu också mellan olika providers. Använd funktionen DisplayName för att lista vilka gällande rpDisplayName som finns för aktuellt ServiceID.
Vissa parametrar har förändrats i svaret som skickas vid en Collect med status COMPLETE. Det har tillkommit två parametrar. UserInfo och ValidationInfo. Se mer information i dokumentet "Flöde användning GRP2".
Begränsningar
- Freja har inte stöd för userNonVisibleData i signeringsfunktionen ännu då det saknades i deras API. Den funktionen är på gång och kommer inom kort.
I övrigt är det inte mycket som skiljer. Parametrar för de nya funktionerna finns i WSDL:en.
Avvikelser
Visual Studio verkar tolka typen ProgressStatus olika i GRP och GRPv2 vid import av WSDL. För GRP skapas en enumerering för alla statusvärden men för GRPv2 tolkas det som en sträng. Se giltiga värden i dokumentationen för GRPv2.