Authentification

Authentification routes.

Authenticate a user

Authenticate a user with a password or token.

Request

Request Body schema: application/json

A JSON object containing authentication information.

One of:

user required	string The mail or alias of the user.
password required	string The password of the user.
login_method	integer The login method for the authentication. Value: 1
hub	boolean The hub flag specifies whether the token should be issued for the last used hub or without it.
remember	boolean The remember flag indicates if the session should be valid for a period of 30 days.

Responses

200

Successful operation

401

Unauthorized

422

Unprocessable Content

post/auth

Request samples

Payload
curl

application/json

{"user": "titan@nordantech.com",
"password": "WoWar1chUnsicher?"
}

Response samples

application/json

{"success": true,
"hash": "b3f7d7d89e16142144126daff5ad0d9522542005",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 0,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"hub": {"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"settings": {"program_level": true,
"login_confirmation": false,
"login_confirmation_channel": 1,
"office_preview": true,
"pdf_preview": true,
"support": true,
"password_age": 0,
"session_limit": 3,
"sso": false
},
"type": 0,
"expiration_time": "2022-06-30T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 Tage",
"model": "Hub"
},
"role": 5,
"admin": false,
"features": {"accounting": false,
"attachments": true,
"audit": false,
"effect_freeze": true,
"effect_provenience": true,
"impersonation": true,
"network_filter": false,
"password_age": 0,
"report_preferences": true,
"security_settings": false,
"session_limit": 3,
"sso": false,
"subscriptions": true,
"trash": 7
},
"provider": null,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJhcGkubm9yZGFuLnRlY2giLCJqdGkiOiI1YzI1ODMxMmNhMWQzNGRhOGU0OTc5YWE0NjQ5ODk3ZTYyNTRlODY5IiwibmJmIjoxNjUzOTg1NzYwLjI5ODMyMywiaWF0IjoxNjUzOTg1NzYwLjI5ODMyOSwiZXhwIjoxNjU2NTc3NzEyLCJzdWIiOiJjOTk4NWQ2NTI4ZGM3YWQwZDZmYWEyYjk5YTU0NTAzNGM1MDYzNDdiIiwiaHN1IjoiNWFkOTYyMmJiYTk5ZDY4ZmI1ZTY3MjhiZjY1MTI0YWFhM2EzZTMxMSIsInBhdCI6OSwic2VzIjo1NDkwNiwiaHViIjoxMDIyLCJtZmEiOm51bGwsInNjcCI6IioifQ.mr8PI3HxZYFYWMsh3MXlzKuJ_fvFCzv1jmXdsPMG6zctB_-qk54IQqeVIR1Att9lDo4te65PDNmSBPYLucGYug",
"ttl": 30,
"session": {"id": 54906,
"hash": "25e0e7d4a5167e0c7ff19471f767fbf77a87623f",
"model": "UserSession"
}
},
"timestamp": 1656410747548
}

Authenticate a user with code

Authenticate the current user using a login code.

SecurityJWT

Request

Request Body schema: application/json

A JSON object containing authentication information.

code

required

string

The multi factor authentication code.

Responses

200

Successful operation

401

Unauthorized

422

Unprocessable Content

post/auth/code

Request samples

Payload
curl

application/json

{"code": "013120"
}

Response samples

application/json

