organization-best-practices

Überblick

Der organization Skill von Better Auth ermöglicht Backend-Entwicklern eine effiziente Verwaltung von Multi-Tenant-Organisationen, Mitgliedern, Teams und rollenbasierter Zugriffskontrolle (RBAC) innerhalb ihrer Anwendungen. Dieser Skill ist für Projekte konzipiert, die erweiterte Benutzerverwaltung benötigen, wie SaaS-Plattformen, interne Tools oder Systeme, in denen Nutzer zu Organisationen mit unterschiedlichen Rollen und Berechtigungen gehören.

Mit dem organization Skill können Sie:

• Organisationen mit individuellen Limits für Erstellung und Mitgliedschaft konfigurieren
• Einladungen verwalten und neue Mitglieder onboarden
• Eigene Rollen und Berechtigungen definieren und zuweisen
• Teams innerhalb von Organisationen einrichten
• RBAC für sichere Zugriffskontrolle implementieren

Dieser Skill eignet sich besonders für Teams, die Backend-Systeme mit skalierbarer, sicherer und flexibler Organisationsverwaltung entwickeln. Für einfache Apps ohne Organisationsstruktur oder mit Einzelbenutzerzugang ist er weniger geeignet.

Verwendung

Installationsschritte

1. Fügen Sie das organization Plugin zu Ihrer Serverkonfiguration hinzu:

   import { betterAuth } from "better-auth";
   import { organization } from "better-auth/plugins";
   
   export const auth = betterAuth({
     plugins: [
       organization({
         allowUserToCreateOrganization: true,
         organizationLimit: 5, // Maximal erlaubte Organisationen pro Nutzer
         membershipLimit: 100, // Maximal erlaubte Mitglieder pro Organisation
       }),
     ],
   });
   

2. Fügen Sie das organization Client Plugin zu Ihrer Client-Konfiguration hinzu:

   import { createAuthClient } from "better-auth/client";
   import { organizationClient } from "better-auth/client/plugins";
   
   export const authClient = createAuthClient({
     plugins: [organizationClient()],
   });
   

3. Führen Sie die Datenbankmigrationen aus:

   Führen Sie folgenden Befehl aus, um die notwendigen Tabellen für Organisationen, Mitglieder und Einladungen anzulegen:

   npx @better-auth/cli migrate
   

4. Überprüfen Sie Ihre Einrichtung:

   Kontrollieren Sie Ihre Datenbank, um sicherzustellen, dass die Tabellen für Organisationen, Mitglieder und Einladungen erstellt wurden.

Organisationen erstellen und verwalten

• Organisation erstellen:

  Der Nutzer, der eine Organisation erstellt, erhält automatisch die Rolle owner.

  const createOrg = async () => {
    const { data, error } = await authClient.organization.create({
      name: "My Company",
      slug: "my-company",
      logo: "https://example.com/logo.png",
      metadata: { plan: "pro" },
    });
  };
  

• Steuerung, wer Organisationen erstellen darf:

  Sie können die Erstellung von Organisationen anhand von Nutzerattributen einschränken, indem Sie die Plugin-Optionen anpassen.

Rollen und Berechtigungen anpassen

Definieren Sie benutzerdefinierte Rollen und Berechtigungen, die zu den Anforderungen Ihrer Anwendung passen. Nutzen Sie die Plugin-Konfiguration, um RBAC einzurichten und den Zugriff auf Organisations- oder Teamebene zu steuern.

Best Practices

• Lesen Sie die SKILL.md Datei für detaillierte Konfigurationsoptionen und erweiterte Nutzung.
• Passen Sie die bereitgestellten Codebeispiele an die Struktur und Anforderungen Ihres Projekts an.
• Verwenden Sie den organization Skill in Projekten, bei denen Benutzergruppierung, Teamverwaltung und feingranulare Zugriffskontrolle entscheidend sind.

FAQ

Für wen ist der organization Skill geeignet?

Backend-Entwickler, die Multi-Tenant-Anwendungen, SaaS-Produkte oder Systeme mit umfassender Organisations- und Zugriffskontrolle entwickeln, profitieren am meisten von diesem Skill.

Welche Voraussetzungen gibt es für die Installation?

Sie benötigen ein Projekt mit Better Auth sowie Zugriff auf Ihr Backend und Ihre Datenbank für die Plugin-Konfiguration und Migrationen.

Kann ich Organisationslimits und Rollen anpassen?

Ja, der organization Skill erlaubt es, Limits für die Anzahl der Organisationen pro Nutzer, Mitglieder pro Organisation sowie benutzerdefinierte Rollen und Berechtigungen festzulegen.

Wo finde ich weitere Details?

Schauen Sie in die SKILL.md Datei im Repository für erweiterte Konfigurationen oder durchsuchen Sie den Reiter "Files" für unterstützende Skripte und Referenzen.