Workspace

Dein Workspace ist die Organisation, der deine Assistenten, dein Wissen und deine Einstellungen gehören. Jede Ressource in homie gehört zu einem Workspace, und deine Teammitglieder teilen ihn mit dir. Öffne Einstellungen → Allgemein, um ihn zu verwalten.

​

Workspace-Name und Profil

Aktualisiere den Namen deiner Organisation und die Profildaten, damit deinem Team und in Einladungen die richtige Identität angezeigt wird. Der Name erscheint auf der gesamten Plattform und in E-Mails an eingeladene Mitglieder.

​

Zwei-Faktor-Authentifizierung verlangen

Workspace-Inhaber und Admins können die Zwei-Faktor-Authentifizierung für die Anmeldung mit E-Mail und Passwort verpflichtend machen. Öffne Einstellungen → Allgemein, aktiviere in der Karte Sicherheit die Option Zwei-Faktor-Authentifizierung für die Anmeldung erzwingen und wähle Speichern. Nach dem Aktivieren müssen Mitglieder, die sich mit E-Mail und Passwort anmelden, die 2FA-Einrichtung abschließen, bevor sie die Plattform oder API nutzen können, und bei jeder Anmeldung einen Code bestätigen. Die Pflicht greift auch unmittelbar, nachdem ein eingeladenes Mitglied seine Einladung angenommen hat. Anmeldungen über Weiter mit Google, Weiter mit Microsoft oder Weiter mit SSO sichert der jeweilige Anbieter ab, die Pflicht gilt für sie daher nicht. Aktiviere die Mehr-Faktor-Authentifizierung dort. Ein Mitglied, das sowohl ein Passwort als auch eine dieser Anmeldemethoden hat, wird nur bei der Anmeldung mit dem Passwort nach dem Code gefragt. Für SSO gilt das, solange die SSO-Domain eingerichtet und verifiziert ist. Wenn im Workspace die 2FA-Pflicht gilt und du SSO für eine Domain entfernst oder diese Domain änderst, verlieren bestehende Anmeldungen über sie diese Ausnahme. Mitglieder ohne 2FA müssen die Einrichtung dann abschließen, um diese Sitzungen weiter zu nutzen. Bereits angemeldete Geräte übernehmen die Änderung innerhalb weniger Minuten.

​

Single Sign-on

Mit Single Sign-on (SSO) meldet sich dein Team über den Identitätsanbieter deines Unternehmens an. Die Plattform unterstützt Single Sign-on mit OpenID Connect (OIDC), zum Beispiel Microsoft Entra ID, Google Workspace oder Okta. Inhaber und Admins richten es unter Einstellungen → SSO je E-Mail-Domain in zwei Schritten ein: Domain mit der Verbindung zu eurem Identitätsanbieter hinzufügen und die Domain mit einem DNS-Eintrag verifizieren. Mitglieder können die Seite öffnen und die eingerichteten Domains mit Status und Standardrolle sehen, sie aber weder hinzufügen noch ändern. Ein Workspace kann mehrere SSO-Domains haben, zum Beispiel acme.com und acme.de. Jede Domain hat ihre eigene Verbindung, ihre eigene Standardrolle und ihren eigenen DNS-Eintrag. Die Domains können also denselben Identitätsanbieter nutzen oder verschiedene.

​

Bevor du beginnst

Du brauchst die Rolle Inhaber oder Admin in homie, Zugriff auf die App-Einstellungen eures Identitätsanbieters und die Berechtigung, DNS-Einträge für eure E-Mail-Domain anzulegen. Lege fest, wer auf die App zugreifen darf und welche Standardrolle neue Mitglieder erhalten sollen. Wähle Mitglied, sofern neue Teammitglieder keine Administrationsrechte brauchen.

​

SSO-Domain hinzufügen

1. Öffne auf der Plattform Einstellungen → SSO → SSO-Domain hinzufügen. Lass den Dialog geöffnet, damit du seine Weiterleitungs-URI kopieren kannst.
2. Lege in eurem Identitätsanbieter eine OpenID-Connect-Webanwendung an. Für Microsoft Entra ID folgst du der Einrichtung unten.
3. Trage eure E-Mail-Domain ein, zum Beispiel acme.com.
4. Wähle die Standardrolle: Mitglied oder Admin. Personen, die über diese Domain ohne Einladung beitreten, erhalten diese Rolle.
5. Trage Issuer-URL, Client-ID und Client-Secret der App ein.
6. Kopiere die auf der Plattform angezeigte Weiterleitungs-URI als Redirect-URI in die App (auch Sign-in-Redirect-URI oder Callback-URL genannt).
7. Wähle SSO-Domain hinzufügen.