{"success": true,
"hash": "b3f7d7d89e16142144126daff5ad0d9522542005",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 1,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"hub": {"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"settings": {"program_level": true,
"login_confirmation": false,
"login_confirmation_channel": 1,
"office_preview": true,
"pdf_preview": true,
"support": true,
"password_age": 0,
"session_limit": 3,
"sso": false
},
"type": 0,
"expiration_time": "2022-06-30T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 Tage",
"model": "Hub"
},
"role": 5,
"admin": false,
"features": {"accounting": false,
"attachments": true,
"audit": false,
"effect_freeze": true,
"effect_provenience": true,
"impersonation": true,
"network_filter": false,
"password_age": 0,
"report_preferences": true,
"security_settings": false,
"session_limit": 3,
"sso": false,
"subscriptions": true,
"trash": 7
},
"provider": null,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJhcGkubm9yZGFuLnRlY2giLCJqdGkiOiI1YzI1ODMxMmNhMWQzNGRhOGU0OTc5YWE0NjQ5ODk3ZTYyNTRlODY5IiwibmJmIjoxNjUzOTg1NzYwLjI5ODMyMywiaWF0IjoxNjUzOTg1NzYwLjI5ODMyOSwiZXhwIjoxNjU2NTc3NzEyLCJzdWIiOiJjOTk4NWQ2NTI4ZGM3YWQwZDZmYWEyYjk5YTU0NTAzNGM1MDYzNDdiIiwiaHN1IjoiNWFkOTYyMmJiYTk5ZDY4ZmI1ZTY3MjhiZjY1MTI0YWFhM2EzZTMxMSIsInBhdCI6OSwic2VzIjo1NDkwNiwiaHViIjoxMDIyLCJtZmEiOm51bGwsInNjcCI6IioifQ.mr8PI3HxZYFYWMsh3MXlzKuJ_fvFCzv1jmXdsPMG6zctB_-qk54IQqeVIR1Att9lDo4te65PDNmSBPYLucGYug",
"ttl": 30,
"session": {"id": 54906,
"hash": "25e0e7d4a5167e0c7ff19471f767fbf77a87623f",
"model": "UserSession"
}
},
"timestamp": 1656410747548
}

Authenticate a hub change

Authenticate the change of the authenticated hub.

SecurityJWT

Request

path Parameters

hub

required

string or integer

The id/hash of the hub.

Responses

200

Successful operation

401

Unauthorized

post/auth/hub/{hub}

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "fe1a21dc09531b90a716b24338cc0d41f2160ebe",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 1,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"hub": {"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"settings": {"program_level": true,
"login_confirmation": false,
"login_confirmation_channel": 1,
"office_preview": true,
"pdf_preview": true,
"support": true,
"password_age": 0,
"session_limit": 3,
"sso": false
},
"type": 0,
"expiration_time": "2022-06-30T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 Tage",
"model": "Hub"
},
"role": 5,
"admin": false,
"features": {"accounting": false,
"attachments": true,
"audit": false,
"effect_freeze": true,
"effect_provenience": true,
"impersonation": true,
"network_filter": false,
"password_age": 0,
"report_preferences": true,
"security_settings": false,
"session_limit": 3,
"sso": false,
"subscriptions": true,
"trash": 7
},
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJhcGkubm9yZGFuLnRlY2giLCJqdGkiOiI1YzI1ODMxMmNhMWQzNGRhOGU0OTc5YWE0NjQ5ODk3ZTYyNTRlODY5IiwibmJmIjoxNjUzOTg1NzYwLjI5ODMyMywiaWF0IjoxNjUzOTg1NzYwLjI5ODMyOSwiZXhwIjoxNjU2NTc3NzEyLCJzdWIiOiJjOTk4NWQ2NTI4ZGM3YWQwZDZmYWEyYjk5YTU0NTAzNGM1MDYzNDdiIiwiaHN1IjoiNWFkOTYyMmJiYTk5ZDY4ZmI1ZTY3MjhiZjY1MTI0YWFhM2EzZTMxMSIsInBhdCI6OSwic2VzIjo1NDkwNiwiaHViIjoxMDIyLCJtZmEiOm51bGwsInNjcCI6IioifQ.mr8PI3HxZYFYWMsh3MXlzKuJ_fvFCzv1jmXdsPMG6zctB_-qk54IQqeVIR1Att9lDo4te65PDNmSBPYLucGYug",
"prover": null,
"ttl": 30,
"session": {"id": 54906,
"hash": "25e0e7d4a5167e0c7ff19471f767fbf77a87623f",
"model": "UserSession"
}
},
"timestamp": 1653472490807
}

Authenticate a user impersonation

Authenticate a user impersionation for the authenticated hub.

SecurityJWT

Request

path Parameters

user

required

string or integer

The id/hash of the user.

Responses

200

