wm login

Authentifizierung mit Webmate Studio.

Übersicht

wm login verbindet die CLI mit deinem CMS-Projekt. Nach erfolgreicher Authentifizierung werden Credentials lokal gespeichert und automatisch für wm dev, wm push und andere Befehle verwendet.

wm login

Interaktiver Login

Der Login-Prozess führt dich durch folgende Schritte:

$ wm login

Webmate CLI Login

? Webmate Base URL: https://app.localhost:3029
? E-Mail: developer@example.com
? Passwort: ********

Authentifiziere...
✓ Eingeloggt als developer@example.com

Lade Projekte...

? Wähle ein Projekt:
  ❯ Mein Projekt (mein-projekt)
    Erstellt am 23.10.2025

    Test Projekt (test-projekt)
    Erstellt am 22.10.2025

Generiere API-Token...

✨ Login erfolgreich!

  Projekt: Mein Projekt
  Subdomain: mein-projekt

Du kannst jetzt wm dev und wm push verwenden.

Was wird gespeichert?

Login-Credentials werden in ~/.webmate/auth.json gespeichert:

{
  "user": {
    "id": "...",
    "email": "developer@example.com"
  },
  "tenant": {
    "id": "...",
    "name": "Mein Projekt",
    "subdomain": "mein-projekt"
  },
  "apiToken": "...",
  "baseUrl": "https://app.localhost:3029",
  "loginAt": "2025-10-24T10:30:00.000Z"
}

Projekt wechseln

Nach Login zu einem anderen Projekt wechseln:

wm switch

Oder komplett neu anmelden:

wm login
? Bereits eingeloggt als developer@example.com. Neu anmelden? Ja

Non-Interactive Login

Für CI/CD oder Automatisierung ohne Interaktion:

# Environment Variables setzen
export CMS_BASE_URL="https://app.example.com"
export CMS_TOKEN="your-api-token"

# Befehle ohne Login ausführen
wm push --target https://projekt.cms.example.com --token $CMS_TOKEN

Optionen

Option	Beschreibung
-u, --url <url>	CMS Base-URL (überspringt Eingabeaufforderung)

Beispiele

Standard-Login

wm login

Mit vorgegebener URL

wm login --url https://app.example.com

Login-Status prüfen

wm info

Fehlerbehebung

"Login fehlgeschlagen"

Mögliche Ursachen:

• Falsche E-Mail oder Passwort
• CMS nicht erreichbar
• Netzwerkprobleme

Lösung:

# 1. Credentials prüfen
wm login

# 2. CMS-URL prüfen (muss erreichbar sein)
curl https://app.example.com/api/health

# 3. Bei localhost: Self-signed Certificates
# → CLI akzeptiert automatisch self-signed Certificates für localhost

"Keine Projekte gefunden"

Du hast noch kein Projekt im CMS erstellt.

Lösung:

1. Im CMS einloggen
2. Neues Projekt erstellen
3. wm login erneut ausführen

Mehrere Accounts

Zwischen Accounts wechseln:

# Abmelden
wm logout

# Neu anmelden
wm login

Best Practices

1. Einmal einloggen, dann vergessen

Nach wm login werden alle Befehle automatisch authentifiziert:

wm login      # Einmalig
wm dev        # Verwendet Login
wm push       # Verwendet Login

2. Pro Projekt einloggen

Wenn du an mehreren Projekten arbeitest:

# Projekt A
cd projekt-a
wm login
wm dev

# Projekt B
cd projekt-b
wm login
wm dev

Oder wm switch verwenden:

wm switch
? Wähle ein Projekt: Projekt B

3. CI/CD: Keine Login-Speicherung

In CI/CD-Umgebungen keine Credentials speichern:

# CI/CD Pipeline
wm push --target $CMS_URL --token $CMS_TOKEN

Security

Credentials-Speicherort

~/.webmate/auth.json

Credentials löschen

wm logout

API-Token Rotation

API-Tokens werden beim Login automatisch neu generiert. Alte Tokens werden ungültig.

Nächste Schritte

• wm info - Login-Status anzeigen
• wm switch - Projekt wechseln
• wm logout - Abmelden
• wm dev - Dev-Server starten (benötigt Login)
• wm push - Components hochladen (benötigt Login)