In dit artikel:
Embrace x HelloID
Embrace, HelloID & Microsoft 365 – Het complete digitale werkplekportaal
HelloID is een in Nederland gevestigde softwareleverancier die Enterprise-ready Workspace Management en Enterprise Service Catalog-oplossingen maakt. Met de HelloID-integratie toon je applicaties vanuit HelloID direct in Embrace.
Afhankelijk van de rol die je hebt in de organisatie krijg je toegang tot bepaalde applicaties in de softwarecatalogus. Als HelloID is ingesteld kun je automatisch applicaties opstarten en applicaties toevoegen vanaf je Social startpagina. De apps worden aangeboden via de Applicatie launcher. Voor meer informatie, zie: Applicaties (Embrace, Liquit, HelloID) - hoe en wat [add-on]
Embrace is officieel technologiepartner van Tools4Ever, zie: https://www.tools4ever.nl/partner-type/technologiepartners/
Applicatie Launcher
In Social zie je de HelloID-applicaties waar je toegang toe hebt:
De applicatie launcher is alleen zichtbaar als je via HelloID inlogt op Social.
Embrace stelt de integratie in en heeft hiervoor een API key nodig van HelloID. Die vraag je op in de HelloID admin omgeving bij /admin/apikeys. Voeg hier een nieuwe API key toe, of deel bij een bestaande koppeling de key opnieuw.
(Eventueel kan er een IP-restrictie opgegeven worden. Embrace kan hiervoor de IP-adressen aanleveren. Dit heeft echter niet de voorkeur, in de Multi-tenant SaaS omgeving zijn IP-adressen dynamisch.)
Configuratie
Vul in Social Management de volgende gegevens in bij de HelloID-integratie. Alle drie de velden zijn verplicht:
| Veld | Wat vul je in? |
|---|---|
| URL | De HelloID-tenant-URL van de klant, zonder eindslash. Bijvoorbeeld: https://{klantnaam}.helloid.com
|
| Gebruikersnaam | De API-username (apikey) van het serviceaccount dat de klant heeft aangemaakt in HelloID. |
| Wachtwoord | Het bijbehorende API-secret. De ingevoerde waarde wordt versleuteld opgeslagen en is daarna niet meer leesbaar. |
Configuratie valideren en opslaan
- Klik na het invullen van de drie velden op Valideren. De Suite stuurt een testverzoek naar HelloID en geeft direct terug of de URL en credentials werken.
- Bij een succesvolle validatie verschijnt een groene bevestiging. Klik dan op Opslaan om de configuratie vast te leggen.
- Bij een fout verschijnt een rode melding met de foutmelding die HelloID terugstuurt. Veelvoorkomende oorzaken zijn: een typefout in de URL, verkeerde credentials of IP-adressen van de Suite die niet als whitelist zijn opgenomen in HelloID. Pas de waarden aan en valideer opnieuw.
Tip: Gebruik de Valideren-knop ook na een rotatie van het API-secret. Zo voorkom je dat de applicatie launcher bij eindgebruikers leeg blijft.
Een Embrace-medewerker schakelt daarna nog twee opties in voor je tenant.
Authenticatie
HelloID kan worden ingesteld als authenticatiemethode op Social.
Configuratie
De benodigde gegevens stel je in via de HelloID admin portal (/admin, bijvoorbeeld https://malengo-dev001.helloid.com/admin). In de HelloID admin portal maak je Embrace aan als applicatie. Hiervoor is een template beschikbaar in HelloID. De gegevens die je nodig hebt voor de Embrace-configuratie vind je daar.
Embrace heeft de issuer, het ClientID en de Secret Value nodig om de configuratie af te ronden.
Voorbeeld format issuer:
https://embrace.helloid.com/oauth2/v2/6fh00d-71dh9-4500-b509-6fd00ef5b1h5