Successful operation

post/auth/impersonation/{user}

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "fe1a21dc09531b90a716b24338cc0d41f2160ebe",
"data": {"user": {"id": 2,
"hash": "a13b1b362d914d12bbcf5de981e3a7f53d00a8d0",
"name": "Uli Hoeneß",
"first_name": "Uli",
"last_name": "Hoeneß",
"email": "knacki@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T11:03:50.000000Z",
"password_age": 57,
"password_age_relative_time": "1 month ago",
"password_update": false,
"language": 0,
"settings": {"locale": 0,
"statefulness": true
},
"registration_time": "2024-03-05T16:45:14.000000Z",
"terms_accepted_time": "2024-03-11T09:30:09.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 2,
"hash": "7eacd79a0e9a4bd2f61c8b53f3cbba5166f73ee6",
"extension": "jpg",
"mime": "image/jpeg",
"size": 133912,
"created_time": "2022-06-29T15:34:02.000000Z",
"modified_time": "2022-08-22T10:09:17.000000Z",
"modified_user_time": "2022-06-29T15:34:02.000000Z",
"model": "Image"
}
},
"hub": {"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"settings": {"program_level": true,
"login_confirmation": false,
"login_confirmation_channel": 1,
"office_preview": true,
"pdf_preview": true,
"support": true,
"password_age": 0,
"session_limit": 3,
"sso": false
},
"type": 0,
"expiration_time": "2022-06-30T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 Tage",
"model": "Hub"
},
"role": 2,
"admin": false,
"impersonated": true,
"features": {"accounting": false,
"attachments": true,
"audit": false,
"effect_freeze": true,
"effect_provenience": true,
"impersonation": true,
"network_filter": false,
"password_age": 0,
"report_preferences": true,
"security_settings": false,
"session_limit": 3,
"sso": false,
"subscriptions": true,
"trash": 7
},
"provider": null,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJhcGkubm9yZGFuLnRlY2giLCJqdGkiOiI1YzI1ODMxMmNhMWQzNGRhOGU0OTc5YWE0NjQ5ODk3ZTYyNTRlODY5IiwibmJmIjoxNjUzOTg1NzYwLjI5ODMyMywiaWF0IjoxNjUzOTg1NzYwLjI5ODMyOSwiZXhwIjoxNjU2NTc3NzEyLCJzdWIiOiJjOTk4NWQ2NTI4ZGM3YWQwZDZmYWEyYjk5YTU0NTAzNGM1MDYzNDdiIiwiaHN1IjoiNWFkOTYyMmJiYTk5ZDY4ZmI1ZTY3MjhiZjY1MTI0YWFhM2EzZTMxMSIsInBhdCI6OSwic2VzIjo1NDkwNiwiaHViIjoxMDIyLCJtZmEiOm51bGwsInNjcCI6IioifQ.mr8PI3HxZYFYWMsh3MXlzKuJ_fvFCzv1jmXdsPMG6zctB_-qk54IQqeVIR1Att9lDo4te65PDNmSBPYLucGYug",
"ttl": 30,
"session": {"id": 54906,
"hash": "25e0e7d4a5167e0c7ff19471f767fbf77a87623f",
"model": "UserSession"
}
},
"timestamp": 1710350349192
}

Authenticate a verification

Authenticate a link verification.

Request

path Parameters

verification

required

string or integer

The id/hash of the verification.

query Parameters

signature

required

string

The signature for the verification.

Responses

200

Successful operation

