In dit artikel lees je hoe gebruikers toegang kunnen verlenen aan installateurs of andere derden partijen. Het omzeilt ook de noodzaak tot telkens opnieuw inloggen. Dit wordt over het algemeen gebruikt wanneer een partner of installateur een installatie namens de gebruiker wilt beheren of service wilt verlenen.
Lookup Key / Zoeksleutel
We bieden de mogelijkheid om een gebruiker te vragen toestemming te geven aan derden om toegang te krijgen tot hun installatie op basis van een zoeksleutel.
De zoeksleutel is gekoppeld aan een Gebruikersgroep in ons systeem en kan worden gevonden onder het tabblad Details bij een Gebruikersgroep.
Als je geen toegang hebt tot dit scherm, neem dan contact op met uw Zaptec Support.
Toegang verlenen via de Zaptec App
Om de klant jou gebruikersgroep servicetoegang te laten verlenen moet je de gebruiker de volgende stappen zetten:
- Open de Zaptec App
- Ga naar Installaties
- Kies Toegang
- Kies +Toegang toevoegen
- Kies Partner
- Vul de partnercode / zoeksleutel in (zie bovenstaande uitleg)
- Verleen servicetoegang
Toegang verlenen via een URL
Met behulp van deze zoeksleutel kun je een URL genereren en die doorsturen naar de klant/gebruiker zodat deze je gebruikersgroep toegang kan verlenen. De standaard URL is hiervoor: https://portal.zaptec.com/#!/access/request/
Dit werkt alleen voor installaties met de Zaptec Go
Voor het koppelen van een Zaptec Pro installatie moet ook de InstallationId parameter worden meegenomen.
Parameters
Voor het koppelen zijn er enkele parameters die je kant gebruiken, zie onderstaand. Je kan de parameters zoals lang en returnUrl toevoegen aan de URL als dit handig is voor de specifieke integratie.
lookup: de zoeksleutel van de gebruikersgroep waaraan toestemming verleent moet worden.
partnerName: de naam van de partner die om toestemming vraagt.
lang: de taal die je wilt dat gebruikt wordt.
installationId: selecteer de specifieke installatie waaraan toestemming gegeven moet worden.
installationtype: je kan alleen 1 of 0 gebruiken. Standaard wordt er alleen gezocht naar de Zaptec Go 1, maar je kan 0 gebruiken als je ook wilt zoeken naar de Zaptec Pro.
returnUrl: de URL waar je naartoe gaat als je de toegang hebt verleend, indien je deze niet invult dan wordt je doorverwezen naar de standaard pagina: / access / receipt /: success?lookup. Parameters die toegevoegd kunnen worden aan de redirect URL:
- succes: true / false of de toegang is verleend of niet
- installationId: als de toegang is verleend, de ID van de installatie waaraan die is verleend
We zoeken geen gebruikersgroepen op voordat de gebruiker is ingelogd, partnerName moet worden toegevoegd om duidelijk te maken aan de gebruiker welke partner er om toegang vraagt.
Wanneer de gebruiker inlogt, wordt de partner naam bijgewerkt om de juiste naam van de gebruikersgroep weer te geven.
Voorbeeld van een URL
https://portal.zaptec.com/#!/access/request/BSJG?partnerName=Integration