
Er is meer dan de app: lokale toegang tot de Envoy
(Envoy: tegenwoordig IQ Gateway genoemd)Degene die net als ik een PV-systeem van Enphase hebben, halen de meeste informatie uit de online omgeving Enlighten, of via de app, welke gevoed wordt door de Envoy. Voor de doorsnee gebruiker is dat prima informatie, maar wij tweakers willen altijd meer! Tijdens mijn zoektocht naar de firmware versie van mijn micro omvormers, welke standaard niet zichtbaar zijn in Enlighten of in de Installer Toolkit, stuitte ik op een website / blog waar iemand verschillende pagina's met data van je PV-systeem vanuit de Envoy bespreekt. Sommige als webpagina's, anderen in .json-formaat.
Een aantal van deze pagina's zijn vrij toegankelijk, d.w.z. benaderbaar via je webbrower in het lokale netwerk, zonder inloggegevens. Een bekende is http://envoy/home (envoy vervangen door het lokale ip-adres van de Envoy). Deze geeft een configuratieoverzicht van je PV-systeem (klik voor voorbeeld), met o.a. de huidige productie en eventuele consumptie. Verder kan je er weinig.
Wachtwoord voor lokale toegang tot Envoy-S firmware v5
Echter is er ook een installateurs deel van de API, te weten op http://envoy/installer/setup/home. Maar daar heb je een gebruikersnaam en wachtwoord voor nodig. En dat zijn niet de gegevens die je gebruikt om in te loggen bij Enlighten. Maar laat daar nou een manier voor zijn om achter dat wachtwoord van je Envoy te komen!Dit kan met een app te downloaden op deze dropbox omgeving of met een website. Beide zijn heel eenvoudig en kunnen op basis van je serienummer het wachtwoord geven. De bijbehorende gebruikersnaam die je nodig hebt bij het inloggen in de Envoy is dan installer. De beste man van het eerder genoemde blog heeft een reverse engineering van de Installer Toolkit gedaan, waarna hij de app heeft gemaakt:
Nu schijnt het te zijn, maar dat kan ik niet testen, dat de inloggegevens voor de oudere Envoy (non-S) als gebruikersnaam het serienummer hebben, en als wachtwoord de laatste 6 cijfers van dat serienummer (wellicht dat iemand met een ouder type Envoy dat kan bevestigen?). Dit werkt niet bij de Envoy-S of -S Metered.
Wat kun je met deze lokale toegang?
Goed, samen met de gebruikersnaam installer en het wachtwoord kan je nu wel toegang krijgen tot http://envoy/installer/setup/home. In feite is dit de webbased versie van de Installer Toolkit van Enphase. En je hoeft niet meer met telefoon verbinding te maken met de Envoy!Nu zijn er dus veel meer pagina's op de Envoy die lokaal via je webbrowser benaderbaar zijn. Veel zijn zonder inloggegevens te bekijken, voor andere heb je het Envoy wachtwoord nodig. Een overzicht van de gevonden pagina's:
Url | Gebruikersnaam | Wachtwoord | Opmerkingen |
http://envoy/home | [nvt] | [nvt] | Systeemoverzicht en configuratie |
http://envoy/home.json | [nvt] | [nvt] | Database grootte, datum en tijd, netwerk status en instellingen, update status |
http://envoy/production.json | [nvt] | [nvt] | Productie en consumptie data |
http://envoy/inventory.json | [nvt] | [nvt] | Details over de micro omvormers, ook firmware versie |
http://envoy/api/v1/production | [nvt] | [nvt] | Totale en huidig vermogen / productie van het hele systeem |
http://envoy/api/v1/consumption | [nvt] | [nvt] | Totale en huidig consumptie van het hele net (huis) |
http://envoy/ivp/meters/reports/consumption | [nvt] | [nvt] | Gedetailleerd consumptie overzicht, totaal en per fase |
http://envoy/ivp/meters/reports/production | [nvt] | [nvt] | Gedetailleerd productie overzicht, totaal en per fase |
http://envoy/api/v1/production/inverters | installer | [envoy ww] | Geeft huidig en maximaal vermogen per micro omvormer weer |
http://envoy/ivp/meters | [nvt] | [nvt] | Overzicht van productie / verbruiksmeters |
http://envoy/ivp/meters/readings | [nvt] | [nvt] | Metingen per fase |
http://envoy/ivp/peb/newscan | [nvt] | [nvt] | Scan van het systeem |
http://envoy/prov | [nvt] | [nvt] | O.a. serienummers van apparaten in het systeem |
http://envoy/admin/lib/wireless_display.json?site_info=0 | [nvt] | [nvt] | Overzicht wifi settings |
http://envoy/installer/setup/home | installer | [envoy ww] | Installer Toolkit interface |
http://envoy/stream/meter | installer | [envoy ww] | Continu datastroom van de productie (*nog uitzoeken*) |
http://envoy/event.json | installer | [envoy ww] | Overzicht van storingen in het systeem op micro omvormer en Envoy niveau |
Note: bij de non-metered versie is de gebruikersnaam envoy en het wachtwoord de laatste 6 cijfers van het serienummer van de Envoy.
Verder heb ik nog meer pagina's gevonden, maar daar kom ik niet in, met geen enkele gebruikersnaam / wachtwoord combinatie die ik heb*. Te weten:
http://envoy/home?classic=1
http://envoy/admin/home?locale=nl
http://envoy/admin/lib/network_display?locale=nl
http://envoy/admin/lib/security_display?locale=nl
Wellicht zijn het gegevens die terug te vinden zijn in andere pagina's.
Volgens deze post is de gebruikersnaam voor bovengenoemde pagina's enphase, en het wachtwoord iets dat vergelijkbaar is met een Windows key (qua format denk ik dan). Het lijkt erop dat de poster dat wachtwoord ook weet, maar geeft het niet prijs helaas.
Importeren in Excel
Het is ook mogelijk om bijvoorbeeld .json bestand te importeren in Excel, rechtstreeks vanuit de Envoy. Dit doe je in Excel via Gegevens -> Nieuwe query -> Uit andere bronnen -> Van het web (Excel 2019 NL, kan bij andere versies iets anders zijn). Vul daar bijvoorbeeld http://envoy/production.json in. Je kunt dan verschillende tabellen importeren in Excel. Een gifje dat ik online vond:Wellicht dat hiermee ook iets van scriptje te maken is om bijvoorbeeld met een druk op de knop de nieuwste data binnen te halen, maar zover reikt mijn kennis niet. Het voorzetje is gegeven

