Authentifizierung
Verwenden Sie UserJot.identify(...), um den in Ihrer App angemeldeten Nutzer an UserJot zu übergeben, damit Feedback und Stimmen mit dessen Konto verknüpft bleiben.
Voraussetzung: Aktivieren Sie die Automatische Anmeldung unter Einstellungen → Anmeldung (verfügbar in den Tarifen Starter und Professional). Das Swift SDK tauscht die Nutzeridentität über die automatische Anmeldung aus, auch wenn Sie Signierte Tokens erforderlich nicht aktivieren.
Grundlegende Identifizierung
Übergeben Sie mindestens eine stabile Nutzer-ID aus Ihrer eigenen Datenbank (kein Sitzungstoken und keine veränderliche E-Mail-Adresse):
UserJot.identify(userId: "user_123")Übermitteln Sie E-Mail- und Profildaten, sofern verfügbar, damit Konten auf allen UserJot-Oberflächen korrekt zugeordnet werden:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)Testen Sie die Client-Identifizierung nicht mit einer E-Mail-Adresse, die einem Inhaber oder Administrator eines beliebigen UserJot-Arbeitsbereichs gehört. Diese Konten sind von der automatischen clientseitigen Anmeldung ausgeschlossen und müssen sich direkt über UserJot anmelden.
Wann identifiziert und abgemeldet werden sollte
Rufen Sie
UserJot.identify(...)auf, nachdem Ihre App eine authentifizierte Sitzung wiederhergestellt oder erstellt hat, und erneut, wenn sich Profildaten ändern.Rufen Sie
UserJot.logout()jedes Mal auf, wenn sich der Nutzer von Ihrer App abmeldet, damit der nächste Nutzer auf dem Gerät die Sitzung nicht übernimmt.
@MainActor
func handleLogin(user: User) {
UserJot.identify(
userId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
)
}
@MainActor
func handleLogout() {
UserJot.logout()
}Signierte Authentifizierung (HMAC-SHA256)
Berechnen Sie zur serverseitig verifizierten Identifizierung einen HMAC-SHA256-Hex-Digest der userId des Nutzers, verschlüsselt mit Ihrem Projektschlüssel (unter Einstellungen → Anmeldung → Schlüssel), und übergeben Sie ihn als signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Aktivieren Sie Signierte Tokens erforderlich unter Einstellungen → Anmeldung, um Signaturen für jeden Aufruf verbindlich vorzuschreiben (die Option wird angezeigt, sobald die Automatische Anmeldung aktiviert ist). Betten Sie Ihren Projektschlüssel niemals in das iOS- oder macOS-App-Bundle ein. Berechnen Sie die Signatur immer auf Ihrem Backend.
Wenn Sie auch das Web-Widget verwenden, gilt Signierte Tokens erforderlich für beide Plattformen: Das Swift SDK erwartet ein HMAC-SHA256-signature, während das Web-Widget ein HS256-JWT (token) erwartet. Weitere Informationen finden Sie unter Signierte Identität.
Beispiele für serverseitige Signaturen
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)
endSwiftUI-App-Muster
@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
)
}
}
}
}
}Nächste Schritte
Präsentieren Sie Feedback, Roadmap und Neuigkeiten unter Typische Abläufe.
Vergleichen Sie alle Authentifizierungsoptionen von UserJot unter Nutzer identifizieren.