IDM

1 Validate account
- 1.1 Curl examples
2 Register Account
- 2.1 Curl example
3 Auth user by partner DEPRECATED
4 Get adobeId DEPRECATED

Bokskya is our cloud storage services for the end consumer. This API describes how to create and administrate user accounts and authorize reading devices and applications. Bokskya ID is the consumers unique ID. The ID is created using e-mail address as identifier.

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

New Authentication & URLs introduced Q2 2024

Validate account

Validate state for a Bokskya account by ddsId or email.

URL	`https://api.bokbasen.io/bokskya/account/v1/{id}` `https://api.bokbasen.io/bokskya/account/v1/{email}` `https://idp.dds.boknett.no/validate/{ddsid}` `https://idp.dds.boknett.no/validate/{email}` The token acquired from the Authentication Service. Example: `Authorization: Boknett TGT-....` Required header: `Date` The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Method	`GET`
Request headers	Authorization	Required	The token acquired from the Authentication Service. Audience: `https://api.bokbasen.io/bokskya/`
	Accept	Required	application/json (We recommend all new implementations to use this header, XML support will be phased out in the future)
Response body on success	`{ "id": "212c60f9-57db-4b5b-b32a-ed561346eda1", "active": true }`
Returns	`200`	OK (Will also be returned if user not found, see response body)
	`40X`	On error

Curl examples

Example of successful response based on email address:

curl -i -H "Accept: application/json" \
        -H "Authorization: Bearer <token>" \
        'https://api.bokbasen.io/bokskya/account/v1/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 "Accept: application/json" \
        -H "Authorization: Bearer <token>" \
        'https://api.bokbasen.io/bokskya/account/v1/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 Bokskya user account

URL	`https://api.bokbasen.io/bokskya/account/v1` `https://idp.dds.boknett.no/register` The token acquired from the Authentication Service. Example: `Authorization: Boknett TGT-....` Required header: `Date` The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Method	`POST`
Request headers	Authorization	Required	The token acquired from the Authentication Service. Audience: `https://api.bokbasen.io/bokskya/`
	Accept	Required	application/json (We recommend all new implementations to use this header, XML support will be phased out in the future)
	Content-type	Required	application/json
JSON attributes	email	Required	Email of the user (unique in bokskya)
	name	Required	First name of the user (minimum length 2)
	surname	Required	Surname of the user (minimum length 2)
Response body
Returns	`200`	OK
Returns	`40X`	On error

Curl example

Example of successful creation of user:

Auth user by partner DEPRECATED

Service to authenticate a Bokskya account on behalf of a user and to support Bokskya implementation of Adobe Content Server VendorID.

URL	`https://idp.dds.boknett.no/authenticate/{ddsid}` `https://idp.dds.boknett.no/authenticate/{email}`
Method	`GET`
Request headers	Authorization	Required	The token acquired from the Authentication Service. Example: `Authorization: Boknett TGT-....`
	Date	Required	The timestamp the request was made. Must comply with RFC 1123 date formats. Example: `Tue, 10 Jun 2014 16:23:42 GMT`
	Accept	Required	application/json (We recommend all new implementations to use this header, XML support will be phased out in the future)
Response body on success	Note: id attribute is base64 encoded token for authenticated {ddsId} (AQIC5wM2LY4SfcwrQoJ9lw3nFA39ppf8X8KAdIxmd4ldHUI. AAJTSQACMDE.)
Returns	`200`	OK
	`40x`	On errors

Get adobeId DEPRECATED

Look up AdobeID for a Bokskya account by ddsId or email

URL	`https://idp.dds.boknett.no/adobeid/{ddsid}` `https://idp.dds.boknett.no/adobeid/{email}`
Method	`GET`
Request headers	Authorization	Required	The token acquired from the Authentication Service. Example: `Authorization: Boknett TGT-....`
	Date	Required	The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
	Accept	Required	application/json (We recommend all new implementations to use this header, XML support will be phased out in the future)
Response body on success	When request is valid, user found and adobeId exist: `{"adobeid":"adobeId..."}` When request is valid, user found and adobeId not exist `{"data":"NO_ADOBEID_EXIST"}`
Returns	`200`	OK
	`40x`	On error