post/auth/verification/{verification}

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "89e26875f74025762ebd0ace1c14a820a0746068",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"language": 1,
"settings": {"locale": 0,
"statefulness": true
},
"status": 1,
"model": "User"
},
"activation": "ed89d4ea96f023d252aa6882658f311b2744b72e",
"name": "Falcon",
"provider": null,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJmYWxjb24uYmFja2VuZCIsImp0aSI6IjllNzA5ODcxNDk5YWJkZTcwZGNmZDFhZjk0ZTQxZTI0ZTUwNDZlOGMiLCJuYmYiOjE2NTUxOTg0OTkuNzc0NjE4LCJpYXQiOjE2NTUxOTg0OTkuNzc0NjY1LCJleHAiOjE2NTUyMDAyOTkuNzc0NDk2LCJ0dGwiOjMwLCJzdWIiOiJkMzBjM2Q0MGM1OGI0ODVkODg2ZTI4NTM0MDcwN2VlOWRhNTRlYjBlIiwiaHN1IjoiNWFkOTYyMmJiYTk5ZDY4ZmI1ZTY3MjhiZjY1MTI0YWFhM2EzZTMxMSIsInNlcyI6NTQsImh1YiI6bnVsbCwibWZhIjpudWxsLCJzY3AiOiJ1c2VyaW52aXRlLmZpbmlzaCJ9.DstHf5EXqwN2RMjRv5CzPx9C2iTpPZ8RfrvYaViM4dU8w86p5bruAA_120mcBb6puZVonWWmcUuxKle0Cg1EeA",
"ttl": 30,
"session": {"id": 54,
"hash": "462b1f5de116285c1b72f9a3c6dd23dbe28d99a5",
"model": "UserSession"
}
},
"timestamp": 1673602323924
}

Initiate a recovery

Initiate a mulit factor authentication recovery for a user.

Request

Request Body schema: application/json

A JSON object containing authentication information.

user

required

string

The mail or alias of the user.

Responses

200

Successful operation

422

Unprocessable Content

post/auth/recovery/initiate

Request samples

Payload
curl

application/json

{"user": "titan@nordantech.com"
}

Response samples

application/json

{"success": true,
"hash": "97d170e1550eee4afc0af065b78cda302a97674c",
"data": { },
"timestamp": 1710437656773
}

Finish a recovery

Finish a mulit factor authentication recovery for a user.

SecurityJWT

Request

path Parameters

recovery

required

string

The hash of the recovery.

Responses

200

Successful operation

404

Not Found

post/auth/recovery/{recovery}/finish

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "97d170e1550eee4afc0af065b78cda302a97674c",
"data": { },
"timestamp": 1744712291556
}

Invalidate the hub

Invalidate the authenticated hub.

SecurityJWT

Responses

200

Successful operation

post/auth/hub/invalidate

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "601fc3fa7ed95326fd528d11cb4f451ddffa46b6",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 1,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"admin": false,
"features": {"accounting": null,
"attachments": null,
"audit": null,
"effect_freeze": null,
"effect_provenience": null,
"impersonation": true,
"network_filter": null,
"password_age": 0,
"report_preferences": null,
"security_settings": null,
"session_limit": 0,
"sso": null,
"subscriptions": null,
"trash": 7
},
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJzdGFnZS5hcGkubm9yZGFuLnRlY2giLCJqdGkiOiJmYzBmMzk1MGM3NzBjMTU0MjdhMWM2OTQ5ODQwYzM5NmM5ZjcyY2QyIiwibmJmIjoxNjg1MTA2NDY4LjIxMjExNywiaWF0IjoxNjg1MTA2NDY4LjIxMjEyNiwiZXhwIjoxNjg3Njk4NDY4LjIxMTk3MywidHRsIjo0MzIwMCwic3ViIjoiM2Y0ZTYyOTgwZmI1YWFjM2Y4MzliNjYzNmQ4NThkMWY1MGY1N2EyMyIsImhzdSI6IjVhZDk2MjJiYmE5OWQ2OGZiNWU2NzI4YmY2NTEyNGFhYTNhM2UzMTEiLCJzZXMiOjE2MTE2LCJodWIiOm51bGwsIm1mYSI6Mywic2NwIjoiKiJ9.Ukg1Wa-Cl1jIqXs0HhbFJr1fGrvjgQxCikoZy-yp1dp5mF4rVZtU_n0CnKC4Ashjms49hawfkibjoxyNxTB6pQ",
"ttl": 30,
"session": {"id": 16116,
"hash": "a735d3dc9a92c775d119da91c5a71af3b8f144cb",
"model": "UserSession"
}
},
"timestamp": 1685106468799
}

