🔐 Configuration OAuth
OAuth est une méthode d'authentification sécurisée qui permet à PVReactive d'accéder à vos données FusionSolar et Sungrow sans stocker vos mots de passe.
Qu'est-ce qu'OAuth ?
Pourquoi utiliser OAuth ?
Plus Sécurisé
Vos identifiants FusionSolar/Sungrow ne sont jamais stockés dans PVReactive. Seuls des tokens temporaires sont utilisés.
Limites API Supérieures
OAuth offre des quotas d'API 2x plus élevés pour FusionSolar (100 appels/h vs 50 appels/h en mode credentials).
Renouvellement Automatique
Les tokens OAuth se renouvellent automatiquement. Vous n'avez rien à faire dans la majorité des cas.
Contrôle des Permissions
Vous contrôlez exactement quelles installations PVReactive peut consulter.
Quand utiliser OAuth ?
| Fournisseur | OAuth | Credentials | Recommandation |
|---|---|---|---|
| FusionSolar (Huawei) |
Disponible
100 appels/h
|
Disponible
50 appels/h
|
OAuth si >50 installations Credentials acceptable pour petits parcs |
| Sungrow |
Disponible
2000 appels/h
|
Non supporté |
OAuth obligatoire Seule méthode disponible |
Important Sungrow
Configuration OAuth FusionSolar
Suivez ces étapes pour configurer OAuth avec votre compte FusionSolar :
Accéder à la configuration du client
Dans l'interface d'administration PVReactive :
- Cliquez sur "Clients" dans le menu principal
- Trouvez le client à configurer
- Cliquez sur le bouton "Modifier" ()
Sélectionner OAuth
Dans le formulaire d'édition du client :
- Localisez la section "FusionSolar"
- Dans le champ "Type d'authentification", sélectionnez "OAuth"
- Cliquez sur le bouton "Authorize OAuth" qui apparaît
Autoriser l'accès sur FusionSolar
Vous serez automatiquement redirigé vers le portail FusionSolar :
- Connectez-vous avec vos identifiants FusionSolar
- Sélectionnez les installations que PVReactive pourra surveiller
- Cochez toutes les installations souhaitées
- Cliquez sur "Accepter" ou "Authorize"
Astuce
Redirection et confirmation
Après autorisation :
- Vous êtes automatiquement redirigé vers PVReactive
- Un message de confirmation apparaît
- Les tokens OAuth sont sauvegardés automatiquement
- La synchronisation des installations démarre
Configuration terminée ! Vos installations FusionSolar seront synchronisées automatiquement.
Configuration OAuth Sungrow
Le processus pour Sungrow est similaire mais avec quelques spécificités :
Accéder à la configuration du client
Identique à FusionSolar :
- Menu "Clients"
- Bouton "Modifier" sur le client
Démarrer l'autorisation Sungrow
Dans le formulaire d'édition :
- Localisez la section "Sungrow OAuth"
- Cliquez sur le bouton "Start Authorization"
Autoriser sur iSolarCloud
Redirection vers le portail iSolarCloud (Sungrow) :
- Connectez-vous avec vos identifiants Sungrow
- Sélectionnez les installations à autoriser
- Important : Cochez la case "I have read and agreed to the Developer portal privacy policy"
- Cliquez sur "Confirm" ou "授权" (Autoriser en chinois)
Attention
Confirmation
Une fois autorisé :
- Redirection automatique vers PVReactive
- Message de confirmation
- Synchronisation automatique des installations Sungrow
Gestion et Renouvellement des Tokens
Renouvellement Automatique
Les tokens OAuth ont une durée de vie limitée, mais PVReactive les renouvelle automatiquement :
Processus Automatique
- FusionSolar : Les tokens se renouvellent automatiquement 30 minutes avant expiration. Vous n'avez rien à faire.
- Sungrow : Renouvellement automatique dès que nécessaire. Transparent pour vous.
Que faire si un token expire ?
Dans de rares cas, le renouvellement automatique peut échouer. Vous verrez alors un message d'erreur :
❌ OAuth tokens expired - Manual OAuth renewal required
ou dans les logs : OAUTH_EXPIRED
Solution simple :
- Retournez dans l'édition de votre client (Admin > Clients > Modifier)
- Cliquez à nouveau sur "Authorize OAuth" (FusionSolar) ou "Start Authorization" (Sungrow)
- Refaites le processus d'autorisation comme lors de la configuration initiale
- La synchronisation reprendra automatiquement
Fréquence
Vérifier l'État de votre Configuration OAuth
Pour vérifier si votre OAuth est correctement configuré :
Indicateurs de Configuration Réussie
Si vos installations apparaissent dans le dashboard, OAuth fonctionne
La production actuelle (kW) se met à jour toutes les 15 minutes
Aucun message "OAuth expired" ou "Authorization failed"
Dépannage OAuth
Problème : "Authorization failed" lors de l'autorisation
Solutions :
- ✅ Vérifiez que vos identifiants FusionSolar/Sungrow sont corrects
- ✅ Assurez-vous d'avoir sélectionné au moins une installation
- ✅ Acceptez toutes les permissions demandées
- ✅ Pour Sungrow : N'oubliez pas la case "privacy policy"
Problème : Aucune installation visible après OAuth
Solutions :
- ✅ Vérifiez que vous avez bien coché vos installations lors de l'autorisation
- ✅ Retournez dans l'édition du client et réautorisez en sélectionnant les bonnes stations
- ✅ Attendez 5-10 minutes pour la première synchronisation
Problème : Message "OAuth expired" dans les logs
Solutions :
- ✅ Éditez votre client dans l'admin
- ✅ Cliquez à nouveau sur "Authorize OAuth"
- ✅ Refaites le processus d'autorisation
- ✅ La synchronisation reprendra automatiquement
Problème : Redirection en boucle ou erreur de callback
Solutions :
- ✅ Videz le cache de votre navigateur
- ✅ Essayez en navigation privée
- ✅ Vérifiez que votre compte FusionSolar/Sungrow est actif
- ✅ Contactez le support si le problème persiste
Comparaison Détaillée : OAuth vs Credentials (FusionSolar)
Pour FusionSolar, vous avez le choix entre deux méthodes. Voici un comparatif détaillé :
| Critère | Credentials (User/Password) | OAuth |
|---|---|---|
| Configuration | Simple : Saisie user/password dans le formulaire | Processus d'autorisation web (3-4 clics) |
| Sécurité | Mot de passe stocké (chiffré) dans la base de données |
✓ Pas de mot de passe stocké Tokens temporaires uniquement |
| Limites API | 50 appels par heure | ✓ 100 appels par heure (2x plus) |
| Maintenance |
Aucune maintenance Changer le mot de passe si nécessaire |
Renouvellement automatique Rare réautorisation manuelle |
| Recommandé pour |
Petits parcs < 50 installations |
✓ Parcs importants > 50 installations |
| Changement de mot de passe | Nécessite mise à jour dans PVReactive |
✓ Aucun impact Les tokens restent valides |
Recommandation
Privilégiez OAuth si vous avez plus de 50 installations ou si vous souhaitez une sécurité maximale. Pour les petits parcs (< 50 installations), les credentials sont suffisants et plus simples à configurer.
Questions Fréquentes OAuth
Puis-je passer de credentials à OAuth (ou inversement) ?
Oui ! Dans l'édition de votre client, changez simplement le type d'authentification FusionSolar. Les données précédentes sont conservées. Cependant, Sungrow est OAuth uniquement, pas de migration possible.
Que se passe-t-il si je change mon mot de passe FusionSolar/Sungrow ?
Avec OAuth, aucun impact ! Les tokens OAuth restent valides même si vous changez votre mot de passe sur le portail FusionSolar ou Sungrow. C'est l'un des avantages majeurs d'OAuth.
Puis-je révoquer l'accès OAuth ?
Oui, depuis votre compte FusionSolar ou Sungrow, vous pouvez révoquer les autorisations données à PVReactive. Dans ce cas, vous devrez réautoriser depuis l'interface PVReactive pour rétablir la synchronisation.
Combien de temps les tokens OAuth sont-ils valides ?
Les tokens ont généralement une durée de vie de plusieurs semaines à plusieurs mois. Mais vous n'avez pas à vous en soucier : PVReactive les renouvelle automatiquement avant expiration.
OAuth fonctionne-t-il avec tous les comptes FusionSolar/Sungrow ?
Oui, OAuth fonctionne avec tous les types de comptes (installateur, propriétaire, gestionnaire). Assurez-vous simplement d'avoir accès aux installations que vous souhaitez monitorer.
Besoin d'Aide ?
Support Technique
Si vous rencontrez des difficultés avec la configuration OAuth ou si vous avez des questions, notre équipe support est là pour vous aider.
Email Support
contact@pvreactive.comHoraires
Lundi - Vendredi
9h00 - 18h00