Exact Online fejlmeddelelse: Old refresh token used

Gå til den engelske version

Hvad er et Exact Online refresh token?

Et refresh token er en applikationsspecifik adgangskode for en bruger.

Specifikt for Exact Online gælder det, at refresh tokens er gyldige i ti minutter ved brug, og at alle tidligere refresh tokens udløber ved første brug til et API-kald eller hentning af et access token.

Et ubrugt refresh token forbliver brugbart i 30 til 180 dage til at anmode om et nyt refresh token. Denne frist for udløb af ubrugte refresh tokens startede som 180 dage og nedsættes trinvist efter en ukendt tidsplan til 30 dage.

Bemærk, at det på nogle applikationer er muligt at bruge ældre refresh tokens, mens det på andre ikke er muligt. Dette indstilles af Exact pr. Exact Online-applikation.

Bemærk også, at disse short-lived refresh tokens er meget specifikke for Exact Online. Andre platforme arbejder, så vidt vides, med “short-lived access token, long-lived refresh tokens” (OAuth-dokumentation). Nogle websider bruger dog refresh tokens som access token via refresh token rotation.

Et refresh token kan bruges til at anmode om et “access token” hos Exact Online API-serverne. Et access token er nødvendigt som autentifikation for at kunne udføre API-kald. Et Exact Online access token udløber automatisk efter ti minutter. Levetiden for et access token på Exact Online er uafhængig af, om det bruges eller ej: ti minutter efter udstedelse er access tokenet ikke længere gyldigt. Levetiden for et refresh token er mindst lige så lang og ofte længere: et ubrugt refresh token forbliver meget længere brugbart til at anmode om en ny værdi.

Authorization Code

I dokumentationen kan der også henvises til en authorization code som en del af “Code Grant Flow”. Authorization code’n er gyldig i 3 minutter på Exact Online og er i JSON Web Token-format (JWT). Authorization code’n bruges til at anmode om et nyt refresh token. På andre platforme kan levetiden for en authorization code være kortere eller længere end 3 minutter.

En authorization code kan på Exact Online kun bruges 1 gang til at anmode om et refresh token. Hvis en authorization code genbruges, giver det en pæn fejlmeddelelse:

{
    "error": "invalid_request",
    "error_description": "This message has already been processed.  This could indicate a replay attack in progress."
}

Fejlmeddelelsen “Old refresh token used”

Et problem, der har eksisteret længe på Exact Online, er den korte levetid for “refresh tokens”. Dette bliver yderligere kompliceret af det ekstra krav om, at rækken af anvendte refresh tokens skal være fuldstændig sammenhængende: det sidst aktiverede kan bruges, ligesom det sidst anmodede, men ikke aktiverede. Dette er ikke trivielt; OAuth-specifikationen beskriver en sådan tilgang som „challenging”.

Kun applikationer, hvor brugen af gamle refresh tokens er aktiveret af Exact, har ikke dette problem. Den tilhørende politik for, hvornår det også er tilladt at bruge refresh tokens uden for det aktuelt aktive, er ikke kendt. Det ser ud til, at det primært er ældre apps og en del af App Store-apps’ene, der har denne mulighed.

Ved brug af et udløbet refresh token forekommer følgende fejlmeddelelser på Exact Online:

Old refresh token used.

og

Token is not allowed, because of invalid or empty chainId

Begge angiver, at der er tale om et ugyldigt refresh token. Teksten “Old refresh token used.” er her noget forvirrende: denne fejlmeddelelse gives også, hvis der er tale om et refresh token efter det aktive, som er udløbet. “Old refresh token used.” kan derfor læses som “Inactive refresh token used.”

Risikoen for en brudt kæde er desværre ret stor, da der ikke er mulighed for overlap, som det glidende vindue med 50 refresh tokens på Google Identity.

Også implementeringen af Code Grant Flow med maksimalt 1 gyldigt refresh token hos Exact er for øjeblikket ikke helt fejlfri (november 2021).

Invantive Cloud

For Invantive Cloud gælder det, at der er et centralt sted, hvor refresh tokens registreres krypteret. Dette fungerer godt, så længe der pr. Exact Online-database bruges en anden bruger eller Exact Online app client ID.

En automatiseret systemdækkende kontrol sørger for, at det ikke er muligt at oprette en ny datacontainer for den samme kombination af Exact Online-bruger og Exact Online-app.

Brugeren får desuden et hint, hvis kæden af refresh tokens ved et uheld brydes, for eksempel ved at en komponent går ned under udvekslingen på et uheldigt tidspunkt.

Endelig undgår en række genstartsscenarier risikoen for at bryde kæden.

Det er også muligt at konfigurere en automatisk gendannelse, se Auto-recovery van Exact Online refresh tokens voor datacontainers.

Hvis der er brug for flere databaser til den samme bruger, kan der gøres brug af Bring Your Own App, som beskrevet på Bring Your Own App voor Exact Online op Invantive Cloud.

Valuta Tools, Get My Report

