Aurabase-Logo
AurabasisDokumente
Dokumente›Führer›Bulk user import

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.

5 Min. gelesen·Ebene Mittelstufe·Überarbeitet am 26.10.2026
Die englische Quelle hat sich seit dieser Übersetzung geändert. Einige Informationen sind möglicherweise veraltet.
Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.
#
Übersicht

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 reibungslos funktionieren, ohne dass ein globales Zurücksetzen des Passworts erzwungen 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.

#
Sicherheit

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 neu codiert.

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.

#
HTTP-API

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.

#
SDK

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}`)
    }
  }
}
#
Studio

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.
Zuletzt aktualisiert · 26.10.2026