Массовый импорт пользователей
Импортируйте до 1000 пользователей за один пакет с помощью устаревшего bcrypt или современных хэшей паролей Argon2id. Прозрачное обновление до Argon2id при следующем входе в систему.
Импорт пользователей с другой платформы#
При переходе с Supabase, Firebase, Auth0 или пользовательской базы данных аутентификации пользователи ожидают, что их существующие пароли продолжат работать без глобального сброса паролей.
Aurabase предоставляет высокопроизводительную конечную точку массового импорта (POST /v1/auth/admin/users/import), способную принимать до 1000 пользователей за запрос. Операция возвращает подробный отчет о состоянии, поэтому недействительные записи не блокируют остальную часть пакета.
Поддерживаемые хэши паролей и прозрачное обновление.#
Конечная точка импорта поддерживает следующие алгоритмы хеширования паролей:
| Алгоритм | Идентификаторы | Поведение |
|---|---|---|
| Argon2id | $argon2id$v=19$m=... | Проверено напрямую с использованием параметров OWASP. |
| bcrypt | $2a$, $2b$, $2y$ | Проверяется при входе в систему и прозрачно перекодируется в Argon2id при первой успешной аутентификации. |
Если для пользователя не указан password_hash, учетная запись создается без пароля. Пользователь может пройти аутентификацию с помощью Magic Links, OTP по электронной почте/SMS или ссылки для сброса пароля.
Конечная точка массового импорта#
Требуется авторизация администратора (ключ 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$..."
}
]
}'
Ответ (200 OK)
В ответе подробно указано общее количество обработанных записей, а также подробный отчет:
{
"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"
}
]
}
}
Если электронное письмо уже существует в проекте, оно помечается как skipped, а не вызывает фатальную ошибку.
TypeScript SDK#
Используйте 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}`)
}
}
}
Импорт через Aurabase Studio#
Вы также можете импортировать пользователей напрямую через веб-интерфейс:
- Перейдите к Аутентификация › Пользователи на панели управления проектом.
- Нажмите кнопку Импортировать пользователей на верхней панели инструментов.
- Выберите формат JSON или CSV. Вы можете нажать Вставить образец, чтобы проверить ожидаемую схему.
- Вставьте свои данные и нажмите Начать импорт.
- Проверьте сводную информацию о пакете и отчет о состоянии построчно.