For Valuta Tools og Get My Report til Exact Online gælder, at begge overføres til Invantive Cloud. Refresh tokens i den nuværende version af Valuta Tools og Get My Report bestemmes altid på ny ved login.

Lejlighedsvis (3 gange om ugen) optræder meddelelsen: “Token is not allowed, because of invalid or empty chainId”. Årsagen er uklar, men på grund af den lave frekvens og den faldende karakter vil der ikke blive foretaget yderligere analyse heraf. Se mere på Incidentele foutmelding "Token is not allowed, because of invalid or empty chainId" op Exact Online.

Invantive Control, Invantive Query Tool, Invantive Composition

Som standard understøtter Invantive Control for Excel, Invantive Composition for Word og Invantive Query Tool Implicit Grant Flow og Code Grant Flow.

Ved Implicit Grant Flow kan verifikationskoden eventuelt udfyldes automatisk for mere brugervenlighed på bekostning af en mindre god sikkerhed på Exact Online. Automatisk udfyldning af verifikationskoden er beskrevet på Omzeil Exact Online 2FA om te voorkomen dat u elke tien minuten uw pincode moet invoeren. Exact Online tilbyder ikke husk-funktion for andre browsersessioner end på den almindelige Exact Online-webside.

I modsætning til webapplikationerne er det dog muligt også at gøre brug af Code Grant Flow: login til Exact Online sker da med et refresh token, client ID og client secret.

Client ID og client secret kan rekvireres ved at registrere en app efter login på https://apps.exactonline.com. Et refresh token kan enten genereres selv eller via pre-autentifikationsværktøjet på Invantive Cloud. En trin-for-trin-vejledning hertil findes på Preauthenticate Exact Online - Invantive.

Af sikkerhedsmæssige årsager og i overensstemmelse med OAuth-standarden udleverer Invantive ikke client secret for sine Exact Online-applikationer. Det vides, at andre client-side apps udleverer client secret, men det er app-ejerens eget ansvar.

En fremtidig udgivelse (se nedenfor) vil også give mulighed for så vidt muligt at registrere og genbruge kæden af refresh tokens. Dette vil ikke ske, før Exact Onlines Code Grant Flow-implementering har vist sig at være fejlfri. Indtil da anbefaler vi Implicit Grant Flow.

Invantive Data Hub og Invantive Data Replicator

Som standard understøtter Invantive Data Hub og Invantive Data Replicator Implicit Grant Flow og Code Grant Flow med et eget client ID. Implicit Grant Flow er beskrevet på Circumvent two-step verification and refresh tokens on Exact Online using Data Hub.

En fremtidig udgivelse (se nedenfor) vil også give mulighed for så vidt muligt at registrere og genbruge kæden af refresh tokens.

Refresh Token-kæde og Invantive Keychain

Begrænsninger

I release 20.0 understøtter intet Invantive on-premise-produkt en kæde af refresh tokens. I løbet af 20.1-udgivelserne vil der blive tilføjet understøttelse under følgende betingelser:

  • Ingen cluster- eller distribueret konfiguration: flere servere, der deler et refresh token eller access token.
  • Ingen multi-user-konfiguration: flere uafhængige brugere, der deler et refresh token på Exact Online for den samme Exact Online-bruger.
  • Inden for rate limits: kun inden for de grænser, Exact fastsætter.
  • Ingen flere databaser.

Ved cluster-konfigurationer, multi-user-konfiguration og uden for rate limits anbefaler vi brug af flere client ID’er og/eller flere Exact Online-brugere eller brug af Implicit Grant Flow som beskrevet ovenfor. Bring Your Own App vil gøre det muligt at lade styringen af refresh tokens foregå via Invantive Cloud.

Også ved flere databaser med de samme Exact Online-miljøer er det nødvendigt at arbejde med flere client ID’er og/eller flere Exact Online-brugere, eller at bruge Implicit Grant Flow som beskrevet ovenfor.

Uanset hvor irriterende det er, kan alle disse begrænsninger udledes af ønsket om en så sikker funktion som muligt i overensstemmelse med standarderne og de begrænsninger, Exact har fastsat.

Invantive Keychain

Funktionaliteten i 20.2 vil være baseret på Invantive Keychain. Mere information om refresh tokens og Keychain findes i Wat is Invantive Keychain?.

Release 22.0 - februar 2022

Med release 22.0 er der ingen kendte begrænsninger på Invantive-produkterne med hensyn til brug på små og store implementeringer ved hjælp af Exact Online.

Ik ondervind ook het steeds terugkomend probleem van die refresh tokens.

Is er een mogelijkheid om dit te omzeilen en niet constant te moeten refreshen op Invantive Cloud?

Heeft u de stappen uit dit topic gevolgd? Zo ja, waar gaat het dan mis?

Mocht u meer dan 1 database met daarin Exact Online hebben in Invantive Cloud, dan is het advies om aparte Exact Online gebruikers te gebruiken per database. Onder de nieuwe richtlijnen vanuit Exact is het momenteel niet mogelijk om per gebruiker en per app meer dan één zogenaamd refresh token te hebben.