Bulkgebruikersimport
Importeer tot 1.000 gebruikers per batch met oudere bcrypt- of moderne Argon2id-wachtwoordhashes. Transparante upgrade naar Argon2id bij de volgende aanmelding.
Gebruikers importeren van een ander platform#
Bij het migreren van Supabase, Firebase, Auth0 of een aangepaste authenticatiedatabase verwachten gebruikers dat hun bestaande wachtwoorden blijven werken zonder een globale wachtwoordreset.
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.
Ondersteunde wachtwoord-hashes en transparante upgrade#
Het importeindpunt ondersteunt de volgende algoritmen voor het hashen van wachtwoorden:
| algoritme | Identificatiegegevens | Gedrag |
|---|---|---|
| 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.
Eindpunt voor bulkimport#
Vereist beheerdersautorisatie (sleutel service_role).
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:
{
"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.
TypeScript SDK#
Gebruik authAdmin.importUsers():
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}`)
}
}
}
Importeren via Aurabase Studio#
U kunt gebruikers ook rechtstreeks importeren via de webinterface:
- Navigeer naar Authenticatie ›Gebruikers in uw projectdashboard.
- Klik op de knop Gebruikers importeren in de bovenste werkbalk.
- Kies het formaat JSON of CSV. U kunt op Voorbeeld invoegen klikken om het verwachte schema te inspecteren.
- Plak uw gegevens en klik op Importeren starten.
- Inspecteer het batchoverzicht en het rij-voor-rij statusrapport.