Een assistent op je site kan een ingelogde bezoeker bij naam aanspreken. Daarvoor geeft de server van je site een korte, ondertekende JWT door. Alles wat je ontwikkelaar nodig heeft, staat onder Support, Instellingen, Ingelogde gebruikers, in het blok Wat je site nodig heeft.
Dit is één onderdeel van de Support Studio. Een assistent maken, hem kennis geven en live overnemen staat in Support Studio. Kennis uit een portal achter een inlog staat in Kennis uit een portal achter een inlog. Dit blad gaat over iets anders: de assistent laten weten wie er is ingelogd.
Wat je site nodig heeft
- Assistent-id voor
aud, met een kopieerknop. Je mag in plaats daarvan de publieke sleutel uitdata-assistent(dps_...) alsaudgebruiken; beide werken. - Het geheim (
dpi_...), eenmalig getoond. Het scherm toont of het actief is, waarmee het begint, wanneer het is gemaakt en tot wanneer een vorig geheim nog werkt. - De laatste controle: wanneer het voor het laatst lukte, en de laatste weigerreden met uitleg.
Checklist
- Zet het geheim in de server-omgeving van je site, bijvoorbeeld als
DENKPLOEG_STEUN_GEHEIM. Nooit in de pagina, de browsercode of de repo. - Maak een JWT met HS256, met
audenexp(hoogstens 1 uur vooruit, 10 minuten aangeraden). - Geef hem mee via
data-identiteitop het script, of metdenkploegSteunIdentificeer(jwt). - Zet de assistent aan bij Algemeen. Staat hij uit, dan laadt de knop niet op je site.
- Test met "Weet je wie ik ben?".
Optioneel in de JWT: sub, naam, email, rol, klant en velden. Zet er geen wachtwoorden of gevoelige gegevens in; je medewerkers zien ze in het gesprek.
Prompt voor je ontwikkelaar
De knop Prompt voor je ontwikkelaar kopiëren zet een kant-en-klare opdracht op je klembord: assistent-id, begin van de sleutel, de claimstabel, een voorbeeld in Node.js en PHP, regels en testen. Het geheim zelf staat er nooit in; dat geef je apart.
Als het niet lukt
Een bewijs dat niet klopt geeft geen foutmelding: de bezoeker is dan anoniem. Het scherm toont de laatste reden en wat je site moet doen.
| Reden | Wat het betekent | Wat de site doet |
|---|---|---|
handtekening | De handtekening klopt niet met het geheim. | Onderteken met het huidige geheim; herstart na het wisselen. |
verlopen | Het bewijs was al verlopen. | Vers bewijs per paginaweergave, exp 10 minuten vooruit, klok controleren. |
aud | aud is niet het assistent-id. | Gebruik het assistent-id of de dps_-sleutel. |
formaat | Geen JWT van drie delen. | Alleen de JWT, zonder Bearer of aanhalingstekens. |
algoritme | Niet HS256. | Onderteken met HS256. |
geen-exp | exp ontbreekt. | Voeg exp toe. |
te-lang-geldig | exp ligt meer dan 1 uur vooruit. | Hoogstens 1 uur, aanbevolen 10 minuten. |
nog-niet-geldig | iat of nbf ligt in de toekomst. | Klok van de server controleren. |
claims-te-groot | Het bewijs of een claim is te groot. | Houd je aan de grenzen in de prompt. |
claims-ongeldig | Een claim heeft een verkeerd type, of het e-mailadres klopt niet. | Tekst voor de vaste claims, een object voor velden. |