Weblogin API¶
This is Weblogin API guide.
Login¶
This service is used by Okeanos services’ clients in order to acquire the user authentication token.
The login URI accepts the following parameters:
| URI | Method | Description |
|---|---|---|
/login |
GET | Authenticate user and return authentication token |
| Request Parameter Name | Value |
|---|---|
| next | The URI to redirect to when the process is finished |
| renew | Force token renewal (no value parameter) |
| force | Force session invalidation (no value parameter) |
If the request user is not authenticated, is sent to the login view and after successful login, is redirected back to this view.
If the request user has not signed the approval terms, is sent to the approval terms view and after successfully signing the terms, is redirected to back to this view.
Finally, if the request user is authenticated and has signed the approval terms, is redirected to the next request parameter value.
The resulted URI contains the user identifier and authentication token.
| Return Code | Description |
|---|---|
| 302 (Redirect) | |
| 400 (Bad Request) | Missing next parameter |
| 403 (Unauthorized) | The next parameter is beyond the allowed schemes (set by ASTAKOS_REDIRECT_ALLOWED_SCHEMES setting) |