Via 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 décrit comment connecter l'utilisateur dans le navigateur en utilisant l'API Ideanote. Cette technique peut être utilisée lorsque JWT, SAML ou OpenID ne sont pas des options possibles. Pour connecter l'utilisateur, vous devrez suivre ces étapes :

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

Comment créer ou mettre à jour l'utilisateur et obtenir 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 jeton de session.

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

Paramètres du corps :

Nom

Description

spaceId

L'ID de votre espace de travail

kind

Cette clé doit toujours être définie sur la valeur : CUSTOM

data

Un objet de données décrivant les détails de l'utilisateur

Nom	Description
email (obligatoire)	L'adresse e-mail de l'utilisateur. Nous déterminons si un utilisateur existe déjà sur l'espace de travail en recherchant un utilisateur existant avec cette adresse e-mail.
apiToken (obligatoire)	Le jeton API d'un compte propriétaire sur votre espace de travail. Ce jeton API peut être obtenu depuis /settings/profile dans l'application web Ideanote.
sub	ID unique optionnel qui sera utilisé pour trouver un utilisateur existant sur l'espace de travail Ideanote. Si 'sub' n'est pas fourni, l'adresse e-mail sera utilisée pour trouver un utilisateur existant à la place.
name	Le nom de l'utilisateur
avatarUrl	Un lien vers une image qui devrait être utilisée comme image d'avatar pour cet utilisateur.
team	Un nom d'équipe auquel l'utilisateur doit être ajouté. L'équipe sera créée si elle n'existe pas.
locale	Les paramètres régionaux de l'utilisateur

Exemple de requête :

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": ...}

Comment générer un lien de connexion en utilisant le jeton de session

Après avoir obtenu le jeton de session 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 l'application web

https://{{SUBDOMAIN}}.ideanote.io/login/session/{{SESSION_TOKEN}}

Exemple :

Automatique

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

Lien direct vers le widget

Vous devrez d'abord obtenir un lien de widget. Celui-ci peut être trouvé en partageant une mission, en modifiant le code d'intégration et en obtenant un lien de widget "pleine page".

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}}