Invalidate the user

Invalidate the authenticated user.

SecurityJWT

Responses

200

Successful operation

post/auth/invalidate

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
"data": { },
"timestamp": 1655138528200
}

Invalidate the user impersonation

Invalidate the authenticated user impersonation.

SecurityJWT

Responses

200

Successful operation

post/auth/impersonation/invalidate

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "7cfeb65119b6e202e3d42bc66d2f2f60b69822fa",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"login_confirmation": false,
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 1,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"hub": {"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"settings": {"program_level": true,
"login_confirmation": false,
"login_confirmation_channel": 1,
"office_preview": true,
"pdf_preview": true,
"support": true,
"password_age": 0,
"session_limit": 3,
"sso": false
},
"type": 0,
"expiration_time": "2022-06-30T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 Tage",
"model": "Hub"
},
"role": 5,
"admin": false,
"features": {"accounting": false,
"attachments": true,
"audit": false,
"effect_freeze": true,
"effect_provenience": true,
"impersonation": true,
"network_filter": false,
"password_age": 0,
"report_preferences": true,
"security_settings": false,
"session_limit": 3,
"sso": false,
"subscriptions": true,
"trash": 7
},
"provider": null,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJmYWxjb24uYmFja2VuZCIsInN1YiI6ImNmNjQ0YzAwOGNiYzI3OGM1M2Q5MzBlZjMwMjJmMTM2YzE1NjVlZjQiLCJhdWQiOlsiZmFsY29uLmJhY2tlbmQiLCJmYWxjb24uYmFja2VuZC5zdG9yYWdlIl0sIm5iZiI6MTcxMDM1MDU1NS44MjQwMiwiaWF0IjoxNzEwMzUwNTU1LjgyNDA4NSwiZXhwIjoxNzEyOTQyNTU1LjgyMzg4NSwidHRsIjo0MzIwMCwianRpIjoiMWIzNDE5ZjUyM2I4ZDhiZTU4OGNkN2YwNjE1MzAyMzE4MTYwNjdiNiIsImhzdSI6IjVhZDk2MjJiYmE5OWQ2OGZiNWU2NzI4YmY2NTEyNGFhYTNhM2UzMTEiLCJzZXMiOjIyOSwiaHViIjo1LCJtZmEiOjQsInNjcCI6IioifQ.reFBR_TtXCvGhGXMMmuim5oebS0xNTj0Isw59CWq-cVWMT7iSbYcNuk54HkdK53EL06bcjOv_C-l263zRkQZHA",
"ttl": 43200,
"session": {"id": 56265,
"hash": "524f8a7d8d813303daff4a1b6dee9cf07dab1c0c",
"model": "UserSession"
}
},
"timestamp": 1710350555853
}

Resign the hub

Resign from the given hub.

SecurityJWT

Request

path Parameters

hub

required

string or integer

The id/hash of the hub.

Responses

200

Successful operation

post/auth/hub/{hub}/resign

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "63670230efe5e66d88f4734a3c861d60ba451c92",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 1,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"admin": false,
"features": {"accounting": null,
"attachments": null,
"audit": null,
"effect_freeze": null,
"effect_provenience": null,
"impersonation": true,
"network_filter": null,
"password_age": 0,
"report_preferences": null,
"security_settings": null,
"session_limit": 0,
"sso": null,
"subscriptions": null,
"trash": 7
},
"token": "eyJ0eXAiOiJKV1QiKRCopGciOiJIUzUxMiJ0.eyJpc4MiOiJmYWxjb24uYmFja2VuZCIsInN1YiI6IjNhMzczNGNlNDBiMDdiYzViZGVjYWJjZmM0YWIwZjU3ZjU1N2I5MzYiLCJhdWQiOlsiZmFsY29uLmJhY2tlbmQiLCJmYWxjb24uYmFja2VuZC5zdG9yYWdlIl0sIm5iZiI6MTc0NDAyMDg4Mi45NjAyNDUsImlhdCI6MTc0NDAyMDg4Mi45NjAzMTksImV4cCI6MTc0NDAyMjY4Mi45NjAwOTEsInR0bCI6MzAsImp0aSI6Ijg3MGNkNjIxYTU2MTVjMTg0ZTQ4NjQzZNWjNDVmMmQyNmZkMmY4NmYiLCJoc3UiOiI1YWQ5NjIyYmJhOTlkNjhmYjVlNjcyOGJmNkTsMjRhYWEzYTNlMzExIiwic2VzIjo3OTcsImh1YiI6bnVsbCwibWZhIjpudWxsLkwzY3AiOiIqIn0.Dfx_AAljM18r-Mbj-i6y8uuQtmQObg5mtJOiFxFCZm778ewmJf7iQKLwFyHSgBgiAEpVn9KLZojQ-Q9vYaJwAw",
"ttl": 30,
"session": {"id": 797,
"hash": "3607b086f40f406c8d110471cd60e89dd4210798",
"model": "UserSession"
}
},
"timestamp": 1744020882989
}

