Aller au contenu principal

Utilisations

Le client JS de Lagertha simplifie le processus d'intégration et offre des méthodes claires pour gérer la connexion, la vérification des jetons, et les appels authentifiés à l'API.

Importation de l'Objet Lagertha

javascript web

npm -i --save lagertha_js

React native

npm -i --save lagertha_js

Import

pour commencer à utiliser le client Lagertha importez le client Lagertha:

Javascript web

import Lagertha from 'lagertha_js'

L'objet Lagertha comprend des méthodes statiques pour simplifier l'utilisation.

Connexion

const loginResponse = await Lagertha.connect({
login: "utilisateur",
password: "motdepasse",
application_uuid: "uuid_application",
code_2fa: "code_2fa_optionnel",
env: "url_api",
});

Cette méthode retourne un objet avec les jetons d'accès nécessaires :

{
access_token: "jeton_acces",
refresh_token: "jeton_refresh",
open_id: "jeton_open_id"
}

L'utilisateur doit stocker access_token et refresh_token.

l' open_id doit être envoyé à votre API pour établir la connexion et récupérer ses propres jetons.

Vérification et Renouvellement du Token

Avant chaque appel authentifié, l'utilisateur doit vérifier la validité du token, en particulier son expiration. Si le token est expiré, il peut le renouveler avec la méthode refresh :

const refreshedTokens = await Lagertha.refresh({
refresh_token: "jeton_refresh",
application_uuid: "uuid_application",
env: "url_api",
});

Cette méthode retourne le même objet que lors de la connexion.

Appels Authentifiés

Tous les appels authentifiés nécessitent l'ajout d'un objet LagerthaConfig en dernier argument :

Encryption

Vous voilà prêt a demander votre première clé et encrypter votre premier texte

const config: LagerthaConfig = {
access_token: 'my lagertha access token',
env: 'https://Lagertha-api-entry-point'
}

// create a new Lagertha group
const group = await Lagertha.create_group({
name: 'name of my group',
members: []
}, config)

// create a new Lagertha key
const key = await Lagertha.create_key_chain([group.uuid], config)

// encrypt your string with your cipher
const encrypted = Lagertha.encrypt('<your message>', key.id, config);

vous êtes desormais en possession de votre chaine de caractère chiffré grâce à votre clé Lagertha

Decryption

pour dechiffrer une chaine de caractère vous devez:

  • utiliser la methode decrypt et en associant, la chaine de caractère à dechiffrer et l'objet config'
const decrypt = await Lagertha.decrypt('<your encrypted message>', config);

Ces exemples pratiques d'intégration de Lagertha dans un projet web illustrent les étapes clés, de la connexion à l'encryption et à la decryption. Vous êtes maintenant prêt à intégrer Lagertha dans votre application de manière sécurisée.