Dans le cas où un partenaire de service, ou tout autre tiers externe, souhaite avoir un contrôle à distance sur une installation Zaptec, il doit obtenir une autorisation du Propriétaire de l'installation.
Ces accès à distance sont généralement utilisés par les partenaires de services qui agisse au nom et pour le compte du propriétaire, ou lorsque l'installation est intégrée à une plateforme tierce via une intégration par API / OCPP. Ces partenaires de services peuvent avoir un accès afin de pouvoir apporter des modifications à l'installation, telles que le changement de serveur OCPP, le déménagement ou la configuration électrique, etc.
Le Propriétaire peut accorder cette autorisation depuis son compte Zaptec Portal, mais il se peut qu'il ne connaisse pas parfaitement le Zaptec Portal pour réaliser cette action.
Dans ce cas, le partenaire de service, peut simplifier la procédure pour le Propriétaire : cet article explique comment le partenaire de service peut demander à un Propriétaire l'accès à son installation en lui envoyant une adresse URL personnalisée.
Clé de recherche
Nous offrons la possibilité de demander à un Propriétaire l'accès à son installation grâce à une clé de recherche.
Dans le Zaptec Portal, la clé de recherche est associée à un groupe d'utilisateurs. Dans notre exemple, le groupe d'utilisateurs regroupent l'ensemble des employés du partenaire de service qui ont besoin d'un accès à l'installation.
Cette clé de recherche est indiquée en se rendant dans le menu Groupe d'utilisateurs. La clé de recherche est indiquée dans l'onglet "Détails", à coté du nom du groupe d'utilisateur. La clé de recherche est composé de 4 caractères alphanumériques.
Si vous n'avez pas accès à cette page, veuillez contacter le support Zaptec.
A l'aide de cette clé de recherche, vous allez pouvoir créer l'URL à envoyer au Propriétaire de l'installation afin que celui-ci vous accorde un accès Service en un clic.
L'URL commencera par https://portal.zaptec.com/#!/access/request/ , et vous ajouterez les paramètres décrits dans la suite de l'article. A minima l'URL doit contenir :
- la Clé de recherche quand il s'agit d'une installation Zaptec Go
- la Clé de recherche et l'installationId pour une installation Zaptec Pro
Exemple: https://portal.zaptec.com/#!/access/request/[4 caractères de la clé de recherche]?partnerName=[Nom du Partenaire]&installationId=[identifiant de l'installation]
Une fois l'URL crée, transmettez là au Propriétaire de l'installation. Il pourra alors se connecter avec ses identifiant Zaptec Portal et vous donner l'autorisation Service sur son installation.
Paramètres
Vous pouvez ajouter des paramètres comme la langue et returnUrl (URL de retour) si vous avez besoin ou souhaitez les spécifier pour votre intégration.
Clé de recherche: la clé de recherche du groupe demandant la permission. Après la connexion, le nom du groupe est affiché en tant que demandeur de l'autorisation.
partnerName : le nom à afficher en tant que demandeur de permission avant que l'utilisateur ne se connecte et que nous puissions afficher le nom du groupe approprié.
langue : la langue à utiliser dans les messages affichés au Propriétaire, "fr" (français) et "en" (anglais)
installationId : l'identifiant de l'installation (utile pour une demande d'accès à une installation Zaptec Pro).
returnUrl : l'URL vers laquelle revenir après avoir terminé le processus. Si elle n'est pas fournie, nous redirigerons vers la page de reçu intégrée : /access/receipt/:success?lookup. Paramètres ajoutés à l'URL de redirection :
-
success : true (vrai) / false (faux), indiquant si l'accès a été accordé ou non.
-
installationId : si l'accès a été accordé, l'ID de l'installation à laquelle l'accès a été accordé.
Nous ne recherchons pas les groupes d'utilisateurs avant que l'utilisateur ne se connecte. Nous recommandons de paramétrer le partnerName afin que le nom du partenaire de service s'affiche clairement pour le Propriétaire. Lorsque le Propriétaire se connecte, le nom du partenaire sera mis à jour pour refléter le nom approprié du groupe d'utilisateurs.
Exemple
https://portal.zaptec.com/#!/access/request/BSJG?partnerName=Partenaire%20de%20Service&lang=fr