Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

These services should be integrated in your user registration process, so that you ensure that all your user accounts have a corresponding Bokskya account.

 

 Validate account

...

 

 Validate state for a Bokskya account by ddsId or email.

  

 

URL

https://idp.dds.boknett.no/validate/{ddsid}

 https://idp.dds.boknett.no/validate/{email}

MethodGET
Request
headers

Authorization

Required

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Response
body on success
{
  "email": "ola.nordmann@norge.no",
  "name": "Ola",
  "surname": "Nordmann",
}
Returns200OK
400Bad Request
401Unauthorized
403Forbidden
404Not found (returned if the requested user is not found)
406Not Acceptable
500Internal Server Error

...

 

curl -i -H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" -H "Date: Thu, 13 Aug 2015 12:16:39 GMT" 'https://idp.dds.boknett.no/validate/ola.nordmann@norge.no'
HTTP/1.1 200 OK
Content-Length: 59

{"id":"212c60f9-57db-4b5b-b32a-ed561346eda1","active":true}

 

Example of request where user does not exist:

 

curl -i -H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" -H "Date: Thu, 13 Aug 2015 12:16:39 GMT" 'https://idp.dds.boknett.no/validate/kari.nordmann@norge.no'
HTTP/1.1 200 OK
Date: Thu, 13 Aug 2015 12:24:30 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 25

{"data":"USER_NOT_FOUND"}

 

 

Register Account

 

Create a new DDS user account for bokskya.

 

  

 

URL

https://idp.dds.boknett.no/register

 

MethodPOST
Request
headers

Authorization

Required

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Response
body on success
{
  "email": "ola.nordmann@norge.no",
  "name": "Ola",
  "surname": "Nordmann",
}
Returns200OK
400Bad Request
401Unauthorized
403Forbidden
406Not Acceptable
500Internal Server Error

 

 

 

Example of successful response based on email address:

 

 

curl -i -H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" -H "Date: Thu, 13 Aug 2015 12:16:39 GMT" 'https://idp.dds.boknett.no/validate/ola.nordmann@norge.no'
HTTP/1.1 200 OK
Content-Length: 59

{"id":"212c60f9-57db-4b5b-b32a-ed561346eda1","active":true}