Authentification

Shayan TaslimMis à jour

Utilisez UserJot.identify(...) pour transmettre à UserJot l’utilisateur connecté à votre application afin que ses commentaires et ses votes restent associés à son compte.

Note

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) :

Swift
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 :

Swift
UserJot.identify(
    userId: "user_123",
    email: "john@example.com",
    firstName: "John",
    lastName: "Doe",
    avatar: "https://example.com/avatar.jpg"
)
Warning

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.

Swift
@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 :

Swift
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.

Note

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

JavaScript
import crypto from 'node:crypto';

export function signUserJotIdentity(userId, secret) {
  return crypto.createHmac('sha256', secret).update(userId).digest('hex');
}

Python

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
<?php

function signUserJotIdentity(string $userId, string $secret): string
{
    return hash_hmac('sha256', $userId, $secret);
}

Ruby

Ruby
require 'openssl'

def sign_userjot_identity(user_id, secret)
  OpenSSL::HMAC.hexdigest('sha256', secret, user_id)
end

Modèle d’application SwiftUI

Swift
@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

Cet article a-t-il répondu à votre question ?