Die Issuer-URL ist die Adresse eures Identitätsanbieters. Sie muss mit https:// beginnen. Für jeden anderen Identitätsanbieter verwendest du die Issuer-URL aus dessen OpenID-Connect-Einstellungen. Der Identitätsanbieter muss alle seine Anmeldeadressen unter der Adresse der Issuer-URL anbieten. Das Client-Secret ist der geheime Zugangsschlüssel der App eures Identitätsanbieters. Behandle ihn vertraulich. Das erfolgreiche Hinzufügen einer Domain bestätigt noch nicht, dass die Zugangsdaten der App funktionieren: Teste nach der DNS-Verifizierung eine Anmeldung.

​

Microsoft Entra ID einrichten

1. Öffne im Microsoft Entra Admin Center App-Registrierungen und erstelle eine Registrierung für homie. Wähle als unterstützten Kontotyp nur Konten in eurem Organisationsverzeichnis (Einzelner Mandant).
2. Füge eine Weiterleitungs-URI vom Typ Web hinzu. Übernimm die in homie angezeigte Weiterleitungs-URI exakt, einschließlich ihres Pfads.
3. Kopiere auf der Seite Übersicht der Registrierung die Anwendungs-ID (Client) in homies Feld Client-ID. Verwende die Verzeichnis-ID (Mandant) nur in der Issuer-URL: https://login.microsoftonline.com/<tenant-id>/v2.0. Ersetze <tenant-id> durch eure Mandanten-ID. Gemeinsame Issuer mit common, organizations oder consumers werden nicht akzeptiert.
4. Erstelle unter Zertifikate & Geheimnisse einen geheimen Clientschlüssel. Kopiere dessen Wert in homies Feld Client-Secret. Die ID des Geheimnisses ist ein anderer Wert und funktioniert hier nicht. Notiere das Ablaufdatum, damit du den Schlüssel rechtzeitig ersetzen kannst.
5. Wähle unter Tokenkonfiguration → Optionalen Anspruch hinzufügen den Tokentyp ID und füge email und xms_edov hinzu. Der Anspruch email liefert die E-Mail-Adresse; xms_edov kann bestätigen, dass ihre Domain verifiziert ist. Das Hinzufügen garantiert nicht, dass jedes Konto eine bestätigte E-Mail-Adresse liefert.
6. Stelle sicher, dass die vorgesehenen Teammitglieder in Entra auf die Anwendung zugreifen dürfen. Kehre zu homie zurück, wähle SSO-Domain hinzufügen und verifiziere die E-Mail-Domain wie unten beschrieben.

Weitere Informationen findest du in Microsofts Anleitungen zur App-Registrierung, zu Client-Secrets und zu optionalen Ansprüchen.

​

Google Workspace oder Okta einrichten

​

E-Mail-Domain verifizieren

Nachdem du die SSO-Domain hinzugefügt hast, zeigt die Plattform E-Mail-Domain verifizieren mit einem DNS-Eintrag vom Typ TXT. Er weist nach, dass die E-Mail-Domain zu deiner Organisation gehört. Jede SSO-Domain hat ihren eigenen DNS-Eintrag. Du kannst diesen Schritt jederzeit über Domain verifizieren neben der Domain erneut öffnen.

1. Öffne die DNS-Einstellungen eurer E-Mail-Domain bei eurem DNS-Anbieter.
2. Lege einen Eintrag vom Typ TXT an und kopiere Name und Wert von der Plattform. Manche DNS-Anbieter ergänzen die Domain automatisch; trage den Namen dann ohne die Domain am Ende ein.
3. Wähle zurück auf der Plattform Verifizieren.

DNS-Änderungen brauchen etwas Zeit, bis sie sichtbar sind, von wenigen Minuten bis zu mehreren Stunden. Klappt die Verifizierung nicht sofort, warte und wähle erneut Verifizieren. Die Plattform zeigt die Frist an, bis zu der du diesen DNS-Eintrag zur Verifizierung verwenden kannst. Wähle danach DNS-Eintrag anfordern und ersetze den Wert bei eurem DNS-Anbieter durch den neuen. Mitglieder wählen danach auf der Anmeldeseite Weiter mit SSO und geben ihre geschäftliche E-Mail-Adresse ein.

​

Inhaberkonto verbinden

Aus Sicherheitsgründen wird das Konto eines Workspace-Inhabers nicht allein durch eine SSO-Anmeldung mit SSO verbunden. Melde dich als Inhaber zuerst wie gewohnt an, öffne Einstellungen → SSO und wähle in Selbst per SSO anmelden die Option Mein Konto verbinden. Schließe die Anmeldung mit dem passenden Konto bei eurem Identitätsanbieter ab. Die Option erscheint, sobald die Domain deiner E-Mail-Adresse verifiziert ist. Danach kannst du Weiter mit SSO wie alle anderen nutzen. Admins und Mitglieder brauchen diesen Schritt nicht.

​

Anmeldung testen und häufige Probleme lösen

Prüfe nach der DNS-Verifizierung, dass die Domain Aktiv anzeigt. Verbinde dein Inhaberkonto wie oben beschrieben und teste anschließend Weiter mit SSO mit einem Teammitglied. Prüfe dessen Rolle und Assistentenzugriff unter Einstellungen → Team, bevor du das restliche Team einlädst.

