eship/setup/API_KEY_SETUP.md

Appwrite API Key Setup

API Key erstellen

1. Appwrite Console oeffnen: https://cloud.appwrite.io
2. Projekt auswaehlen: Waehle dein Projekt (ID: 696b82bb0036d2e547ad)
3. Settings > API Keys navigieren
4. "Create API Key" klicken
5. Konfiguration:
   • Name: EShip Extension Key (oder beliebiger Name)
   • Scopes:
     • users.read - Benutzer lesen
     • users.write - Benutzer erstellen/bearbeiten
     • sessions.write - Sessions erstellen
     • Optional: Weitere Scopes je nach Bedarf
   • Expiration: Optional (leer lassen fuer unbegrenzt)
6. "Create" klicken
7. API Key kopieren - WICHTIG: Der Key wird nur einmal angezeigt!

API Key in Extension konfigurieren

1. Oeffne Extension/config.js
2. Fuege den API Key hinzu:

var APPWRITE_CONFIG = {
  endpoint: 'https://cloud.appwrite.io/v1',
  projectId: '696b82bb0036d2e547ad',
  apiKey: 'DEIN_API_KEY_HIER' // Hier den kopierten Key einfuegen
};

3. Extension neu laden in chrome://extensions

Sicherheit

• NIEMALS den API Key in Git committen
• Der API Key sollte nur in der Extension verwendet werden
• Bei Verlust: Alten Key loeschen und neuen erstellen
• Verwende unterschiedliche Keys fuer Development und Production

Alternative: Environment-basierte Konfiguration

Fuer Production kannst du den API Key auch ueber Chrome Storage setzen:

1. In der Extension: chrome.storage.local.set({ apiKey: 'DEIN_KEY' })
2. Im Service Worker: Key aus Storage laden

Troubleshooting

• "Invalid API Key": Pruefe, ob der Key korrekt kopiert wurde (keine Leerzeichen)
• "Insufficient permissions": Pruefe die Scopes des API Keys
• "Key expired": Erstelle einen neuen API Key