Przejdź do treści
Logo Aurabase
aurabaza

Zbiorczy import użytkowników

Importuj do 1000 użytkowników na partię za pomocą starszych skrótów haseł bcrypt lub nowoczesnych Argon2id. Przejrzysta aktualizacja do Argon2id przy następnym logowaniu.

Przewodnik krok po kroku5 min przeczytanePoziom mediatorZmieniono 26 paź 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

Importowanie użytkowników z innej platformy#

Podczas migracji z Supabase, Firebase, Auth0 lub niestandardowej bazy danych uwierzytelniania użytkownicy oczekują, że ich istniejące hasła będą nadal działać bez globalnego resetowania hasła.

Aurabase zapewnia punkt końcowy importu zbiorczego o dużej przepustowości (POST /v1/auth/admin/users/import), który może pozyskać do 1000 użytkowników na żądanie. Operacja zwraca szczegółowy raport o stanie, dzięki czemu nieprawidłowe rekordy nie blokują reszty partii.

Obsługiwane skróty haseł i przejrzysta aktualizacja#

Punkt końcowy importu obsługuje następujące algorytmy mieszania haseł:

AlgorytmIdentyfikatoryZachowanie
Argon2id$argon2id$v=19$m=...Weryfikacja bezpośrednio przy użyciu parametrów OWASP.
szyfrowanie$2a$, $2b$, $2y$Zweryfikowane przy logowaniu i w przezroczysty sposób ponownie zakodowane do Argon2id po pierwszym pomyślnym uwierzytelnieniu.

Jeżeli dla użytkownika nie podano password_hash, konto zostanie utworzone bez hasła. Użytkownik może uwierzytelnić się za pomocą Magic Links, OTP e-mail/SMS lub linku do resetowania hasła.

Punkt końcowy importu zbiorczego#

Wymaga autoryzacji administratora (klucz 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$..."
      }
    ]
  }'

Odpowiedź (200 OK)

W odpowiedzi wyszczególniono całkowitą liczbę przetworzonych rekordów wraz ze szczegółowym raportem:

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"
      }
    ]
  }
}

Jeśli wiadomość e-mail już istnieje w projekcie, zostanie oznaczona jako skipped zamiast zgłaszać błąd krytyczny.

TypeScript SDK#

Użyj 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}`)
    }
  }
}

Importuj przez Aurabase Studio#

Możesz także importować użytkowników bezpośrednio przez interfejs sieciowy:

  1. Przejdź do Uwierzytelnianie > Użytkownicy w panelu projektu.
  2. Kliknij przycisk Importuj użytkowników na górnym pasku narzędzi.
  3. Wybierz format JSON lub CSV. Możesz kliknąć Wstaw próbkę, aby sprawdzić oczekiwany schemat.
  4. Wklej swoje dane i kliknij Rozpocznij import.
  5. Sprawdź podsumowanie partii i raport stanu wiersz po wierszu.