API-nøgler og adgange
Opret, se og tilbagekald API-nøgler, og giv hver nøgle kun de adgange, den skal bruge.
API-nøgler oprettes under Forbindelser → API og webhooks. Kun administratorer kan se fanen og oprette eller tilbagekalde nøgler. Både oprettelse og tilbagekaldelse står i virksomhedens log.
Opret en nøgle
Klik på Opret nøgle.
Skriv et Navn, der siger, hvor nøglen bruges, fx "Webshop" eller "Claude".
Vælg Udløber: aldrig, om 30, 90 eller 365 dage.
Sæt flueben ved de adgange, systemet skal bruge — og ikke flere.
Klik på Opret nøgle, og kopiér nøglen med det samme.
Nøglen vises kun én gang. Vi gemmer den ikke — kun et fingeraftryk af den — så vi kan heller ikke finde den frem igen. Har I mistet den, så tilbagekald den og opret en ny.
En nøgle ser sådan ud: tln_live_ efterfulgt af 40 bogstaver og tal. I listen står kun begyndelsen, fx tln_live_AbC1x2…, så I kan kende den igen.
Adgange
| Adgang | Giver lov til |
|---|---|
henvendelser:read | Læse henvendelser og mailtråde |
henvendelser:write | Oprette, ændre og besvare henvendelser |
kontakter:read | Læse kontakter |
kontakter:write | Oprette og rette kontakter |
opkald:read | Læse Noas opkald med udskrift og resumé |
viden:write | Lægge viden ind til Noa |
noa:read | Se Noa Voices status og nummer |
Bruger en nøgle et endpoint, den ikke har adgang til, svarer Telenoa 403 med koden mangler_adgang.
Svar sendt med en nøgle
Sender et system et svar til en kunde (POST /henvendelser/{id}/svar), går mailen ud fra virksomhedens mailkonto og står i navnet på den administrator, der oprettede nøglen.
Er den person ikke længere aktiv i virksomheden, kan nøglen ikke sende svar. Opret så en ny nøgle.
Listen
For hver nøgle ser I navn, begyndelsen af nøglen, adgange, hvornår den sidst blev brugt, hvornår den udløber, og hvem der oprettede den. Udløbne og tilbagekaldte nøgler står nedtonet i 90 dage.
Tilbagekald en nøgle
Klik på Tilbagekald ud for nøglen. Den holder op med at virke med det samme, og kald med den får 401.
Tilbagekald altid en nøgle, hvis den kan være kommet i forkerte hænder, eller hvis den person, der satte integrationen op, stopper.
Gode vaner
- Én nøgle pr. system. Så kan I tilbagekalde én uden at stoppe de andre.
- Giv kun de adgange, der skal bruges. Et dashboard, der kun viser tal, skal ikke kunne skrive.
- Hold nøglen på jeres server. Læg den aldrig i kode, som en browser eller app kan se.
- Vælg et udløb for nøgler, der kun skal bruges en periode.