Comment accéder à votre espace Asterio

1. Création de votre compte Asteriomod

Rendez-vous sur notre page Commande et sélectionnez le module que vous souhaitez activer en premier. La création de compte est intégrée au parcours de commande : quatre champs suffisent — nom complet, adresse e-mail professionnelle, raison sociale et, pour les entités assujetties, numéro de TVA intracommunautaire. Nous ne stockons aucun mot de passe. L’accès à votre espace client se fait exclusivement par lien magique envoyé à votre adresse e-mail. Ce choix élimine toute une classe d’incidents de sécurité liés à la réutilisation de mots de passe ou aux fuites de bases externes.

Cochez l’acceptation des Conditions générales, de la politique de confidentialité et du DPA, puis validez. Le paiement s’effectue immédiatement pour la première mensualité, au prorata du jour d’activation. Vous recevez dans les deux minutes un e-mail de confirmation contenant votre numéro de dossier au format AS-XXXX et un premier lien d’accès valable 24 heures.

Si vous ne recevez pas cet e-mail, vérifiez le dossier spam de votre messagerie et l’exactitude de l’adresse saisie. Vous pouvez aussi demander un nouvel envoi depuis la page Accès en indiquant simplement votre adresse e-mail.

2. Réception et compréhension de votre e-mail d’accès

L’e-mail que vous recevez contient trois informations essentielles. D’abord, votre référence de dossier, qui vous sera demandée pour toute interaction avec notre support. Ensuite, le lien magique d’accès à votre espace : il est à usage unique et expire au bout de 24 heures ; un nouveau lien peut être demandé à tout moment. Enfin, un récapitulatif du module commandé, du montant prélevé et de la prochaine échéance mensuelle.

Un second e-mail vous sera adressé environ quinze minutes plus tard pour confirmer que votre module est provisionné et prêt à être configuré. C’est à ce moment que vous devez ouvrir votre espace client pour poursuivre la configuration.

3. Connexion à votre espace via /login

Rendez-vous sur /login, saisissez votre adresse e-mail professionnelle et cliquez sur « Envoyer un lien de connexion ». Vous recevrez immédiatement un nouveau lien magique. En cliquant dessus, vous êtes authentifié pour une session qui dure 8 heures d’inactivité. Aucun mot de passe n’est requis. Chaque connexion est journalisée avec date, heure, adresse IP et agent utilisateur, consultable dans la section « Sécurité » de votre espace.

Si vous partagez la gestion avec des collègues, ajoutez chaque utilisateur autorisé depuis « Paramètres → Membres de l’équipe ». Vous pouvez leur attribuer un rôle fin : lecture seule, écriture, facturation, sécurité. Chaque utilisateur se connecte avec sa propre adresse e-mail et son propre lien magique. Nous recommandons de créer un compte nominatif par personne plutôt qu’un compte partagé, afin que les journaux d’audit soient exploitables.

4. Génération d’une clé API Asterio dans votre PMS

Ouvrez votre PMS Asterio dans un onglet séparé. Rendez-vous dans Paramètres → API → Clés d’intégration. Cliquez sur le bouton « Générer une clé ». Une fenêtre s’ouvre : donnez à la clé un nom explicite qui permettra de l’identifier facilement dans les journaux Asterio et dans notre espace. Nous recommandons la convention « ABS — nom du module — environnement », par exemple « ABS — Facture PDF — Prod ».

Sélectionnez les scopes minimaux nécessaires au module concerné. La documentation embarquée de chaque module Asteriomod précise la liste exacte des scopes requis. N’accordez pas plus de permissions que nécessaire : le principe du moindre privilège est un pilier de sécurité.

Cliquez sur « Créer ». La valeur complète de la clé n’est affichée qu’une seule fois, dans une fenêtre modale. Copiez-la immédiatement dans le presse-papier ou un gestionnaire de mots de passe temporaire. Si vous fermez la fenêtre sans copier la valeur, il faudra régénérer une nouvelle clé.

5. Ajout de la clé dans notre plateforme Asteriomod

Revenez dans votre espace Asteriomod. Ouvrez la fiche du module que vous venez d’acheter (statut « À configurer »). L’assistant s’ouvre sur le premier des trois panneaux : Connexion Asterio.

