Services externes

Certaines applications ont besoin d’un service extérieur à kvyk.ai : une carte qui charge ses tuiles, ou un service qui trouve les coordonnées d’une adresse. L’application appelle un tel service directement depuis le navigateur de la personne qui l’utilise, si bien que le service reçoit ses requêtes et son adresse IP. C’est pourquoi chaque adresse externe qu’une application appelle figure sur sa page, et qu’un Administrator décide lesquelles Live peut appeler.

Une adresse que l’application n’indique pas est bloquée, en Preview comme sur Live.

Comment une application obtient une adresse externe

Demandez-le à l’assistant dans la conversation de l’application, par exemple Affiche les livraisons sur une carte ou Trouve les coordonnées quand quelqu’un tape une adresse. L’assistant indique chaque adresse externe que l’application appelle, chacune avec la raison pour laquelle elle en a besoin, et fait en sorte que l’application s’en sorte quand un appel échoue.

Essayez-le en Preview

Preview appelle aussitôt les adresses que l’application indique, pour que vous puissiez l’essayer tout de suite. Au-dessus de l’aperçu, la page de l’application dit ce qu’elle utilise que Live n’autorise pas encore, par exemple Utilise nominatim.openstreetmap.org, pas encore autorisée sur Live.

Voir ce qu’une application appelle

Sur la page de l’application, Services externes liste chaque adresse que l’application appelle, avec :

• Pourquoi : la raison que l’application donne ;
• Appelée par : si la version sur Preview, sur Live ou les deux l’appellent, ou Aucune version ne l’appelle quand elle n’est plus utilisée ;
• Sur Live : qui l’a autorisée et quand, ou En attente d’un Administrator.

Autoriser une adresse sur Live

Un service externe que les applications appellent est l’un des services autorisés de votre organisation, la même liste qui dit quels services vos automatisations peuvent appeler. Live laisse une application appeler une adresse dès qu’un Administrator a autorisé cette application sur le service autorisé de l’adresse. Chaque application est autorisée séparément : quand une deuxième application appelle le même service, elle attend sa propre autorisation, et le service reste listé une seule fois.

Un Administrator autorise une application à l’un de ces endroits, et c’est l’approbation :

• Sur la page de l’application, sous Services externes, choisissez Autoriser à côté de l’adresse et confirmez.
• Quand vous publiez une version qui appelle une adresse qu’aucun Administrator n’a encore autorisée, la carte de publication nomme chaque adresse et sa raison, et dit que publier les autorise sur Live. Choisissez Autoriser et publier.
• Sous Technique → Services autorisés, ouvrez le service et choisissez l’application sous Autoriser une app.

Quand aucun service autorisé n’a encore l’adresse, l’autoriser demande le Nom, le Destinataire (l’entreprise derrière le service) et la Finalité du service, et l’ajoute à vos services autorisés.

Quand vous demandez à l’assistant d’autoriser une adresse, il vous demande d’abord de confirmer dans la conversation.

Quand l’application d’un Builder a besoin d’une adresse

Un Builder peut créer et essayer l’application en Preview tout de suite. Quand sa version appelle une adresse que l’application ne peut pas encore appeler sur Live, les Administrators sont sollicités : la demande s’affiche dans leurs Approbations avec l’application, l’adresse et la raison, et chacun reçoit un e-mail comme Autoriser Shop à utiliser nominatim.openstreetmap.org ?. Un Administrator choisit Approuver, en remplissant le service s’il n’existe pas encore, ou Refuser, ce qui la laisse bloquée sur Live.

En attendant, le Builder peut publier tout le reste, mais pas cette version : la carte dit Les Administrators sont invités à autoriser …, et la version continue de fonctionner en Preview.

Chaque autorisation et chaque retrait figure sous Technique → Événements, avec la personne qui l’a fait.

Retirer une autorisation

Sur la page de l’application, choisissez Retirer à côté de l’adresse et confirmez, ou ouvrez le service sous Services autorisés et choisissez Retirer à côté de l’application. Live la bloque aussitôt, de même quand vous retirez le service. Une version qui l’appelle encore attend de nouveau un Administrator avant d’être publiée.

Quand l’application cesse d’appeler une adresse, elle ne l’atteint plus à partir de la prochaine version que vous publiez. L’autorisation reste dans la liste avec Aucune version ne l’appelle, pour que vous puissiez la retirer.

Bon à savoir

• Seuls les appels depuis le navigateur du visiteur sont concernés ici. Les clés d’un service externe vont dans Variables et secrets, jamais dans le code de l’application.
• Les scripts et styles qu’une application charge depuis d’autres sites, comme une fenêtre de discussion, sont listés avec sa version : voir Publier une application.
• Quand votre application n’atteint pas un service, demandez à l’assistant Pourquoi mon application n’atteint-elle pas … ?. Le plus souvent, l’application n’indique pas encore l’adresse, ou Live ne l’autorise pas encore.