Cloud-Anwendung „HappyFox“

Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.

Die Security Assertion Markup Language (SAML) ermöglicht es Nutzern, sich mit ihren Google Cloud-Anmeldedaten in geschäftlichen Cloud-Anwendungen anzumelden.

Einmalanmeldung (SSO) über SAML für HappyFox einrichten

Schritt 1: Google als SAML-Identitätsanbieter einrichten

1. Melden Sie sich in der Google Admin-Konsole an.

   Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).

2. Gehen Sie in der Admin-Konsole zu „Menü“  AppsWeb- und mobile Apps.
3. Klicken Sie auf App hinzufügen  Nach Apps suchen.
4. Geben Sie HappyFox in das Suchfeld ein.
5. Bewegen Sie den Mauszeiger in den Suchergebnissen auf die SAML-App HappyFox und klicken Sie dann auf Auswählen. 
6. Gehen Sie auf der Seite Details zum Google-Identitätsanbieter so vor:
   1. Kopieren und speichern Sie die SSO URL.
   2. Laden Sie das Zertifikat herunter.   
7. Klicken Sie auf Weiter.

8. Bearbeiten Sie auf der Seite Details zum Dienstanbieter die Felder ACS-URL und Entitäts-ID und ersetzen Sie {subdomain} durch Ihre HappyFox-Subdomain.

9. Klicken Sie auf Weiter.
10. (Optional) On the Attribute Mapping page, map Google directory attributes to corresponding application attributes:

    1. Click Add Mapping.
    2. Click the Select field menu and select a Google directory attribute.
    3. Enter the corresponding application attribute under App attributes.
11. Optional: So geben Sie Gruppennamen ein, die für diese App relevant sind:

    1. Klicken Sie unter Gruppenmitgliedschaft (optional) auf Nach einer Gruppe suchen, geben Sie einen oder mehrere Buchstaben des Gruppennamens ein und wählen Sie den Gruppennamen aus.
    2. Fügen Sie nach Bedarf weitere Gruppen hinzu (maximal 75 Gruppen).
    3. Geben Sie unter App-Attribut den entsprechenden Gruppenattributnamen des Dienstanbieters ein.

    Unabhängig davon, wie viele Gruppennamen Sie eingeben, enthält die SAML-Antwort nur Gruppen, in denen ein Nutzer direkt oder indirekt Mitglied ist. Weitere Informationen finden Sie unter Zuordnung von Gruppenmitgliedschaften.

12. Klicken Sie auf der Seite Attributzuordnung auf Beenden.

Schritt 2: HappyFox als SAML 2.0-Dienstanbieter einrichten

1. Öffnen Sie ein neues Inkognitofenster im Browser und melden Sie sich als Administrator in Ihrem HappyFox-Konto an.

2. Rufen Sie https://<accountname>.happyfox.com/staff/manage/integrations/auth/saml auf.

3. Geben Sie in die folgenden Felder die entsprechenden Informationen ein:

   1. IdP Signature (IdP-Signatur): Öffnen Sie das in Schritt 1 heruntergeladene Zertifikat und kopieren Sie dessen Inhalt. Fügen Sie ihn bei HappyFox ein.

   2. SSO Target URL (SSO-Ziel-URL): Geben Sie die SSO-URL ein, die Sie in Schritt 1 kopiert haben.

4. Wählen Sie die gewünschten Optionen aus, die Sie für die Authentifizierung von Helpdesk-Mitarbeitern und Endnutzern über SAML verwenden möchten. 

5. Klicken Sie auf Save Settings (Einstellungen speichern).

Schritt 3: HappyFox aktivieren

1. Melden Sie sich in der Google Admin-Konsole an.

   Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).

2. Gehen Sie in der Admin-Konsole zu „Menü“  AppsWeb- und mobile Apps.
3. Wählen Sie HappyFox aus.
4. Klicken Sie auf Nutzerzugriff.

5. Wenn Sie einen Dienst für alle Nutzer in Ihrer Organisation aktivieren oder deaktivieren möchten, klicken Sie auf Für alle aktiviert oder Für alle deaktiviert und anschließend auf Speichern.

6. Optional: Wenn Sie einen Dienst für eine Organisationseinheit aktivieren oder deaktivieren möchten:

   1. Wählen Sie links die Organisationseinheit aus.
   2. Wenn Sie den Dienststatus ändern möchten, wählen Sie An oder Aus aus.
   3. Wählen Sie eine Option aus:
      • Wenn der Dienststatus auf Übernommen gesetzt ist und Sie die aktualisierte Einstellung beibehalten möchten, auch wenn sich die übergeordnete Einstellung ändert, klicken Sie auf Überschreiben.
      • Wenn der Dienststatus auf Überschrieben festgelegt ist, klicken Sie auf Übernehmen, um die Einstellung des übergeordneten Elements wiederherzustellen, oder auf Speichern, um die neue Einstellung beizubehalten, auch wenn sich die übergeordnete Einstellung ändert.
        Hinweis: Weitere Informationen zur Organisationsstruktur
7. Soll ein Dienst für eine Gruppe von Nutzern aktiviert werden, die sich innerhalb einer Organisationseinheit oder über mehrere verteilt befinden, wählen Sie eine Zugriffsgruppe aus. Weitere Informationen
8. Achten Sie darauf, dass die E-Mail-IDs Ihres HappyFox-Nutzerkontos mit denen in Ihrer Google-Domain übereinstimmen.

Schritt 4: SSO testen

HappyFox unterstützt sowohl die vom Identitätsanbieter (Identity Provider, IdP) als auch die vom Dienstanbieter initiierte SSO. Führen Sie die folgenden Schritte aus, um die SSO in beiden Modi zu bestätigen:

Vom IdP initiiert

1. Melden Sie sich in der Google Admin-Konsole an.

   Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).

2. Gehen Sie in der Admin-Konsole zu „Menü“  AppsWeb- und mobile Apps.
3. Wählen Sie HappyFox aus.
4. Klicken Sie links oben auf SAML-Testanmeldung. 

   HappyFox sollte in einem separaten Tab geöffnet werden. Ist das nicht der Fall, aktualisieren Sie die IdP- und Dienstanbieter-Einstellungen anhand der Informationen in den entsprechenden SAML-Fehlermeldungen und testen Sie die SAML-Anmeldung noch einmal.

Vom Dienstanbieter initiiert

1. Öffnen Sie in einem neuen Inkognitofenster des Browsers Ihre HappyFox-Instanz. Sie werden daraufhin automatisch zur Google Log-in-Seite weitergeleitet.
2. Geben Sie Ihre Anmeldedaten ein. Nach der Authentifizierung werden Sie automatisch zu HappyFox zurückgeleitet.

 

_{Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der Unternehmen, mit denen sie verbunden sind.}