Collez la clé dans le champ « Clé API Asterio ». Saisissez ensuite l’identifiant de propriété (property id), qui figure juste au-dessus du bloc Clés dans votre compte Asterio, sous la forme d’une chaîne alphanumérique de 12 caractères. Si vous gérez plusieurs propriétés dans Asterio, vous verrez apparaître un menu déroulant : sélectionnez la propriété cible pour ce module.

Cliquez sur « Vérifier la connexion ». Un contrôle en trois points s’exécute en moins de dix secondes : validité cryptographique de la clé (elle appartient bien à Asterio et n’est pas révoquée), autorisations attribuées (les scopes couvrent-ils bien les besoins du module ?), latence moyenne (temps de réponse observé sur trois requêtes de test). Un feu vert confirme que la connexion est prête ; les points en jaune ou rouge affichent un message expliquant précisément la correction à apporter.

Une fois la connexion validée, la clé est chiffrée au niveau applicatif (AES-256) et stockée dans notre base. Seul son préfixe (les six premiers caractères) reste visible dans votre espace pour vous permettre de l’identifier. Vous ne verrez plus jamais la valeur complète, comme dans Asterio lui-même.

6. Bascule en production et suivi

Passez au deuxième panneau (Paramètres du module), acceptez les valeurs par défaut si vous configurez votre premier module, puis ouvrez le troisième panneau et lancez « Test de bout en bout ». Le module tire un jeu de données réel (une ou deux réservations récentes selon le module), applique sa logique et vous montre le résultat à l’écran. Aucune écriture n’est encore effectuée dans Asterio à ce stade. Si le résultat est conforme à vos attentes, cliquez sur « Activer en production ». Le module bascule au statut « Actif » et la première synchronisation complète démarre dans les quinze minutes.

Suivez ensuite l’activité depuis la page « Journaux API » de votre espace, qui affiche par heure le nombre d’appels réussis, ralentis ou rejetés, la latence moyenne et le détail de chaque requête. Un tableau de bord « Santé de la connexion » affiche un score global qui doit rester supérieur à 98 % en régime normal.

7. Dépannage — les problèmes les plus fréquents

« La clé est invalide » à la vérification. La clé a été révoquée dans Asterio ou mal recopiée (espace en début ou en fin de la chaîne). Retournez dans Asterio, générez une nouvelle clé et recopiez-la sans espace. Vérifiez qu’il s’agit bien du compte Asterio associé à la propriété cible et non d’un autre compte du groupe.

« Scope insuffisant » sur un endpoint précis. Le module utilise une capacité pour laquelle la clé n’a pas les droits. Ouvrez la fiche du module dans notre espace, consultez la liste « Scopes requis » et régénérez une clé dans Asterio avec les autorisations complètes.

« Quota dépassé — 429 Too Many Requests ». L’API Asterio limite le nombre d’appels par clé et par minute. Vérifiez que vous n’avez pas plusieurs modules qui synchronisent simultanément à la même minute. Depuis l’espace client, vous pouvez décaler l’heure de synchronisation d’un module secondaire de quelques minutes pour lisser la charge.

« Horodatage désynchronisé ». Une machine locale mal synchronisée par NTP provoque des rejets de signatures. Le message d’erreur mentionne un delta de temps supérieur à 30 secondes. Vérifiez votre configuration NTP.

Pas d’activité dans les journaux malgré la validation. Le module est peut-être en pause. Ouvrez la fiche dans votre espace et vérifiez que le statut est bien « Actif » et non « En pause » ou « À configurer ». Un module peut être basculé automatiquement en pause si un incident bloquant persiste plus d’une heure ; un e-mail vous est alors envoyé.

Aide supplémentaire

Si le problème persiste après avoir suivi ces étapes, écrivez à support@asteriomod.org en indiquant votre référence de dossier (AS-XXXX), le nom du module concerné et une capture d’écran du message d’erreur ou de la ligne de journal correspondante. Notre équipe répond sous 24 heures ouvrées, et immédiatement pour les incidents critiques signalés en objet du message.