So bedienst du das Portal

Was ist dieses Portal?

Moddy·Apps ist die Startseite für alle Dienste auf dem Server. Es zeigt dir jede App als Kachel mit Live-Status (grüne LED = online, rote LED = offline), öffnet sie mit einem Klick und kann dir dabei sogar das Passwort automatisch in die Zwischenablage legen. Außerdem ist das Portal die zentrale Anmeldung: Apps wie SecondBrain melden dich über dein Portal-Konto an – du brauchst dort kein eigenes Passwort mehr.

Es gibt zwei Rollen: Nutzer – benutzt Apps, Tresor und Anmeldung. Admin – schaltet Nutzer frei, verwaltet Apps und Freigaben. Die Admin-Kapitel stehen weiter unten.

Schnellstart – in 3 Schritten drin Nutzer

1. Anmelden. Oben rechts Anmelden → E-Mail und Passwort eingeben. Noch kein Konto? Siehe „Konto & Anmelden“.
2. App aussuchen. Auf der Startseite die gewünschte Kachel finden – notfalls oben ins Suchfeld App suchen… tippen.
3. Öffnen. Auf der Kachel Öffnen drücken. Die App öffnet sich in einem neuen Tab. Fertig.

Konto & Anmelden Nutzer

Neues Konto anlegen (Registrieren)

1. Oben rechts Registrieren anklicken.
2. E-Mail-Adresse und ein Passwort (mindestens 8 Zeichen) zweimal eingeben, absenden.
3. Postfach öffnen und in der Mail „E-Mail bestätigen“ den Link anklicken (3 Tage gültig). Danach ist dein Konto sofort aktiv und du kannst dich anmelden.

Anmelden

1. Anmelden → E-Mail + Passwort.
2. Häkchen bei Angemeldet bleiben: du bleibst 14 Tage angemeldet. Ohne Häkchen endet die Sitzung beim Schließen des Browsers, spätestens nach 12 Stunden.
3. Ist 2FA aktiv, folgt noch die Code-Abfrage (siehe 2FA).

Passwort vergessen

1. Auf der Anmeldeseite Passwort vergessen? anklicken und E-Mail eingeben.
2. Im Postfach den Link öffnen (1 Stunde gültig) und ein neues Passwort setzen.

Anmelden mit Fingerabdruck / Face ID (Passkey) Nutzer

Ein Passkey ersetzt das Passwort komplett: dein Handy/Tablet bestätigt dich per Fingerabdruck oder Gesicht. Das ist schneller und sicherer als ein Passwort (nicht zu erraten, nicht zu „phishen“) – und ersetzt auch die 2FA-Code-Abfrage.

Einmalig einrichten (pro Gerät)

1. Am Handy/Tablet im Portal anmelden (normal mit Passwort).
2. Oben Profil → zum Kasten „Passkeys · Fingerabdruck / Face ID“ rollen.
3. Dort dein aktuelles Passwort eingeben (und den 2FA-Code, falls 2FA aktiv ist) – das ist eine Sicherheitsbestätigung, damit niemand Fremdes einen Passkey anlegen kann.
4. Passkey auf diesem Gerät einrichten antippen, dem Gerät einen Namen geben (z. B. „iPhone“) und die Abfrage mit Fingerabdruck/Gesicht bestätigen.
5. Fertig – zur Bestätigung bekommst du eine kurze Info-Mail „Neuer Passkey hinzugefügt“.

Damit anmelden

1. Auf der Anmeldeseite Mit Fingerabdruck / Face ID anmelden antippen (unter dem Passwort-Formular, nach „oder“). Auf vielen Handys erscheint der Passkey auch direkt als Vorschlag über der Tastatur.
2. Fingerabdruck/Gesicht bestätigen – du bist drin. Kein Passwort, kein 2FA-Code. Die Sitzung gilt bis zu 12 Stunden (endet früher, wenn du den Browser schließt); danach einfach wieder kurz den Finger auflegen.

Zwei-Faktor-Anmeldung (2FA) Nutzer

Mit 2FA brauchst du zum Anmelden zusätzlich zum Passwort einen 6-stelligen Code aus einer Authenticator-App (z. B. Google Authenticator, Aegis, 1Password). Empfohlen – hier liegen schließlich deine App-Zugänge.

Einrichten

1. Profil → im Kasten „Zwei-Faktor (2FA)“ auf 2FA einrichten.
2. Den QR-Code mit deiner Authenticator-App scannen und den angezeigten 6-stelligen Code eintippen.
3. Backup-Codes sichern! Sie werden genau einmal angezeigt – ausdrucken oder sicher speichern. Jeder Code ersetzt einmalig einen App-Code, falls das Handy weg ist.

Wenn der Code weg ist

