Via une API

La connexion personnalisée via API n'est possible que si elle est activée depuis le backend par Ideanote, veuillez nous contacter si vous souhaitez utiliser cette méthode d'authentification.

Cet article explique comment connecter l'utilisateur dans le navigateur à l'aide de l'API Ideanote. Cette technique peut être utilisée lorsque JWT, SAML ou OpenID n'est pas une option. Pour connecter l'utilisateur, vous devez suivre les étapes suivantes :

Créez ou mettez à jour l'utilisateur et obtenez son jeton de session.
Générez un lien à l'aide du jeton de session qui peut être utilisé pour connecter automatiquement l'utilisateur dans le navigateur.

Créez ou mettez à jour l'utilisateur et obtenez le jeton de session.

Le point de terminaison JSON suivant créera automatiquement l'utilisateur s'il n'existe pas ou le mettra à jour s'il existe déjà. Le point de terminaison renvoie un objet de session avec un SessionToken.

POSTE https://api.ideanote.io/v1/session?fields=kind,user.id,sessionToken

Paramètres corporels :

Name

Description

spaceId

The ID of your workspace

kind

This key needs to always be set to the value: CUSTOM

data

A data object describing the user details

Name	Description
email (required)	The email of the user. We determine if there already exists a user on the workspace by finding an existing user with this email address.
apiToken (required)	The API token of an owner account on your workspace. This API token can be obtained from /settings/profile in the Ideanote webapp
sub	Optionally unique ID that will be used to find an existing user on the Ideanote workspace. If sub isn't provided, email will be used to find an existing user instead.
name	The name of the user
avatarUrl	A link to an image that should be used as avatar image for this user.
team	A team name that the user should be added to. The team will be created if it doesn't exists.
locale	The locale of the user

Exemple de demande :

Bash

 
curl "https://api.ideanote.io/v1/session?fields=kind,user.id,sessionToken" \
  -H "Content-Type: application/json" \
  -d '{
"spaceId": "b06f0a9a-4813-4515-81a0-29e8f2d193ec",
"kind": "CUSTOM",
"data": {
  "email": "john@doe.com",
  "apiToken": "f2dacce1fe557c7f140a3f7e85",
  "name": "John Doe",
  "avatarUrl": "https://avatars.githubusercontent.com/u/1234"
}
}'

Exemple de résultat :

JSON

 
{  "sessionToken":"41b0d309e0e4a341eccf611f9a70cbb91a6a_164864564232",  "user": ...}

Générer un lien de connexion à l'aide du jeton de session

Après avoir obtenu le SessionToken de l'utilisateur, vous pouvez générer un lien qui peut être utilisé pour connecter l'utilisateur directement dans le navigateur.

Lien direct vers la Webapp

https://{{SUBDOMAIN}}.ideanote.io/login/session/{{JETON DE SESSION}}

Exemple :

Automatique

https://mysubdomain.ideanote.io/login/session/41b0d309e0e4a341eccf611f9a70cbb91a6a_164864564232

Lien direct vers le widget

Tout d'abord, vous devrez obtenir un lien vers un widget. Vous pouvez le trouver en partageant une mission, en modifiant le code d'intégration et en obtenant un lien vers un widget « page complète ».

Ensuite, vous devrez étendre l'URL avec le paramètre de requête : &auth.SessionToken= {{SESSION_TOKEN}}.

https://idea-widget.ideanote.io/idea-confirmation?config={{WIDGET_ID}}&auth.sessionToken={{SESSION_TOKEN}}