Assistance

C’est un projet d’une seule personne. Cela veut dire que vous aurez une vraie réponse de quelqu’un qui connaît le code, et que cela peut prendre quelques jours.

Avant d’écrire

La FAQ couvre ce sur quoi on bute le plus : la porte qui n’est pas trouvée, le relais qui semble basculer, Bonjour qui ne découvre pas le bridge, et ce qui fonctionne à distance. Deux minutes bien employées.

Comment nous joindre

Par e-mail : support@garageopener.app. Les bugs et les questions d’installation sont aussi les bienvenus en issues et discussions GitHub sur le dépôt du bridge, généralement la voie la plus rapide.

Quoi joindre

Presque toutes les questions se ramènent à ces cinq éléments. Les envoyer d’emblée transforme généralement trois échanges en un seul :

Ce que le bridge dit de lui-même. La sortie de curl -s http://<hôte-du-bridge>:8787/healthz. Si vous n’utilisez pas de bridge, précisez-le.
Votre version de Protect. Console → Réglages → Système, ou le champ applicationVersion dans la sortie ci-dessus.
La version de l’app. Dans les Réglages, tout en bas.
Les modèles de votre relais et de votre capteur, et la configuration de la sortie du relais (Pulse ou non, et sa durée d’impulsion).
Ce que vous attendiez et ce qui s’est passé, avec les heures approximatives, pour pouvoir recouper avec le journal d’activité.

Merci de masquer votre clé d’API, vos jetons de bridge et votre secret de webhook avant d’envoyer quoi que ce soit. /healthz ne les contient pas, mais les journaux du conteneur en mode debug peuvent les contenir.

Limites connues

Une porte par bridge. Plusieurs portes ne sont pas prises en charge.
UniFi Protect uniquement. Les autres relais, les autres hubs et Home Assistant sont hors périmètre.
iOS et watchOS uniquement. Il n’y a pas d’app Android et il n’en est pas prévu.
Une porte arrêtée est lue comme ouverte. Un capteur d’inclinaison rapporte le même contact pour une porte arrêtée à mi-course et pour une porte grande ouverte ; l’app mémorise donc le sens plutôt que de prétendre le mesurer.
Les alertes cloud ne peuvent pas fermer la porte. Le service ne détient aucun identifiant vers votre console ; « Fermer maintenant » est exécuté par l’app, via votre propre connexion.
Un webhook perdu ressemble à une porte ouverte. Si votre console n’envoie jamais l’événement « fermée », les alertes cloud continuent de la croire ouverte, d’où la formulation « a signalé ».
Protect peut changer. Ubiquiti peut modifier l’API d’intégration à tout moment ; le cas échéant, les choses cassent jusqu’à une mise à jour.

Signaler un problème de sécurité

Si vous avez trouvé une faille, écrivez à support@garageopener.app avec « security » en objet, et merci de ne pas la publier d’abord. Vous recevrez un accusé de réception, et le crédit si vous le souhaitez.