• Handy verloren, aber Backup-Codes da → einfach einen Backup-Code statt des App-Codes eingeben.
• Gar nichts mehr da → auf der Code-Seite unten Authenticator und Backup-Codes verloren? aufklappen und Wiederherstellungs-Link per E-Mail drücken: im E-Mail-Link nochmal das Passwort eingeben; danach ist 2FA deaktiviert und du richtest es neu ein.

Apps finden & öffnen Nutzer

• Suchen: oben ins Feld App suchen… tippen – die Liste filtert sofort.
• Filtern: mit den Knöpfen Alle · Online · Offline · Mit Zugang (letzterer zeigt nur Apps, für die du Zugangsdaten im Tresor hast).
• Status: die kleine LED auf jeder Kachel: grün = erreichbar, rot = gerade offline, gelb mit „—“ = noch nie geprüft.
• „privat“-Schildchen: diese App ist nur für Nutzer mit persönlicher Freigabe sichtbar (Admins sehen immer alle Apps).
• Öffnen: Öffnen startet die App in einem neuen Tab. Hast du im Tresor Zugangsdaten hinterlegt, wird dabei gleich dein Passwort kopiert (siehe Tresor).

Siehst du eine erwartete App nicht? Dann fehlt dir vermutlich die Freigabe – das kann nur ein Admin ändern.

Bei brain & Co. über das Portal anmelden (SSO) Nutzer

Bei angebundenen Apps (aktuell SecondBrain) meldest du dich mit deinem Portal-Konto an – ein Login für alles. So läuft es ab:

1. Im Portal auf der SecondBrain-Kachel Öffnen drücken – oder brain direkt aufrufen.
2. Auf der brain-Anmeldeseite Mit Moddy-Portal anmelden wählen.
3. Falls du im Portal gerade nicht angemeldet bist: kurz dort anmelden (Passwort oder Passkey).
4. Es erscheint die Frage „Zugriff erlauben?“ → Erlauben anklicken – genau einmal, nicht doppelt!
5. Hast du mehrere brain-Konten, kommt eine Kontenauswahl. Jedes Konto zeigt dir Name, E-Mail, die Zahl der Einträge und die letzte Nutzung – wähle das Konto mit deinen Daten (dein Hauptkonto erkennst du an der hohen Eintragszahl). Bei nur einem Konto geht es direkt hinein.

Das brain-Konto wechseln (vom Zweit- zum Hauptkonto)

1. In brain unten rechts das Profil öffnen (Profil-Symbol unten rechts).
2. Auf den Knopf Portal-Konto wechseln drücken.
3. Wieder Erlauben (einmal!) → in der Kontenauswahl das andere Konto wählen.

Damit ein Nutzer brain über das Portal nutzen darf, braucht sein Portal-Konto eine Freigabe für die App SecondBrain – siehe Admin-Handbuch.

Zugangsdaten-Tresor Nutzer

Der Tresor speichert deine Passwörter für die einzelnen Apps – Ende-zu-Ende verschlüsselt. Die gespeicherten App-Passwörter verlassen deinen Browser nie unverschlüsselt; der Server kann sie nicht lesen. (Nur die Benutzernamen der Einträge sind bewusst unverschlüsselt, damit du sie in der Liste erkennst.)

Einmalig einrichten

1. Oben in der Leiste Tresor anklicken.
2. Dein Login-Passwort eingeben – es dient zugleich als Tresor-Schlüssel.
3. Es erscheint dein Recovery-Code (Muster XXXXX-XXXXX-…). Jetzt aufschreiben oder mit Code kopieren sichern – er wird nur EINMAL angezeigt! Nur mit ihm kommst du nach einem Passwort-Reset wieder an deine gespeicherten Passwörter.

Täglich benutzen

• Entsperren / Sperren: Knopf Tresor oben; zum Entsperren das Login-Passwort eingeben. Beim Abmelden und beim Schließen des Tabs sperrt der Tresor automatisch.
• Zugangsdaten zu einer App speichern: auf der App-Kachel den kleinen Schlüssel-Knopf (Zugangsdaten verwalten) benutzen – Benutzername, Passwort, optional eine Bezeichnung.
• App öffnen mit Zugang: Öffnen → das Passwort landet automatisch in der Zwischenablage, die App öffnet sich, du fügst es im Login nur noch ein (Meldung: „Passwort kopiert … – im Login einfügen“). Bei mehreren Zugängen fragt ein kleines Fenster, welchen du willst.
• Neu bei einer App registrieren: öffnest du eine App ohne gespeicherten Zugang, bietet dir ein Assistent drei Wege an: Neu bei dieser App registrieren (erzeugt dir ein sicheres Zufallspasswort, speichert es und öffnet die Registrierungsseite), Ich habe ein Konto – Zugangsdaten hinterlegen oder Nur öffnen.

Nach einem Passwort-Reset: mit Recovery-Code entsperren

