Auth-klienter (OAuth) for tilgang til priskatalog

Auth-klienter (OAuth) for tilgang til priskatalog

En auth-klient (OAuth-klient) er et sett med påloggingsopplysninger som lar et eksternt program hente data fra en kundes Telaris-installasjon på vegne av kunden – for eksempel laste ned kundens priskatalog og priser automatisk.

MERK: Kun administratorer kan opprette og administrere auth-klienter. Det gjøres på administrasjonssiden «Partner OAuth Clients» (Partner OAuth-klienter).

INNHOLDSFORTEGNELSE

• Hva er en auth-klient?
• Opprette en auth-klient
• Rotere (bytte) hemmeligheten
• Deaktivere en auth-klient
• Endre redirect-adresser

Hva er en auth-klient?

En auth-klient fungerer som et nøkkelkort utstedt til et program i stedet for til en person. Den består av:

• Hver auth-klient tilhører én kunde. Data som hentes med den, er data den kunden har tilgang til – som sine kataloger og priser.
• Programmet ser aldri kundens passord. Kunden logger inn i Telaris i sin egen nettleser, og programmet får et tidsbegrenset tilgangspass i retur.
• Hemmeligheten må behandles som et passord. Den som har Client ID og Client Secret, kan opptre som programmet.
• Mister eller lekker en hemmelighet, kan den byttes («roteres»), slik at den gamle slutter å virke umiddelbart. En klient som ikke lenger trengs, kan deaktiveres.

Opprette en auth-klient

På administrasjonssiden, under «Issue client credentials» (Opprett nye klientopplysninger):

1. Customer (Kunde): begynn å skrive kundens navn (minst 2 tegn) og velg fra forslagene. Kun aktive kunder foreslås.
2. Name (Navn): fylles automatisk som «Kundenavn – Auth Client». Endre til noe som sier hva klienten brukes til, f.eks. «Acme – ERP-integrasjon».
3. Redirect URI: skriv inn adressen kundens system har oppgitt. Den må være en full nettadresse som starter med http:// eller https://. Bruk +-knappen for å legge til flere.
4. Klikk «Issue» (Opprett).

Client ID og Client Secret vises da, hver med en «Copy»-knapp (Kopier).

MERK: Kopier begge og lagre dem trygt før du går videre – hemmeligheten kan ikke vises igjen. Klikk «I have saved these» (Jeg har lagret disse) når du er ferdig.

Rotere (bytte) hemmeligheten

Bruk dette når en hemmelighet er mistet eller kan ha lekket, eller som rutinemessig vedlikehold.

1. Velg klienten i lista «Active client credentials» (Aktive klientopplysninger). Bruk «Search list» (Søk i listen) for å filtrere på kunde, navn eller Client ID.
2. Klikk «Rotate» (Roter) og bekreft.
3. Client ID og den nye hemmeligheten vises, på samme måte som ved opprettelse. Kopier hemmeligheten, gi den til kunden, og klikk «I have saved these».

Den gamle hemmeligheten slutter å virke umiddelbart, og alt som allerede er logget inn med klienten, logges ut. Kundens system har ingenting som virker før den nye hemmeligheten er lagt inn der. Client ID er uendret.

Deaktivere en auth-klient

1. Velg klienten i lista.
2. Klikk «Deactivate» (Deaktiver) og bekreft.

Klienten slutter å virke umiddelbart og permanent, og forsvinner fra lista. Den kan ikke aktiveres på nytt – trengs tilgang igjen, opprett en ny klient.

Endre redirect-adresser

1. Velg klienten i lista.
2. Under «Redirect URI» redigerer du, legger til (+) eller tømmer adressefeltene. Tomme felt ignoreres.
3. Klikk «Update redirect URIs» (Oppdater redirect-URI-er).

• Minst én adresse kreves, og hver må være en full http:// - eller https://-adresse.
• Hadde klienten kun én adresse og du legger til flere, vises en advarsel. Med flere adresser kan en pålogging sendes tilbake til hvilken som helst av dem, så legg bare til adresser kunden faktisk eier.
• Hemmeligheten endres ikke, så kunden trenger ikke nye opplysninger.