En hoe zit dat met firmware v7?
Sindskort is er nieuwe firmware voor de Envoy, de beruchte v7.0.88. De manier om lokale toegang tot de Envoy te krijgen is vanaf die firmware versie grondig veranderd. Het wachtwoord is niet meer op basis van het serienummer te achterhalen. Daarvoor in de plaats moet een token worden opgehaald in de Enphase cloud. Met die token kan lokale toegang tot de Envoy worden gekregen.Waarom werkt Enphase met een token?
Er zijn helaas installaties waar de Envoy rechtstreeks aan internet hangt. Met de oude firmware konden wildvreemden op die Envoys komen. Dat is natuurlijk niet de bedoeling. De token is een manier voor Enphase om dit probleem op te lossen.Hoe werkt dat met zo'n token?
Je installateur (of jijzelf, als je DHZ'er bent) koppelt het serienummer van je Envoy aan je Enphase cloud account. Vervolgens kun je met dat account in de Enphase cloud een token ophalen op basis van je serienummer. Dit token heb je nodig om lokaal tegen je Envoy aan te kletsen:- Met serienummer in de Enphase cloud je token ophalen:
a. via browser @ https://entrez.enphaseenergy.com/entrez_tokens
b. via API @ https://entrez.enphaseenergy.com/tokens (zie post van @wnwiigrtz) of https://enlighten.enphase...token?serial_num=<serial> - Met dit token een sessie creeren: https://envoy/auth/check_jwt
- API van Envoy lokaal aanspreken, zie lijst van API endpoints
Moet ik dat allemaal zelf doen?
Wanneer je Domoticz gebruikt, gelukkig niet
Maar wacht even, ben ik dan afhankelijk van de cloud?
Voor het opnieuw ophalen van een token wel, ja. Voor gewone 'system owner' cloud accounts zijn de tokens 1 jaar geldig. Sommige gebruikers hebben een installer account, en Enphase zegt dat hun tokens 1 of 12 uur geldig zijn. Als je die langdurige token eenmaal hebt, hoef je niet meer naar de cloud om je Envoy lokaal aan te spreken. Wel kan het zijn dat je Envoy de cloud moet kunnen aanspreken.Welke API endpoints zijn lokaal aan te spreken op de Envoy?
API endpoint | Authenticatie |
https://envoy/home.json | open |
https://envoy/info.xml | open |
https://envoy/auth/check_jwt | open |
https://envoy/admin/home?locale=en | vereist token |
https://envoy/admin/lib/wireless_display.json?site_info=0 | vereist token |
https://envoy/api/v1/production | vereist token |
https://envoy/api/v1/production/inverters | vereist token |
https://envoy/event?locale=en | vereist token |
https://envoy/event.json | vereist token |
https://envoy/home | vereist token |
https://envoy/installer/setup/home | vereist token |
https://envoy/inventory?locale=en | vereist token |
https://envoy/inventory.json | vereist token |
https://envoy/inventory.json?deleted=1 | vereist token |
https://envoy/ivp/ensemble/inventory | vereist token |
https://envoy/ivp/livedata/status | vereist token |
https://envoy/ivp/meters | vereist token |
https://envoy/ivp/meters/readings | vereist token |
https://envoy/ivp/meters/reports/consumption | vereist token |
https://envoy/ivp/peb/newscan | vereist token |
https://envoy/production.json | vereist token |
https://envoy/production.json?details=1 | vereist token |
https://envoy/prov | vereist token |
https://envoy/stream/meter | vereist token |
Wat voor verkeer is er tussen de Envoy en de Enphase cloud?
De Envoy stuurt gegevens naar de Enphase cloud, onder meer zodat je je productie in de mobiele app kan bekijken. Maar ook bij het initieel aanmelden van het systeem, om firmware op te halen, etc.Voor zover we nu weten genereert de Envoy het volgende verkeer:
- reports.enphaseenergy.com (voor het periodiek versturen van je productie, en voor het ophalen van taken, zie deze post van @mielus)
- entrez.enphaseenergy.com (waarschijnlijk voor het genereren of valideren van tokens)
- ping-udp.enphaseenergy.com
- provisioning.enphaseenergy.com
- revocations.enphase.com
- *.iot.us-east-1.amazonaws.com
- ICMP echo naar dns.google (8.8.8.8)
Wat is het doel van dit topic?
Samen kijken of we nog meer interessants uit de Envoy kunnen halen, en hoe we deze data eventueel kunnen gebruiken
.
Change log
Datum | Door | Omschrijving |
11-06-2021 | Pazo | Start topic |
14-11-2021 | Pazo | Link toegevoegd naar website met installer password generator |
14-11-2022 | iKiddo | Informatie toegevoegd over lokale toegang tot Envoy bij firmware v7 |
[Voor 254% gewijzigd door Pazo op 15-11-2022 20:07]
8080Wp op oost / west (Barneveld) • PVOutput
Het grote Enphase topic • Haal meer uit je Envoy!