Local Authority

Eine umfassende Benutzer- und Authentifizierungsverwaltung für Node.js-Anwendungen.

Installation

npm install local-authority

Schnellstart

1. Initialisierung

import { AuthService, AuthMiddleware, RoleService } from 'local-authority';

// Initialisiere die Services
const authService = new AuthService('dein-geheimer-schlüssel');
const roleService = new RoleService();
const authMiddleware = new AuthMiddleware(authService, roleService);

2. Routen schützen

import express from 'express';
const app = express();

// Authentifizierung für eine Route
app.get('/geschuetzt', 
  authMiddleware.authenticate, 
  (req, res) => {
    res.json({ message: 'Geschützter Bereich' });
  }
);

// Autorisierung mit Rollen
app.post('/admin', 
  authMiddleware.authenticate,
  authMiddleware.requireRoles(['admin']),
  (req, res) => {
    res.json({ message: 'Admin-Bereich' });
  }
);

// Feingranulare Berechtigungen
app.put('/benutzer/:id', 
  authMiddleware.authenticate,
  authMiddleware.authorize('user', 'update'),
  (req, res) => {
    res.json({ message: 'Benutzer aktualisiert' });
  }
);

3. Benutzer registrieren und einloggen

// Benutzer registrieren
app.post('/registrieren', async (req, res) => {
  try {
    const { username, email, password } = req.body;
    const user = await authService.register(username, email, password);
    res.json(user);
  } catch (error) {
    res.status(400).json({ message: error.message });
  }
});

// Benutzer einloggen
app.post('/login', async (req, res) => {
  try {
    const { email, password } = req.body;
    const { user, token } = await authService.login(email, password);
    res.json({ user, token });
  } catch (error) {
    res.status(401).json({ message: error.message });
  }
});

Sicherheitshinweise

1. Bewahren Sie Ihren geheimen Schlüssel sicher auf
2. Verwenden Sie HTTPS in Produktionsumgebungen
3. Setzen Sie sichere Password-Hashing-Methoden ein (bereits integriert)
4. Implementieren Sie Rate-Limiting für Login-Versuche

Features

• Benutzerregistrierung und -authentifizierung
• JWT-basierte Token-Verwaltung
• Rollenbasierte Zugriffskontrolle (RBAC)
• Feingranulare Berechtigungen
• Express Middleware für Routenschutz
• TypeScript-Unterstützung

Entwicklung

# Repository klonen
git clone [repository-url]

# Abhängigkeiten installieren
npm install

# Tests ausführen
npm test

# Build erstellen
npm run build

Lizenz

MIT