Authentification
Utilisez UserJot.identify(...) pour transmettre à UserJot l’utilisateur connecté à votre application afin que ses commentaires et ses votes restent associés à son compte.
Prérequis : Activez la Connexion automatique dans Paramètres → Connexion (disponible avec les forfaits Starter et Professional). Le SDK Swift échange l’identité de l’utilisateur via la connexion automatique, même si vous n’activez pas l’option Exiger des jetons signés.
Identification de base
Au minimum, transmettez un identifiant utilisateur stable provenant de votre propre base de données (pas un jeton de session ni une adresse e-mail susceptible de changer) :
UserJot.identify(userId: "user_123")Incluez l’adresse e-mail et les champs de profil dès qu’ils sont disponibles afin que les comptes correspondent correctement dans les différentes interfaces UserJot :
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)Ne testez pas l’identification côté client avec une adresse e-mail appartenant au propriétaire ou à un administrateur de n’importe quel espace de travail UserJot. Ces comptes ne peuvent pas se connecter automatiquement côté client et doivent se connecter directement via UserJot.
Quand identifier l’utilisateur et le déconnecter
Appelez
UserJot.identify(...)après que votre application a restauré ou créé une session authentifiée, puis de nouveau si les champs de profil changent.Appelez
UserJot.logout()chaque fois que l’utilisateur se déconnecte de votre application afin que le prochain utilisateur de l’appareil n’hérite pas de la session.
@MainActor
func handleLogin(user: User) {
UserJot.identify(
userId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
)
}
@MainActor
func handleLogout() {
UserJot.logout()
}Authentification signée (HMAC-SHA256)
Pour une identification vérifiée par le serveur, calculez une empreinte hexadécimale HMAC-SHA256 de userId de l’utilisateur, à l’aide de votre secret du projet (dans Paramètres → Connexion → Secrets), puis transmettez-la sous la forme signature :
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Pour exiger une signature à chaque appel, activez l’option Exiger des jetons signés dans Paramètres → Connexion (elle apparaît lorsque la Connexion automatique est activée). N’intégrez jamais votre secret du projet dans le bundle de l’application iOS ou macOS ; calculez toujours la signature sur votre serveur.
Si vous utilisez également le widget web, l’option Exiger des jetons signés s’applique aux deux plateformes : le SDK Swift attend un signature HMAC-SHA256, tandis que le widget web attend un JWT HS256 (token). Consultez la page Identité signée.
Exemples de signature côté serveur
Node.js
import crypto from 'node:crypto';
export function signUserJotIdentity(userId, secret) {
return crypto.createHmac('sha256', secret).update(userId).digest('hex');
}Python
import hmac
import hashlib
def sign_userjot_identity(user_id: str, secret: str) -> str:
return hmac.new(
secret.encode("utf-8"),
user_id.encode("utf-8"),
hashlib.sha256,
).hexdigest()PHP
<?php
function signUserJotIdentity(string $userId, string $secret): string
{
return hash_hmac('sha256', $userId, $secret);
}Ruby
require 'openssl'
def sign_userjot_identity(user_id, secret)
OpenSSL::HMAC.hexdigest('sha256', secret, user_id)
endModèle d’application SwiftUI
@main
struct MyApp: App {
@StateObject private var authManager = AuthManager()
init() {
UserJot.setup(projectId: "YOUR_PROJECT_ID")
}
var body: some Scene {
WindowGroup {
ContentView()
.onAppear {
if let user = authManager.currentUser {
UserJot.identify(
userId: user.id,
email: user.email
)
}
}
}
}
}Étapes suivantes
Présentez les commentaires, la feuille de route et les mises à jour dans Flux courants.
Comparez toutes les options d’authentification UserJot dans Identifier les utilisateurs.