Kako deluje overjanje v Zentor App

Sistema ključev API za razvijalce ni — obstajata le prijava v nadzorno ploščo in Embed-Token gradnika. Tako delujeta oba.

Zadnjič preverjeno: 2026-07-20

Zentor App trenutno ne ponuja klasičnega, trajnega ključa API za razvijalce. Obstajata dva dejanska načina overjanja: prijava v nadzorno ploščo (na osnovi seje, za vas kot uporabnika) in Embed-Token gradnika (za javno vdelavo vašega klepetalnega gradnika na vaši spletni strani).

Korak za korakom

  1. Razumevanje prijave na nadzorno ploščoPo prijavi prejmete dostopni žeton, ki velja 12 ur, ter refresh žeton z veljavnostjo 7 dni, da ohranite prijavljenost brez ponovnega vnosa gesla. Dostopni žeton se pri vsaki obnovi zamenja (velja samo enkrat).
  2. Po želji aktivirajte dvostopenjsko overjanjeZa svoj račun lahko aktivirate dvostopenjsko overjanje na podlagi TOTP (združljivo z običajnimi aplikacijami za overjanje), vključno z rezervnimi kodami za nujne primere.
  3. Enotna prijava (Single Sign-On, če je na voljo)Če je za vašega najemnika nastavljen SSO (SAML/OIDC), je mogoče prijavo vsiliti izključno prek vašega ponudnika identitete — običajna prijava z geslom je nato blokirana.
  4. Razumevanje Embed-Tokena gradnikaZa vaš klepetalni gradnik se ob ustvarjanju ustvari lasten token, ki se v golem besedilu prikaže samo enkrat. Strogo je omejen na javne končne točke gradnika (sporočila klepeta, ocenjevanje, govorni vnos/izpis) in ne daje dostopa do funkcij nadzorne plošče ali administracije. Poleg tega se klicajoča domena preveri glede na seznam odobritev.

Očakovan rezultat

Razumete, kateri od obeh dejansko obstoječih mehanizmov je relevanten za vaš primer uporabe (lastna prijava ali vgradnja gradnika).

Pogosti primeri napak

Iščem ključ API, da bi z njim zaganjal lastne skripte proti API-ju Zentor App.

Vzrok: Takšen sistem ključev API za razvijalce trenutno ne obstaja.

Rešitev: Edina pot za programski dostop je običajna končna točka za prijavo z nadaljnjo uporabo tokena — z navedenimi omejitvami (čas veljavnosti, vezava na sejo). Za trajne integracije se obrnite na Zentor.

Moj dostopni token poteče, medtem ko poganjam skript.

Vzrok: Dostopni token je omejen na 12 ur in ga je treba obnoviti prek končne točke Refresh.

Rešitev: Izvedite obnovitev tokena prek končne točke Refresh ali se po potrebi znova prijavite.

Moj token gradnika lahko po pomoti prikliče podatke nadzorne plošče — ali je to varnostno tveganje?

Vzrok: Ne — token gradnika je tehnično strogo omejen na javne končne točke gradnika in ne deluje kot nadomestek za sejno prijavo.

Rešitev: Ukrepanje ni potrebno; token gradnika kljub temu obravnavajte zaupno, saj vam poleg preverjanja domene omogoča dostop do vašega gradnika.

Sorodni članki

← Nazaj na kategorijo