Via API
Custom Login via API is only possible when enabled from the backend by Ideanote, please contact us if you would like to use this authentication method.
This article describes how to login the user in the browser by using the Ideanote API. This technique can be used when JWT, SAML or OpenID isn't an option. In order to log in the user, you will have to follow these steps:
- Create or update the user and obtain the user's session token.
- Generate a link using the session token that can be used to automatically log in the user in the browser.
Create or Update the User and Obtain the Session Token.
The following JSON endpoint will automatically create the user if it doesn't exist or update the user if it already exists. The endpoint returns a session object with a sessionToken.
POST https://api.ideanote.io/v1/session?fields=kind,user.id,sessionToken
Body parameters:
Example Request:
Bash
Example Result:
JSON
Generate a Login Link using the Session Token
After obtaining the sessionToken of the user, you can generate a link that can be used to log in the user directly in the browser.
Link Directly to the Webapp
https://{{SUBDOMAIN}}.ideanote.io/login/session/{{SESSION_TOKEN}}
Example:
Automatic
https://mysubdomain.ideanote.io/login/session/41b0d309e0e4a341eccf611f9a70cbb91a6a_164864564232
Link Directly to the Widget
First you will have to get a widget link. This can be found by sharing a mission, editting the embed code and getting a "full page" widget link.
Afterwards you will have to extend the URL with the query parameter: &auth.sessionToken={{SESSION_TOKEN}}.
https://idea-widget.ideanote.io/idea-confirmation?config={{WIDGET_ID}}&auth.sessionToken={{SESSION_TOKEN}}
Example:
Automatic
https://idea-widget.ideanote.io/idea-confirmation?config=df828665bf&auth.sessionToken=41b0d309e0e4a341eccf611f9a70cbb91a6a_164864564232