Bien démarrer avec SecureVault
Bienvenue sur SecureVault ! Ce guide vous aidera à intégrer l'authentification dans votre application en quelques minutes.
Prérequis
- • Un compte SecureVault (Inscription gratuite)
- • Node.js 14+ ou équivalent
- • Votre framework favori (Next.js, React, Vue, etc.)
1. Créer un Projet
Depuis votre dashboard, créez un nouveau projet. Cela génère automatiquement deux clés :
Clé Publique
pk_abc123...Utilisée dans votre frontend pour register/login/OAuth.
Clé Secrète
sk_abc123...Utilisée uniquement dans votre backend pour les opérations admin.
2. Installer le SDK
npm install @vaultsecure/js3. Initialiser le Client
Créez une instance avec votre clé publique. Elle peut être exposée dans votre frontend sans risque.
import { SecureVault } from '@vaultsecure/js'
export const vault = new SecureVault({
publicKey: 'pk_votre_cle_publique',
baseUrl: 'https://api.securevault.com'
})4. Inscrire un utilisateur
const user = await vault.signUp({
firstName: 'John',
lastName: 'Doe',
email: 'john@example.com',
password: 'MotDePasse123'
})
console.log('Inscrit :', user.email)5. Connecter un utilisateur
Authentifiez via email/password ou OAuth (Google, GitHub).
// Email & password
const user = await vault.signIn({
email: 'john@example.com',
password: 'MotDePasse123'
})
console.log('Connecté :', user.firstName)
// Google OAuth
vault.signInWithGoogle()
// GitHub OAuth
vault.signInWithGithub()6. Gérer le callback OAuth
Créez une page /auth/callback dans votre app pour récupérer le token après connexion OAuth.
// Sur la page /auth/callback de votre app
const result = vault.handleOAuthCallback()
if (result) {
console.log('Connecté via OAuth :', result.email)
// result.token, result.firstName, result.lastName
}7. Reset de mot de passe
Permettez à vos utilisateurs de réinitialiser leur mot de passe par email.
// Envoyer l'email de reset
await vault.forgotPassword('john@example.com')
// Réinitialiser avec le token reçu par email
await vault.resetPassword('token_recu', 'NouveauMotDePasse123')8. Gérer la session
// Vérifier si connecté
if (vault.isSignedIn()) {
const user = vault.getUser()
console.log('Bonjour', user.firstName)
}
// Déconnecter
vault.signOut()9. SDK Admin (backend uniquement)
Utilisez la clé secrète pour gérer vos utilisateurs depuis votre serveur. Ne jamais exposer côté client.
import { VaultAdmin } from '@vaultsecure/js'
const admin = new VaultAdmin(
'sk_votre_cle_secrete',
'https://api.securevault.com'
)
// Lister les utilisateurs
const users = await admin.getUsers()
// Vérifier un token JWT
const result = await admin.verifyToken('eyJhbGci...')
if (result.valid) {
console.log('Token valide pour :', result.email)
}
// Désactiver / Réactiver / Supprimer
await admin.disableUser('user@example.com')
await admin.enableUser('user@example.com')
await admin.deleteUser('user@example.com')