Q&A

Q&A

Some questions that may arise and answers to them

Why does SIM authentication give me a 401 error with the message "mssp_105"?

If I try SIM authentication with my phone number, I get this error:

{"code":401,"reason":"Unauthorized","message":"mssp_105","detail":{"failureUrl":"mssp_105"}}

Possible explanations

  • If in the test environment, the most likely explanation is that authentication is being attempted with a number that has a prod Certificates on it. Prod Certificates cannot be used in the test environment.

  • It is also possible that the number does not have any Certificates installed.


Why do I get a 401 error with the message "id_403"?

If I try to initiate an authentication process, I get this error:

{"code":401,"reason":"Unauthorized","message":"audkenni_403","detail":{"failureUrl":"audkenni_403"}}

Possible explanation

  • Most likely "clientId" is not correct.


Why am I getting different Hash value than in Instructions?

If I use my code to create Hash from the same text as in the instructions I get a different Hash value.

Possible explanation

  • In our example in the instructions we use java code, using default encoding type. Your solution might be using different encoding type. This is for example known if using C#. This should not cause any problems in calculating the Verification Code because that code is calculated from the Hash string you send in, not the text you used to create the string.


Why am I getting {"error_description":"Invalid JWT audience","error":"invalid_request"}

Possible explanations

  • The url might me missing the port number. Try adding the correct port number (443) behind the url. Example in bold: https://pfzww.audkenni.is:443/sso/oauth2/realms/root/realms/audkenni/bc-authorize


Can I authenticate using only a computer in the Test environment?

You can set up an Android or iOS simulator on your computer and from there authenticate using only your computer. You would still need to acquire Test credentials.

  • To get SIM test credentials I need to get the phone number on the card that will be used (and preferably get the number on the card itself as well). The installation itself then takes place over the phone. A similar process to when installing a physical ID, except it is not necessary to attend a registration center.
    It is best practice to use a specific number for tests as it is not possible to have a real ID on the same card while the test ID is installed.

  • To give you access to a test version of the Auðkenni App, I need the person's email address. That email address must have access to the Google Play Store.


What does WaitTime mean?

WaitTime is the time between calls, the default value is "5000"


What is the difference between all of the REST API Versions?

 

Dæmi um upplýsingar í API kalli

Það sem bættist við

 

Dæmi um upplýsingar í API kalli

Það sem bættist við

api_v100

IDToken1 - Sláðu inn clientId: minnClientApiTest
IDToken2 - Sláðu inn Related Party: ÞjónustaSláðu inn símanúmer eða kennitölu: 1234567
IDToken3 - Sláðu inn símanúmer eða kennitölu: 1234567
IDToken4 - Sláðu inn skilaboð til notanda: Þú ert að auðkenna þig!
IDToken5 - Nota vchoice: true
IDToken6 - Sláðu inn Hash gildi: w55ldHRhIGVyIGF1w7BrZW5uaW5n
IDToken7 - Veldu auðkenningarleið: app

 

api_v200

IDToken1 - Sláðu inn clientId: minnClientApiTest
IDToken2 - Sláðu inn Related Party: Þjónusta
IDToken3 - Sláðu inn símanúmer eða kennitölu: 1234567
IDToken4 - Sláðu inn skilaboð til notanda: Þú ert að auðkenna þig!
IDToken5 - Nota vchoice: true
IDToken6 - Nota confirmMessage: false<---
IDToken7 - Sláðu inn Hash gildi: w55ldHRhIGVyIGF1w7BrZW5uaW5n
IDToken8 - Veldu auðkenningarleið: app

Í api_v200 bætist við Confirmation message. Það er gluggi sem kemur í appinu áður en að notandi byrjar að slá inn pin númerið til að gera upplýsingar til notanda skýrari.

api_v201

IDToken1 - Sláðu inn clientId: minnClientApiTest
IDToken2 - Sláðu inn Related Party: Þjónusta
IDToken3 - Sláðu inn símanúmer eða kennitölu: 1234567
IDToken4 - Sláðu inn skilaboð til notanda: Þú ert að auðkenna þig!
IDToken5 - Nota vchoice: true
IDToken6 - Nota confirmMessage: false
IDToken7 - Sláðu inn Hash gildi: w55ldHRhIGVyIGF1w7BrZW5uaW5n
IDToken8 - Veldu auðkenningarleið: cardnew <---

Í api_v201 er ekki lengur bara “card” valmöguleiki, heldur bætist við “cardnew” og “cardold” sem valmöguleiki þar sem að kortatýpum Auðkennis fjölgaði.

api_v202

IDToken1 - Sláðu inn clientId: minnClientApiTest
IDToken2 - Sláðu inn Related Party: Þjónusta
IDToken3 - Sláðu inn App Titil: Þjónusta mín<---
IDToken4 - Sláðu inn símanúmer eða kennitölu: 1234567
IDToken5 - Sláðu inn skilaboð til notanda: Þú ert að auðkenna þig!
IDToken6 - Nota vchoice: true
IDToken7 - Nota confirmMessage: false
IDToken8 - Sláðu inn Hash gildi: w55ldHRhIGVyIGF1w7BrZW5uaW5n
IDToken9 - Veldu auðkenningarleið: app

Í api_v202 bætist við App titill, þetta er fyrir þjónustuveitendur sem að vilja geta breytt hvaða titill birtist í appinu, t.d. fyrir mismunandi vörur eða mismunandi þjónustuaðila.

api_v203

IDToken1 - Sláðu inn clientId: minnClientApiTest
IDToken2 - Sláðu inn Related Party: Þjónusta
IDToken3 - Sláðu inn App Titil: Þjónusta mín<---
IDToken4 - Sláðu inn símanúmer eða kennitölu: 1234567
IDToken5 - Sláðu inn skilaboð til notanda: Þú ert að auðkenna þig!
IDToken6 - Nota vchoice: true
IDToken7 - Nota confirmMessage: false
IDToken8 - Sláðu inn Hash gildi: w55ldHRhIGVyIGF1w7BrZW5uaW5n
IDToken9 - Enter authtype: QR code<---
IDtoken10 - InitialCallbackUrl: https://eitthvad.is/callback<---
IDToken11 - Veldu auðkenningarleið: cardnew

Í api_v203 bætist við Device Link flæði sem að leyfir auðkenningar með QR kóða, Vef í App (Web2App) og App í App (App2App) flæði.