Logo Aurabase
aurabazadokumenty
dokumenty›Przewodniki›Bulk user import

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.

5 min przeczytane·Poziom mediator·Zmieniono 26 paź 2026
Źródło angielskie uległo zmianie od czasu tego tłumaczenia. Niektóre informacje mogą być nieaktualne.
Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.
#
Przegląd

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ą działać bezproblemowo bez wymuszania 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.

#
Bezpieczeństwo

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.

#
API HTTP

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.

#
SDK

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

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.
Ostatnia aktualizacja · 26 paź 2026