1. Tresor wie gewohnt entsperren – das neue Passwort wird als „falsch“ gemeldet, und das Portal fragt: „Hast du dein Passwort zurückgesetzt? Dann mit Recovery-Code entsperren?“ → OK.
2. Recovery-Code und dein aktuelles Login-Passwort eingeben.
3. Der Tresor wird auf das neue Passwort umgeschlüsselt und du erhältst einen neuen Recovery-Code – wieder sicher aufbewahren! (Der alte Code ist ab jetzt ungültig.)

Profil & Sicherheit Nutzer

Alles unter Profil (oben in der Leiste):

• Passwort ändern: aktuelles + neues Passwort eingeben. Alle anderen Geräte werden dabei abgemeldet; der Tresor wird automatisch auf das neue Passwort umgestellt.
• Passkeys: einrichten und entfernen – siehe oben.
• 2FA: einrichten (QR-Code scannen), Neue Backup-Codes erzeugen (macht alle alten Codes ungültig) und 2FA deaktivieren – die letzten beiden mit Passwort bestätigt.
• Aktive Sitzungen & Geräte: zeigt, wo du überall angemeldet bist. Einzelne Geräte mit Abmelden rauswerfen oder mit Auf allen Geräten abmelden alles beenden (z. B. nach Handy-Verlust).
• Tresor-Status und Tresor zurücksetzen… (Achtung: löscht alle gespeicherten Zugangsdaten unwiderruflich).

Admin-Handbuch Admin

Als Admin hast du oben in der Leiste zusätzlich den Punkt Admin. Dort gibt es drei Reiter: Übersicht, Apps und Nutzer. Admins sehen im Katalog immer alle Apps – unabhängig von Sichtbarkeit und Freigaben.

Nutzer freischalten & verwalten (Reiter „Nutzer“)

1. Neu registrierte Nutzer erscheinen hier. Hat jemand keine Bestätigungs-Mail bekommen, drückst du einfach Aktivieren – dann kann er sich sofort anmelden. Sperren macht das Gegenteil (der Nutzer fliegt sofort überall raus).
2. Freigaben öffnet die Liste der „privaten“ Apps – siehe nächster Abschnitt.
3. Zu Admin / Admin entziehen vergibt bzw. entzieht Admin-Rechte (sich selbst entziehen geht nicht – Schutz vor Aussperren).
4. Löschen entfernt den Nutzer mitsamt Tresor und Verknüpfungen. Endgültig!

Freigaben: Wer darf welche „private“ App sehen?

Jede App hat eine Sichtbarkeit:

1. Reiter Nutzer → beim gewünschten Nutzer Freigaben.
2. Die gewünschten Apps ankreuzen und speichern („Freigaben aktualisiert“).

Apps verwalten (Reiter „Apps“ / Übersicht)

1. Neue App drücken und ausfüllen: Name und Slug (Kurzkennung, z. B. brain), URL (wohin „Öffnen“ führt), Kategorie und Icon (ein Emoji), Sichtbarkeit (siehe Tabelle oben), Beschreibung (Text auf der Kachel).
2. Optional: Health-URL (welche Adresse der Statuscheck aufruft; leer = App-URL) und erwartete Statuscodes (Standard 200,301,302,307,308,401 – Antworten aus dieser Liste gelten als online). Registrierungs-URL, falls die App eine eigene Registrierungsseite hat (nutzt der Tresor-Assistent). Sortierung (kleinere Zahl = weiter oben) und Haken Aktiv (ohne Haken ist die App für alle ausgeblendet).
3. Bestehende Apps in der Liste anklicken zum Bearbeiten; Löschen entfernt sie (inklusive der Tresor-Einträge der Nutzer für diese App – Vorsicht).

Eine App an die Portal-Anmeldung anschließen (SSO)

Damit sich Nutzer in einer App mit ihrem Portal-Konto anmelden können (wie bei SecondBrain), verbindest du die App hier – komplett geführt, ohne Server-Kommandos:

1. Reiter Apps → bei der gewünschten App auf SSO drücken. (Die Spalte SSO zeigt dir, welche Apps schon angeschlossen sind.)
2. Die Weiterleitungs-Adresse prüfen – sie ist bereits vorgeschlagen – und auf Aktivieren & Zugangsdaten erzeugen drücken.
3. Den angezeigten Zugangsdaten-Block mit Zugangsdaten kopieren sichern – er wird nur dieses eine Mal angezeigt – und der Checkliste auf der Seite folgen (Zugangsdaten in die App-Konfiguration eintragen, App neu starten).
4. Testen: die App öffnen → Mit Moddy-Portal anmelden → Erlauben. Fertig.

Status / Health-Checks

Die grün/roten Status-LEDs prüft der Server regelmäßig automatisch. Wenn du es sofort wissen willst: Admin-Übersicht → Status jetzt prüfen. Leuchtet eine App dauerhaft rot, läuft meistens der Dienst dahinter nicht – das ist kein Portal-Problem.

Wenn etwas nicht klappt

Die häufigsten Stolpersteine – zum Aufklappen: