Ces opérations sont uniquement nécessaires pour les clients qui utilisent leur propre instance Actility. Si vous utilisez la connectivité Actility de Kheiron, vous n'avez pas besoin de procéder.

À la fin de 2025, Actility dépréciera complètement son API DX. Aujourd'hui, certains services sont déjà dépréciés, ce qui a créé un nombre important de problèmes dans les applications actuelles. Beaucoup d'entre vous ont été affectés par cela, c'est la raison pour laquelle nous lançons cette communication. 

Nous avons mis en place la nouvelle version de l'endpoint Actility, qui résoudra tous ces problèmes dans la prochaine mise à jour en attente de la plateforme.

Lors de la sortie de cette mise à jour, nous vous recommandons de respecter certaines exigences pour garantir que la migration se déroulera sans accroc. 

Pré-requis

Créer un compte de service

Dans la nouvelle version d'Actility, vous n'utiliserez plus un compte utilisateur. Vous configurerez à la place un "compte de service". Pour en créer un, suivez ces étapes :

Accédez à votre interface Actility, cliquez sur "Administration" puis sur "Comptes de service"

Une fenêtre s'ouvrira, en haut à droite, cliquez sur "ajouter un compte de service" :

 Un nouveau formulaire apparaîtra :

Description des champs :

• Nom : nom du compte de service
• ID client : identifiant unique défini pour le compte de service
• Restrictions de domaine : restreindre le compte de service à une liste de domaines.
• Rôles : sélectionnez les rôles associés au compte de service. Doit être Administrateur.

Remplissez les différents champs selon vos besoins et cliquez sur ajouter. Si vous le restreignez à un domaine, assurez-vous que votre endpoint utilisera ce domaine.

Lorsque votre compte de service est créé, le secret client sera affiché (également appelé clé du compte de service) : 

Attention : la clé du compte de service ne sera plus accessible une fois générée. Vous devez la conserver quelque part de votre côté. 
 

Vérifiez vos domaines

Pour utiliser les nouvelles APIs, il est nécessaire d'avoir créé des groupes et des domaines dans le backend Actility. Pour mieux comprendre, un groupe peut contenir plusieurs domaines. 
Dans la nouvelle version de l'endpoint Actility, vous pourrez créer un endpoint pour un groupe. Le endpoint peut ensuite sélectionner plusieurs domaines selon la configuration du groupe.

Exemple : 

IOTHINK SHOWROOM est le groupe qui contient deux domaines : 

• IOTHINK SHOWROOM
• IOTHINK_SHOWROOM 

Si vous utilisez ce groupe dans un endpoint, vous devrez créer un second endpoint pour le groupe et le domaine IOTHINK TRAINING.

Vérifiez que votre ancienne configuration utilise ces groupes et domaines. Si vous n'avez aucun domaine appliqué à vos appareils, ils ne seront pas affichés dans vos points de terminaison.

Comment migrer

Lorsque nous publierons la nouvelle version du code Actility, une nouvelle interface sera accessible si l'endpoint est sur l'ancienne version. 

Un badge "Action requise" (comme pour Enedis & GRDF) sera disponible dans l'interface :

Lorsque le client cliquera sur ce badge, il sera redirigé vers l'interface pour saisir l'ID et la clé du compte de service, comme montré ci-dessous :

Une fois les nouvelles informations d'identification renseignées, vous pourrez lancer le processus de migration. 

À la fin du processus de migration, l'endpoint sera migré vers la nouvelle version sans aucun badge visible, et vous pourrez continuer à l'utiliser sans problème. 

Si un message d'erreur apparaît lorsque le client tente la migration, ce message provient principalement de l'API Actility répondant avec un code invalide, car nous vérifions que vos informations d'identification sont valides. Il est possible que vous ne compreniez pas ce qui se passe dans le message. Si cela arrive, n'hésitez pas à ouvrir un ticket.

Attention : Si l'endpoint n'est pas migré, le client ne pourra pas lister les appareils sur son endpoint ni effectuer d'autres opérations (comme ajouter plus d'appareils). 

Modifications sur l'endpoint lui-même

• L'interface a été retravaillée et est désormais plus simple. La sélection du type n'est plus nécessaire (Sans fil ou Entreprise). L'URL personnalisée est gérée via le champ personnalisé dans le menu déroulant "Tenant". 
• La gestion des groupes et des domaines se fait en deux étapes. La première étape est la configuration de l'endpoint, la seconde est la configuration des groupes et des domaines. Lors de la migration de l'endpoint, les groupes et domaines existants seront migrés vers la nouvelle structure. Rien ne changera pour vous à moins que vous n'ayez eu aucun domaine auparavant.
• Le profil URL et l'API n'ont plus besoin d'être fournis. Les services ciblent le même point d'entrée d'Actility, donc une simple sélection de la "localisation" du Tenant suffit.

Tous les autres éléments restent les mêmes qu'avant. Aucune fonctionnalité n'a été dépréciée de notre côté pour Actility.