Ping

Refresh the current token silently.

SecurityJWT

Responses

200

Successful operation

post/auth/ping

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "8739602554c7f3241958e3cc9b57fdecb474d508",
"data": { },
"timestamp": 1655195789643
}

Authenticate a custom identity

Authenticate a custom identity for a given provider type.

Request

path Parameters

type required	string The identity provider type of the provider. Value: "oidc"
provider required	string or integer The id/hash of the provider.

query Parameters

state

required

string

The state for the identity provider.

Responses

302

Successful operation

422

Unprocessable Content

get/auth/provider/{type}/identity/{provider}

Request samples

curl

Response samples

application/json

{"success": false,
"error": {"status": 422,
"message": "The given data was invalid.",
"errors": {"state": ["The state field is required."
]
}
},
"timestamp": 1742832812304
}

Authenticate an identity provider

Authenticate an identity for a given provider.

Request

path Parameters

provider

required

string or integer

The id/hash of the provider.

Responses

200

Successful operation

get/auth/provider/{provider}

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "73f72cecb2ecbff724d26487c80ac67c0a007c22",
"data": {"provider": "1cfd03390b1986e5f6deec8b8c0e498743235bf4",
"issuer": "https://login.microsoftonline.com/99e1sdca-gf2d-467c-b474-62b48g21fd55/v2.0",
"type": 1
},
"timestamp": 1743430169121
}

Authenticate a social login

Authenticate a social login identity for a given provider type.

Request

path Parameters

type

required

string

The type of the provider.

Enum: "microsoft" "google"

query Parameters

state

required

string

The state for the identity provider.

Responses

302

Successful operation

422

Unprocessable Content

get/auth/provider/oauth/identity/{type}

Request samples

curl

Response samples

application/json

{"success": false,
"error": {"status": 422,
"message": "The given data was invalid.",
"errors": {"state": ["The state field is required."
]
}
},
"timestamp": 1732710035165
}

Initialize the state

Initialize the provider state for oauth authentication.

SecurityJWT

Responses

200

Successful operation

get/auth/provider/oauth/state

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "6c3a53b387f67b2e15d963439bef444fd1df5349",
"data": {"state": "1822dd77187506b88jd1cfd6d7c4888fe237aec5",
"challenge": "d2db190b1h18b881d758c9b2b59bfea07a6882fae9470706db03096dl2203bb2b4fbcc211e52baf48d28facf2812699af08c0d3d166bad76df7ddcf637a6424"
},
"timestamp": 1732708803657
}

Refresh

Refresh the current token.

SecurityJWT

Responses

200

Successful operation

post/auth/refresh

Request samples

curl

Response samples

application/json

