Kom i gang med Access Controller-integrasjonen
Introduksjon til Access Controller i Entrii — hvem integrasjonen passer for, dataflyt ved innslipp og rekkefølge for oppsettguider.
Access Controller-integrasjonen kobler Entrii til QR-skannere og porter via Access Controller-hardware fra Apility. Når gjesten skanner billetten, validerer Entrii i skyen (med valgfri offline-cache på enheten) og gir grønt eller rødt lys ved inngangen. Integrasjonen passer for arenaer, museer, parker og andre steder med fysisk innslipp, og for integrasjonspartnere og administratorer som setter opp tilgangsenheter, pools og paring mot hardware.
Hva du kan gjøre
Opprette Access Controller-integrasjon og sette valideringsinnstillinger som gjelder for alle tilgangsenheter
Registrere tilgangsenheter med slug, Valideringspools og Opplevelser per leser eller port
Godkjenne OAuth-paring når Access Controller-enheten viser brukerkode — via Enhetsautorisasjoner
Validere billetter ved innslipp med de samme reglene som ved PCK-innsjekk og skanning i backoffice (pool, kapasitet, cooldown, gyldighet)
Se historikk over godkjente og avviste skanninger i Valideringslogger
Konfigurere valgfri port-puls på tilgangsenheten når en lokal port (f.eks. TVM på samme nett) skal åpnes etter godkjent validering
Slik fungerer det
Grunnoppsett i Entrii — du oppretter integrasjonen under Konfigurasjon → Integrasjoner og setter JWT-passphrase under Innstillinger → Validering dersom enheten skal kunne validere offline.
Tilgangsenheter — hver fysisk leser eller port får en unik slug i backoffice, kobles til pools og eventuelt opplevelser, og settes til aktiv status før validering.
Paring og tilkobling — Access Controller-enheten kobler seg til Entrii og ber om godkjenning. Du godkjenner paringen under Enhetsautorisasjoner med brukerkoden som vises på enheten.
Validering ved skanning — leseren sender billettkoden til Entrii. Skyen svarer godkjent eller avslått; resultatet vises på display og logges i Valideringslogger og på billettens scan-historikk.
Drift og feilsøking — ved avslag sjekker du logger, slug, pool-kobling og billettstatus. Go-live-sjekklisten og feilsøkingsguiden dekker typiske feil før og etter åpning.
Hvor du finner den i backoffice
Konfigurasjon → Integrasjoner — opprett integrasjon med typen Access Controller.
Integrasjoner → Access Controller → Tilgangsenheter — registrer slug, pools, opplevelser og valgfri Port (TVM / lokal puls).
Radhandlinger på integrasjonen — Tilgangsenheter, Enhetsautorisasjoner og Valideringslogger.
Innstillinger → Validering — JWT-passphrase og eventuelt billettkode-prefiks for tenant.
Forutsetninger
Access Controller er tilgjengelig i din Entrii-installasjon, og Access Controller-hardware fra Apility er levert eller bestilt.
Tilgang til Entrii backoffice med rettigheter til Konfigurasjon → Integrasjoner og tilgangsenheter.
Salgbare produkter og billettyper er knyttet til pools (eller sesjoner) som skal brukes ved innslipp.
Slug-navn er avtalt mellom Apility og backoffice — de må være identiske på enhet og i Entrii.
Testbilletter og en plan for prøveskanning før go-live.
Begrensninger
Fysisk montasje, nettverk og konfigurasjon på Access Controller-enheten håndteres av Apility — backoffice-guidene dekker kun Entrii-oppsett og kobling.
Feil eller manglende slug gir avslag («Ukjent device-slug»). Enheten må være Active og parert for å godta skanninger.
Offline-validering krever at JWT-passphrase er lik på Entrii og på Access Controller-enheten — ellers må enheten ha nett for skyvalidering.
Port-puls er valgfritt og krever riktig lokal URL og hemmelighet på tilgangsenheten — se guiden for tilgangsenheter.
Gantner GT7 er en egen integrasjon i Entrii med egne enheter og oppsett — den dekkes ikke av Access Controller-artiklene på denne siden.
Mobilskanner (Mobile Validator) er en annen integrasjon for validering i mobil nettleser — ikke det samme som faste porter med Access Controller.
Kom i gang
Før du går videre til steg-for-steg-guidene:
Relaterte artikler
Relaterte artikler
Oppsett av Access Controller-integrasjonen
Steg-for-steg guide for å opprette Access Controller-integrasjonen, sette valideringsinnstillinger og koble Access Contr
Opprette og konfigurere tilgangsenheter
Guide for å registrere tilgangsenheter i Entrii backoffice — slug, pools, opplevelser, OAuth-paring og valgfri port-puls
Koble pools til innganger
Guide for å knytte valideringspools og opplevelser til tilgangsenheter — rekkefølge, billettregler og typiske oppsett fo
Go-live-sjekkliste for Access Controller
Komplett sjekkliste før innslipp med Access Controller — backoffice, enhetsparing, pool-kobling og testskanning. Hardwar
Feilsøking: vanlige valideringsfeil ved Access Controller
Feilsøkingsguide for Access Controller — ukjent device-slug, inaktiv enhet, pool-problemer, cooldown, kapasitet og OAuth