Cloud-app HappyFox

Met de standaard Security Assertion Markup Language 2.0 (SAML) kunt u Single sign-on (SSO) instellen voor een aantal cloud-apps. Nadat u SSO heeft ingesteld, kunnen uw gebruikers hun Google Workspace-inloggegevens gebruiken om met SSO in te loggen bij een app.

SAML gebruiken om SSO in te stellen voor HappyFox

Alles uitvouwen  |  Alles samenvouwen

U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.

Stap 1: Google instellen als SAML-identiteitsprovider (IdP)

1. Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.

   Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.

2. Ga naar Menu  Apps > Web- en mobiele apps.
3. Klik op App toevoegenApps zoeken.
4. Voer HappyFox in bij Voer de app-naam in.
5. Plaats in de zoekresultaten de muisaanwijzer op HappyFox en klik op Selecteren.
6. Doe het volgende in het venster Gegevens Google-identiteitsprovider bij Optie 2: De SSO-URL, de entiteits-ID en het certificaat kopiëren:
   1. Klik naast SSO-URL op Kopiëren en sla de URL op.
   2. Klik naast Certificaat op Kopiëren en sla het certificaat op.
      U heeft deze gegevens nodig om de installatie af te ronden in HappyFox.
7. Klik op Doorgaan.
8. Vervang op de pagina Serviceprovidergegevens {subdomain} voor ACS-URL en Entiteits-ID door uw HappyFox-subdomein.
9. Klik op Doorgaan.
10. (Optioneel) Ga als volgt te werk om Google-directorykenmerken toe te wijzen aan de overeenkomstige app-kenmerken in het venster Kenmerktoewijzing:

    1. Klik op Toewijzing toevoegen.
    2. Klik op Veld selecterenselecteer een Google-directorykenmerk.
    3. Voer bij App-kenmerken het bijbehorende app-kenmerk in.
11. (Optioneel) Groepsnamen invoeren die relevant zijn voor deze app:

    1. Klik bij Groepslidmaatschap (optioneel) op Zoeken naar een groep. Voer een of meer letters van de groepsnaam in en selecteer de groepsnaam.
    2. Voeg naar wens extra groepen toe (maximaal 75 groepen).
    3. Voer bij App-kenmerk de naam in van het groepskenmerk van de bijbehorende serviceprovider.

    Ongeacht de hoeveelheid groepsnamen die u invult, bevat de SAML-reactie alleen groepen waarvan een gebruiker lid is (direct of indirect). Ga voor meer informatie naar Over het toewijzen van groepslidmaatschappen.

12. Klik op Voltooien.

Stap 2: HappyFox instellen als SAML 2.0-serviceprovider

1. Open een incognitovenster. Ga naar de HappyFox-inlogpagina en log in met uw HappyFox-beheerdersaccount.
2. Ga naar https://<your_account_name>.happyfox.com/staff/manage/integrations/auth/saml.
3. Voer de volgende stappen uit met de informatie die u in stap 1 heeft gekopieerd:
   1. Plak het certificaat bij IdP Signature (IdP-handtekening).
   2. Plak de SSO-URL bij SSO Target URL (Doel-URL SSO).
4. Kies de opties die u wilt gebruiken
5. Klik op Instellingen opslaan.

Stap 3: De app activeren voor gebruikers

Voordat u begint: als u de service wilt in- of uitschakelen voor bepaalde gebruikers, plaatst u hun accounts in een organisatie-eenheid (om de toegang te beheren per afdeling) of in een toegangsgroep (om de toegang te beheren voor gebruikers in verschillende afdelingen).

1. Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.

   Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.

2. Ga naar Menu  Apps > Web- en mobiele apps.
3. Klik op HappyFox.
4. Klik op Gebruikerstoegang.

5. Als u een service wilt aan- of uitzetten voor iedereen in uw organisatie, klikt u op Aan voor iedereen of Uit voor iedereen. Klik dan op Opslaan.

6. (Optioneel) Zo zet u service aan of uit voor een organisatie-eenheid:

   1. Selecteer links de organisatie-eenheid.
   2. Selecteer Aan of Uit om de servicestatus te wijzigen.
   3. Kies een van deze opties:
      • Als de servicestatus is ingesteld op Overgenomen en u de geüpdatete instelling wilt behouden, zelfs als de instelling voor de bovenliggende organisatie-eenheid wordt gewijzigd, klikt u op Overschrijven.
      • Als de servicestatus is ingesteld op Overschrijven, klikt u op Overnemen om de instelling hetzelfde te maken als de instelling voor de bovenliggende organisatie-eenheid, of op Opslaan om de nieuwe instelling te behouden, zelfs als de instelling voor de bovenliggende organisatie-eenheid wordt gewijzigd.
        Meer informatie over de organisatiestructuur.
7. (Optioneel) Als u een service wilt aanzetten voor een groep gebruikers binnen een organisatie-eenheid of in verschillende organisatie-eenheden, selecteert u een toegangsgroep. Ga naar Toegang tot services aanpassen met toegangsgroepen voor meer informatie.
8. Zorg dat de e-maildomeinen van uw HappyFox-gebruikersaccount overeenkomen met het hoofddomein van het beheerde Google-account van uw organisatie.

Stap 4: Controleren of SSO werkt

HappyFox ondersteunt zowel door de identiteitsprovider gestarte als door de serviceprovider gestarte SSO.

Door de identiteitsprovider gestarte SSO verifiëren

1. Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.

   Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.

2. Ga naar Menu  Apps > Web- en mobiele apps.
3. Klik op HappyFox.
4. Klik in het gedeelte HappyFox op SAML-login testen.

   De app wordt geopend op een nieuw tabblad. Als dit niet het geval is, lost u de foutmelding op en probeert u het opnieuw. Ga naar Foutmeldingen voor SAML-apps voor meer informatie over hoe u problemen oplost.

Door de serviceprovider gestarte SSO verifiëren

1. Sluit alle browservensters.
2. Ga in een nieuw incognito browservenster naar de inlogpagina van HappyFox en log in met uw HappyFox-beheerdersaccount.
   Als het goed is, wordt u doorgestuurd naar de inlogpagina van Google.
3. Selecteer uw account en voer uw wachtwoord in.

Nadat uw inloggegevens zijn geverifieerd, wordt de app geopend.

_{Google, Google Workspace en de gerelateerde merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waarmee ze in verband worden gebracht.}