{"success": true,
"hash": "0b7c606d5685ed09a5d5694505fa4db0baed6f46",
"data": {"user": {"id": 1,
"hash": "8db560a23013ff54838d45e59a3f3f39f6720c86",
"name": "Olli Kahn",
"first_name": "Olli",
"last_name": "Kahn",
"email": "titan@nordantech.com",
"password_type": 3,
"password_modified_time": "2022-06-27T09:48:05.000000Z",
"password_age": 1,
"password_age_relative_time": "yesterday",
"language": 1,
"settings": {"locale": 1,
"statefulness": true
},
"registration_time": "2019-11-14T16:07:39.000000Z",
"terms_accepted_time": "2019-11-14T16:07:39.000000Z",
"terms_confirmation": false,
"status": 1,
"model": "User",
"image": {"id": 1,
"hash": "613e66e4f1e3ef01a93cac169b75d4d9f43a8de4",
"extension": "jpg",
"mime": "image/jpeg",
"size": 47100,
"created_time": "2022-05-18T09:04:39.000000Z",
"modified_time": "2022-05-18T09:04:39.000000Z",
"modified_user_time": "2022-05-18T09:04:39.000000Z",
"model": "Image"
},
"hubs": [{"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"type": 0,
"expiration_time": "2023-06-03T23:59:59.000000Z",
"remaining_days": 355,
"remaining_time": "355 days",
"model": "Hub",
"identity_provider": null
},
{"id": 2,
"hash": "9f7c05fde1b7740a7dae3cc605ac360c796eb2c4",
"name": "Falcon",
"type": 0,
"expiration_time": "2022-07-13T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 days",
"model": "Hub",
"identity_provider": {"id": 2,
"hash": "26449e0a9c714a1566a1ead9815ad40e3a33fab0",
"name": "Entra",
"issuer": "",
"type": 0,
"status": 1,
"created_time": "2025-03-31T09:58:01.000000Z",
"modified_time": "2025-03-31T09:58:01.000000Z",
"modified_user_time": "2025-03-31T09:58:01.000000Z",
"model": "IdentityProvider"
}
}
]
},
"hub": {"id": 1,
"hash": "1daa7da5ba074972eb3d4552414928f5201541f3",
"name": "Nordantech",
"settings": {"program_level": true,
"login_confirmation": false,
"login_confirmation_channel": 1,
"office_preview": true,
"pdf_preview": true,
"support": true,
"password_age": 0,
"session_limit": 3,
"sso": false
},
"type": 0,
"expiration_time": "2022-06-30T23:59:59.000000Z",
"remaining_days": 30,
"remaining_time": "30 Tage",
"model": "Hub"
},
"role": 5,
"admin": false,
"features": {"accounting": false,
"attachments": true,
"audit": false,
"effect_freeze": true,
"effect_provenience": true,
"impersonation": true,
"network_filter": false,
"password_age": 0,
"report_preferences": true,
"security_settings": false,
"session_limit": 3,
"sso": false,
"subscriptions": true,
"trash": 7
},
"provider": null,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJmYWxjb24uYmFja2VuZCIsImp0aSI6IjFkZDI1ZjNlYjQwYzU5YWIyNTgzMTUzZDQ0YzdmMDU1MDk1OTAzOGIiLCJuYmYiOjE2NTUxOTU0ODkuMTE2MDA1LCJpYXQiOjE2NTUxOTU0ODkuMTE2MDI0LCJleHAiOjE2ODYyOTk0ODkuMTEzMTg1LCJ0dGwiOjQzMjAwLCJzdWIiOiJmMGNjM2U2MmQ4MDgxNzZlMzYyYTFmNGU0Yzc0YjY1NjA4Njg2OWY1IiwiaHN1IjoiNWFkOTYyMmJiYTk5ZDY4ZmI1ZTY3MjhiZjY1MTI0YWFhM2EzZTMxMSIsInNlcyI6NDksImh1YiI6MSwibWZhIjpudWxsLCJzY3AiOiIqIn0.qSOVtLAmRjy1YxZKnUrRLKPN2KS4ZUIJinMZg5iHSWvRraa-6uG2A01t-LCPP-T_Ajlb_iFEUDz3jhYnsumWKA",
"ttl": 30,
"session": {"id": 54906,
"hash": "25e0e7d4a5167e0c7ff19471f767fbf77a87623f",
"model": "UserSession"
}
},
"timestamp": 1656510275631
}

➔ Next to Accounting ledger