Aurabase-logo
aurabasisdocumenten
documenten›Gidsen›Bulk user import

Bulkgebruikersimport

Importeer tot 1.000 gebruikers per batch met oudere bcrypt- of moderne Argon2id-wachtwoordhashes. Transparante upgrade naar Argon2id bij de volgende aanmelding.

5 min lezen·Niveau tussenproduct·Herzien op 26 okt 2026
De Engelse bron is sinds deze vertaling veranderd. Sommige informatie kan verouderd zijn.
Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.
#
Overzicht

Gebruikers importeren van een ander platform

Bij het migreren van Supabase, Firebase, Auth0 of een aangepaste authenticatiedatabase verwachten gebruikers dat hun bestaande wachtwoorden naadloos werken zonder een globale wachtwoordreset te forceren.

Aurabase biedt een eindpunt voor bulkimport met hoge doorvoer (POST /v1/auth/admin/users/import) dat maximaal 1.000 gebruikers per verzoek kan verwerken. De bewerking retourneert een gespecificeerd statusrapport, zodat ongeldige records de rest van de batch niet blokkeren.

#
Beveiliging

Ondersteunde wachtwoord-hashes en transparante upgrade

Het importeindpunt ondersteunt de volgende algoritmen voor het hashen van wachtwoorden:

algoritmeIdentificatiegegevensGedrag
Argon2id$argon2id$v=19$m=...Rechtstreeks geverifieerd met behulp van OWASP-parameters.
bcrypt$2a$, $2b$, $2y$Geverifieerd bij inloggen en transparant opnieuw gecodeerd naar Argon2id bij de eerste succesvolle authenticatie.

Als er voor een gebruiker geen password_hash is opgegeven, wordt het account zonder wachtwoord aangemaakt. De gebruiker kan zich verifiëren via Magic Links, e-mail/sms OTP of een link voor het opnieuw instellen van het wachtwoord.

#
HTTP-API

Eindpunt voor bulkimport

Vereist beheerdersautorisatie (sleutel 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$..."
      }
    ]
  }'

Reactie (200 OK)

Het antwoord geeft details over het totale aantal verwerkte records, samen met een gespecificeerd rapport:

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

Als er al een e-mail in het project bestaat, wordt deze gemarkeerd als skipped in plaats van dat er een fatale fout optreedt.

#
SDK

TypeScript SDK

Gebruik 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

Importeren via Aurabase Studio

U kunt gebruikers ook rechtstreeks importeren via de webinterface:

  1. Navigeer naar Authenticatie ›Gebruikers in uw projectdashboard.
  2. Klik op de knop Gebruikers importeren in de bovenste werkbalk.
  3. Kies het formaat JSON of CSV. U kunt op Voorbeeld invoegen klikken om het verwachte schema te inspecteren.
  4. Plak uw gegevens en klik op Importeren starten.
  5. Inspecteer het batchoverzicht en het rij-voor-rij statusrapport.
Laatst bijgewerkt · 26 okt 2026