Hjelp
Koble låsen. Så åpner de selv.
For deg som eier lokalet, eller den som skrur. Når låsen er lagret, åpner medlemmene med ett trykk.
- Lokalet er opprettet, og du er logget inn som eier eller admin.
- Minst én pakke er synlig, så medlemmer får knappen under Min tilgang.
- Gå til Admin → Dørlås og velg hvordan døren skal styres.
- Gå til Admin → Dørlås og slå på Geolås.
- Skriv inn adressen til inngangen, eller stå i døra og trykk Bruk posisjonen her.
- Trykk Finn posisjon fra adressen hvis du skrev adressen. Velg område, typisk 150 meter. GPS inne i bygget treffer sjelden på meteren.
- Lagre. Medlemmet må tillate stedstjenester. For langt unna får de beskjed, og døren styres ikke.
Test åpning fra admin hopper over geolås, så du kan sjekke selve låsen uten å stå i døra. Geolås stopper vanlige medlemmer som åpner hjemmefra. Den stopper ikke noen som forfalsker posisjon i nettleseren.
- Opprett konto hos SEAM og koble Yale Doorman der. Følg SEAMs veiviser til låsen er tilkoblet og vises som en enhet.
- I SEAM: lag en API-nøkkel med tilgang til å åpne og låse. Kopier nøkkelen. Den vises som regel bare én gang.
- I MemberKey: velg SEAM · Yale Doorman, lim inn nøkkelen og trykk Hent låser fra SEAM. Den første låsen settes som standard.
- Feil dør? Velg en annen i listen. Visningsnavn kan du sette selv, for eksempel «Hoveddør».
- Trykk Lagre dørlås hvis du byttet dør, og deretter Test åpning og Test låsing. Du skal høre eller se at låsen reagerer.
Virker testen, er du ferdig. Medlemmene bruker knappen på Min tilgang. Ingen skanner. Ingen QR-kode.
- Kontrolleren må kjøre firmwaren som snakker MemberKeyGW, for eksempel Yale Doorman DIY Controller. Den abonnerer på {LOCK_ID}/command og svarer på {LOCK_ID}/reply.
- Sett LOCK_ID, Wi-Fi og MQTT-broker i koden. Lås-ID i MemberKey må være nøyaktig den samme, som lock01.
- Brokeren må være nåbar fra internett. Bruk mqtts:// eller wss:// med brukernavn og passord. Åpen mqtt:// på port 1883 virker sjelden fra skyen.
- I MemberKey: velg MemberKeyGW, lim inn broker, innlogging og lås-ID. Lagre, og trykk Test åpning og Test låsing. Du skal høre motoren i Yale-kassen.
Hva kontrolleren mottar
MemberKey publiserer til {lås-ID}/command med JSON. command er unlock eller lock.
{
"messageType": "command",
"command": "unlock"
}- I MemberKey: velg Yale ESP og lagre. Nøkkelen vises én gang. Lim den inn i MEMBERKEY_TOKEN i kontrollerens Config.h.
- Sett lokalets Wi-Fi i WIFI_SSID og WIFI_PASSWORD. Kontrolleren må nå internett. Det lokale nettverket Dala kan stå på samtidig.
- Last opp firmwaren til ESP32-C3. Kortet er ESP32C3 Dev Module, USB CDC ved oppstart, 4 MB flash og partisjon No OTA.
- Når siden sier at kontrolleren er på nett, trykk Test åpning og Test låsing. Motoren skal gå til den grønne kontakten viser ny stilling.
MemberKey legger kommandoen klar. Kontrolleren spør om den omtrent hvert 18. sekund, og oftere når en kommando venter. Databasen brukes ikke til den spørringen. Uten kontakt fra kontrolleren får den som trykker beskjed om at ESP-en ikke er på nett.
- Låsen må være online i Nuki Web. Smart Lock 3.0 Pro og nyere går over Wi-Fi. Eldre modeller trenger Nuki Bridge.
- I Nuki Web: Meny → API → lag et API-token. Bruk det som Bearer-token. Tokenet utløper ikke, men slettes hvis du bytter passord på Nuki-kontoen.
- I MemberKey: velg Nuki, lim inn tokenet og trykk Hent låser fra Nuki. Den første låsen settes som standard.
- Feil dør? Velg en annen i listen. Visningsnavn kan du sette selv, for eksempel «Hoveddør».
- Trykk Lagre dørlås hvis du byttet dør, og deretter Test åpning og Test låsing. Du skal høre eller se at låsen reagerer.
Virker testen, er du ferdig. Medlemmene bruker knappen på Min tilgang. MemberKey sender unlock og lock til Nuki, ikke unlatch.
- Sett opp en adresse som tar imot POST og styrer låsen hos dere.
- I MemberKey: velg Egen dørstyring og lim inn adressen, for eksempel https://styring.ditlokale.no/dor.
- Sett en hemmelig nøkkel. Den samme nøkkelen bruker dørstyringen til å sjekke at kallet kommer fra MemberKey. Sett gjerne din egen.
- Lagre, og test åpning og låsing. Dørstyringen må svare med status 200–299, ellers får medlemmet beskjed om at døren ikke lot seg styre.
Hva dørstyringen mottar
MemberKey sender POST med JSON. Hendelsen ligger både i feltet event og i hodet X-MemberKey-Event (unlock eller lock).
{
"event": "memberkey.unlock",
"orgId": "…",
"orgSlug": "nord-studio",
"userId": "…",
"membershipId": "…",
"reason": "app",
"at": "2026-09-09T11:00:00.000Z"
}Signaturen i X-MemberKey-Signature er HMAC-SHA256 av hele råteksten i kroppen, kodet som heksadesimal. Bruk den hemmelige nøkkelen du limte inn i MemberKey. Godta bare kall der signaturen stemmer.
Knappen på Min tilgang virker, og hendelsene lander i tilgangsloggen. Ingen fysisk dør åpnes. Bytt til SEAM, MemberKeyGW, Nuki eller egen dørstyring når låsen er klar. Medlemskap og Vipps rører du ikke.
- Test åpning fra Admin → Dørlås først. Feiler det der, er det låsen — ikke medlemmet.
- Geolås: sjekk at posisjonen er slått opp, at området er stort nok, og at medlemmet har slått på stedstjenester.
- SEAM: sjekk at nøkkelen er limt inn, at riktig dør er valgt, og at låsen er tilkoblet i SEAM-konsollen.
- Nuki: sjekk at tokenet er limt inn, at riktig lås er valgt, og at den er tilkoblet i Nuki Web.
- MemberKeyGW: sjekk MQTT-broker, lås-ID og at ESP32 er på nett og abonnerer på command-topic.
- Yale ESP: sjekk at kontrolleren har nett, at nøkkelen i Config.h er den siste som ble vist, og at siden sier at den er på nett.
- Egen dørstyring: sjekk at adressen er https, at den svarer, og at signaturen valideres mot samme nøkkel.
- Medlemmet mangler knapp: ingen aktiv pakke. Be dem kjøpe, eller sjekk Medlemmer.