• Ein bestehendes Konto lässt sich nicht verbinden: Melde dich mit der bisherigen Methode an. Wähle unter Account → Persönliche Daten bei unbestätigter E-Mail-Adresse Erneut senden, öffne den Bestätigungslink und versuche SSO erneut. Die E-Mail-Bestätigung des Identitätsanbieters ersetzt diesen Schritt bei einem bestehenden unbestätigten Konto nicht.
• Du siehst „Bestätige deine E-Mail-Adresse“: Öffne den Bestätigungslink, der an die angezeigte Adresse geschickt wurde, um den Beitritt abzuschließen. Hast du die Adresse bereits in einem anderen Tab bestätigt, wähle Weiter. Das kann passieren, wenn eine Einladung offen ist und der Identitätsanbieter die E-Mail-Adresse nicht bestätigt hat, etwa wenn Entra xms_edov nicht als true liefert.
• Entra lehnt die App oder Weiterleitungs-URI ab: Prüfe Client-ID, Mandanten-ID in der Issuer-URL, Wert und Ablaufdatum des Client-Secrets sowie die exakte Weiterleitungs-URI. Eine erfolgreiche DNS-Verifizierung bestätigt diese Einstellungen nicht.
• Die E-Mail-Domain stimmt nicht überein: Bitte eure Administration, die vom Identitätsanbieter gelieferte E-Mail-Adresse deines Kontos zu prüfen. Dein Microsoft-Anmeldename muss nicht diese Adresse sein.

​

SSO-Domains verwalten

Unter Einstellungen → SSO zeigt jede Domain ihren Status und ihre Standardrolle. Öffne das Menü neben einer Domain, um sie zu ändern:

• Verbindung bearbeiten ändert E-Mail-Domain, Standardrolle, Client-ID oder Client-Secret. Die Issuer-URL lässt sich nicht ändern. Lass das Client-Secret leer, um das aktuelle zu behalten. Eine neue Standardrolle gilt für Personen, die ab dann beitreten; bestehende Mitglieder behalten ihre Rolle.
• SSO entfernen entfernt SSO für diese Domain. Andere SSO-Domains des Workspace sind davon nicht betroffen.

Sobald sich Mitglieder über eine SSO-Domain angemeldet haben, kannst du deren Client-Secret erneuern, aber die Client-ID nicht mehr ändern. Um die Domain auf eine andere Issuer-URL, eine andere App oder einen anderen Identitätsanbieter umzustellen, wähle SSO entfernen und füge die Domain erneut hinzu.

​

Wer dem Workspace beitritt

Neue Mitglieder können dem Workspace bei der SSO-Anmeldung über eine eurer verifizierten SSO-Domains automatisch beitreten, auch ohne Einladung. Ohne offene Einladung erhalten sie die Standardrolle ihrer Domain und Zugriff auf alle Assistenten. Bestehende Mitglieder behalten ihre Rolle und ihren Assistentenzugriff. Mit einer Einladung legst du vorab eine andere Rolle oder eine Beschränkung auf bestimmte Assistenten fest: Ist eine Einladung an ihre E-Mail-Adresse offen, nimmt die Plattform sie nach der SSO-Anmeldung und einer gegebenenfalls nötigen E-Mail-Bestätigung automatisch an; die Person muss den Einladungslink nicht öffnen. Wird die Einladung abgelehnt oder zurückgezogen, tritt die Person bei ihrer nächsten SSO-Anmeldung mit der Standardrolle bei. Rolle und Assistentenzugriff jedes Mitglieds kannst du jederzeit unter Einstellungen → Team ändern. Nur Weiter mit SSO fügt Personen automatisch dem Workspace hinzu. Eine Anmeldung mit Weiter mit Google oder Weiter mit Microsoft macht niemanden zum Mitglied, auch nicht mit einer E-Mail-Adresse eurer Domain; dafür braucht es eine Einladung oder eine SSO-Anmeldung. Ein Konto kann nur zu einem Workspace gehören. Ist das Konto bereits Mitglied eines anderen Workspace, wird die SSO-Anmeldung mit einem Hinweis abgelehnt und die Einladung bleibt offen. Personen, die bereits ein homie-Konto haben, müssen dessen E-Mail-Adresse bestätigen, bevor sie es mit SSO verbinden können. Lade Personen, die bereits ein Konto haben, an die aktuelle E-Mail-Adresse ihres Kontos ein: Hat sich die Adresse ihres bereits verbundenen SSO-Kontos beim Identitätsanbieter geändert, wird eine Einladung an die neue Adresse nicht angewendet, und sie treten mit der Standardrolle ihrer Domain und Zugriff auf alle Assistenten bei.

​

Workspace verlassen

Wenn du Mitglied eines Workspace bist, auf den du keinen Zugriff mehr brauchst, kannst du ihn unter Allgemein verlassen.

​

Workspace löschen

Workspace-Inhaber können den gesamten Workspace dauerhaft löschen.

​

Nächste Schritte