Authentifizierung

Shayan TaslimAktualisiert

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.

Note

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

Swift
UserJot.identify(userId: "user_123")

Übermitteln Sie E-Mail- und Profildaten, sofern verfügbar, damit Konten auf allen UserJot-Oberflächen korrekt zugeordnet werden:

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

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.

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

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:

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

Note

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

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

SwiftUI-App-Muster

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

Nächste Schritte

Hat das Ihre Frage beantwortet?