Zum Inhalt springen
Aurabase-Logo
Aurabasis

Massenbenutzerimport

Importieren Sie bis zu 1.000 Benutzer pro Stapel mit alten bcrypt- oder modernen Argon2id-Passwort-Hashes. Transparentes Upgrade auf Argon2id bei der nächsten Anmeldung.

Anleitung5 Min. gelesenEbene MittelstufeÜberarbeitet am 26.10.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Importieren von Benutzern von einer anderen Plattform#

Bei der Migration von Supabase, Firebase, Auth0 oder einer benutzerdefinierten Authentifizierungsdatenbank erwarten Benutzer, dass ihre vorhandenen Passwörter weiterhin funktionieren, ohne dass ein globales Passwort zurückgesetzt werden muss.

Aurabase bietet einen Massenimport-Endpunkt mit hohem Durchsatz (POST /v1/auth/admin/users/import), der bis zu 1.000 Benutzer pro Anfrage aufnehmen kann. Der Vorgang gibt einen detaillierten Statusbericht zurück, sodass ungültige Datensätze den Rest des Stapels nicht blockieren.

Unterstützte Passwort-Hashes und transparentes Upgrade#

Der Importendpunkt unterstützt die folgenden Passwort-Hashing-Algorithmen:

AlgorithmusIdentifikatorenVerhalten
Argon2id$argon2id$v=19$m=...Direkt mit OWASP-Parametern überprüft.
bcrypt$2a$, $2b$, $2y$Bei der Anmeldung überprüft und bei der ersten erfolgreichen Authentifizierung transparent in Argon2id umcodiert.

Wenn für einen Benutzer kein password_hash angegeben ist, wird das Konto ohne Passwort erstellt. Der Benutzer kann sich über Magic Links, E-Mail/SMS OTP oder einen Link zum Zurücksetzen des Passworts authentifizieren.

Massenimport-Endpunkt#

Erfordert Administratorberechtigung (Schlüssel service_role).

Terminalbash
curl -X POST "$AURABASE_URL/v1/auth/admin/users/import" \
  -H "apikey: $AURABASE_SERVICE_ROLE_KEY" \
  -H "Authorization: Bearer $AURABASE_SERVICE_ROLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "users": [
      {
        "email": "alice@example.com",
        "email_verified": true,
        "password_hash": "$2b$12$e8kPM4QJ8a2x4K7hM0uL.OeQ7f...",
        "name": "Alice Johnson",
        "user_metadata": { "department": "Engineering" }
      },
      {
        "email": "bob@example.com",
        "email_verified": false,
        "password_hash": "$argon2id$v=19$m=65536,t=3,p=4$..."
      }
    ]
  }'

Antwort (200 OK)

In der Antwort wird die Gesamtzahl der verarbeiteten Datensätze zusammen mit einem detaillierten Bericht aufgeführt:

json
{
  "data": {
    "created": 2,
    "skipped": 0,
    "errors": 0,
    "report": [
      {
        "index": 0,
        "email": "alice@example.com",
        "status": "created",
        "id": "e3b0c442-98fc-1c14-9afb-f4c599684824"
      },
      {
        "index": 1,
        "email": "bob@example.com",
        "status": "created",
        "id": "7d2b5129-3bdf-48bc-8919-4b684df69921"
      }
    ]
  }
}

Wenn im Projekt bereits eine E-Mail vorhanden ist, wird sie als skipped markiert, anstatt einen schwerwiegenden Fehler auszulösen.

TypeScript SDK#

Verwenden Sie authAdmin.importUsers():

import-script.tstypescript
import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(process.env.AURABASE_URL!, process.env.AURABASE_SERVICE_ROLE_KEY!)

const usersToImport = [
  {
    email: 'user1@example.com',
    emailVerified: true,
    passwordHash: '$2b$12$e8kPM4QJ8a2x4...',
    name: 'User One',
    userMetadata: { plan: 'pro' },
  },
  {
    email: 'user2@example.com',
    emailVerified: false,
    passwordHash: '$argon2id$v=19$m=65536,t=3,p=4$...',
    name: 'User Two',
  },
]

const { data, error } = await aura.authAdmin.importUsers(usersToImport)

if (error) {
  console.error('Import failed:', error.message)
} else {
  console.log(`Import summary: ${data.created} created, ${data.skipped} skipped, ${data.errors} errors`)

  for (const item of data.report) {
    if (item.status === 'error') {
      console.warn(`Row ${item.index} (${item.email}) error: ${item.error}`)
    }
  }
}

Import über Aurabase Studio#

Sie können Benutzer auch direkt über die Weboberfläche importieren:

  1. Navigieren Sie in Ihrem Projekt-Dashboard zu Authentifizierung › Benutzer.
  2. Klicken Sie in der oberen Symbolleiste auf die Schaltfläche Benutzer importieren.
  3. Wählen Sie das Format JSON oder CSV. Sie können auf klicken. Beispiel einfügen, um das erwartete Schema zu überprüfen.
  4. Fügen Sie Ihre Daten ein und klicken Sie auf Import starten.
  5. Überprüfen Sie die Chargenzusammenfassung und den zeilenweisen Statusbericht.