Hulpsentrum · Toegangsgids

Gee elke kliënt die regte antwoorde

Wys leiding aan die mense op wie dit van toepassing is. Gebruik basiese gehore vir besoekers en aangemelde kliënte, of skep groepe uit geverifieerde eienskappe soos plan en rol.

1. Koppel geverifieerde kliëntaanmelding

'n Eienaar of admin stel toegang op onder Kanale → jou kanaal → Hulpsentrum. Jou toepassing se ontwikkelaar koppel die kliëntidentiteit een keer. Vir inhoud net vir besoekers kan jy Besoekers kies sonder om 'n aanmeldvloei te bou.

  1. Maak die kanaal se Regstreekse klets-oortjie oop. Koppel 'n webwerf as die kanaal nog nie een het nie, en vind dan Veilige besoekeridentiteit.
  2. Kies Opsionele verifikasie of Vereis bewys om te identifiseer, kies Genereer ondertekeningsgeheim en stoor dit net op jou agterkant. As 'n geheim reeds opgestel is, kies Opsioneel — verifieer wanneer JWT teenwoordig is of Vereis vir identifisering en kenmerke onder Verifikasiemodus. Vereis bewys om te identifiseer laat steeds anonieme klets toe; die hulpsentrum-gehoor beheer toegang tot inhoud.
  3. Nadat jou app 'n kliënt geverifieer het, onderteken jou bediener 'n kortstondige identiteitstoken (JWT) met user_id, email, iat, exp en betroubare eienskappe. Lees plan en rol uit jou eie databasis. Ongetekende blaaiereienskappe en kontakvelde kan nie toegang gee nie.
  4. Gee die JWT aan die widget, en koppel 'n hulpsentrum-aanmeldaksie vir mense wat gehoste bladsye of jou pasgemaakte domein oopmaak. Gebruik die ontwikkelaarsgids hieronder vir die presiese kode.
Genereer en stuur 'n geverifieerde identiteit

Vir die voorbeeld hieronder is die ondertekende eienskappe:

JSON · eienskappe binne die ondertekende JWT
{"plan":"pro","role":"admin"}

2. Skep 'n gehoor vir Pro-kliënte

  1. Gaan terug na Hulpsentrum. Kies in Gehore die opsie Nuwe gehoor (die plus-knoppie), of Skep 'n gehoor as dit jou eerste groep is.
  2. Voer Pro-kliënte as die Naam in. Los Pas op Alle reëls.
  3. Voer vir Eienskap plan in. Stel Voorwaarde op is een van en Waardetipe op Teks.
  4. Voer pro en business op aparte reëls in Waardes · een per reël in. Kies Stoor gehoor.
  5. Om 'n Admins-groep te skep, herhaal met Eienskap role, Voorwaarde is, Waardetipe Teks en Waarde admin.

Hoe reëls pas: Alle reëls vereis elke voorwaarde in hierdie gehoor; Enige reël vereis minstens een. Jy kan tot 10 reëls byvoeg. Alle oorgeërfde gehore moet steeds pas, selfs as 'n bepaalde gehoor Enige reël gebruik.

Teks is hoofletter-sensitief. Die getal 5 verskil van die teks “5”; kies Getal vir vergelykings soos is minstens. Ontbrekende eienskappe voldoen nooit aan vergelykings nie, insluitend is nie. Het 'n waarde sluit null uit; Het geen waarde nie pas by ontbrekend of null. Eienskapsleutels begin met 'n letter en gebruik letters, syfers of onderstrepe, tot 64 karakters; gereserveerde identiteitsleutels soos email is nie eienskappe nie.

3. Pas die gehoor toe waar jy dit nodig het

Een artikel

Maak die artikel oop, stel Wie kan dit lees? op Geverifieerde kliënte en kies dan Pro-kliënte onder Kliëntgehoor. Kies Publiseer vir 'n nuwe artikel of Stoor veranderinge vir 'n regstreekse een. As basiese toegang oorgeërf is, is dit leesalleen; jy kan steeds 'n bykomende kliëntgehoor kies.

'n Hele kategorie

Kies die potlood langs die kategorie onder Kategorieë. Kies Geverifieerde kliënte en 'n Kliëntgehoor, en dan Stoor. Elke artikel in daardie kategorie moet aan hierdie beperking sowel as sy eie voldoen.

'n Privaat hulpsentrum

  1. Kies in Hulpsentrumtoegang Geverifieerde kliënte. Los Kliëntgehoor as Alle geverifieerde kliënte, of kies Pro-kliënte om die hele sentrum tot daardie groep te beperk.
  2. Voer jou toepassing se aanmeldbladsy as die Kliëntaanmeld-URL in, byvoorbeeld https://app.example.com/login. Dit is jou app se aanmeldbladsy, nie Sonny se personeelaanmelding nie.
  3. Ná aanmelding moet jou app die kliënt na die hulpsentrum se verifikasie-eindpunt stuur met 'n vars ondertekende JWT. Die aanmeld-URL alleen voltooi nie hierdie verbinding nie.
  4. Kies Stoor toegang. Hou die sentrum Regstreeks sodat gemagtigde kliënte dit kan oopmaak.
Koppel aanmelding vir gehoste en pasgemaakte domeine

Beperkings tel saam. As die hulpsentrum Pro-kliënte vereis en 'n kategorie Admins vereis, vereis sy artikels albei. Almal op 'n artikel oorskryf nie die kategorie nie. Besoekers en geverifieerde kliënte is basiese gehore wat mekaar uitsluit.

4. Kyk na 'n voorskou, en gaan dan 'n werklike kliëntsessie na

  1. Verander bo-aan Hulpsentrum Sien as na Besoeker, Geverifieerde kliënt of Kliënt met eienskappe….
  2. Vir Kliënt met eienskappe… voer jy die voorbeeld-JSON hierbo in. Gedempte rye is vir daardie leser versteek; die telling sluit publikasiestatus en alle oorgeërfde beperkings in. Alle artikels keer terug na die volle outeurslys.
  3. Gebruik die tabel hieronder om 'n hulpsentrum net vir Pro met 'n kategorie net vir admins te toets. Verander die voorbeeldplan en -rol om elke resultaat na te gaan.
  4. Maak 'n werklike afgemelde blaaier oop, en meld dan met elke toetskliënt aan. Gaan blaai, soek, 'n direkte artikel-URL en die widget se Hulp-oortjie na. 'n Voorskou van eienskappe meld jou nie aan nie en verander nie 'n kliënt se toegang nie.
Verwagte toegang vir 'n sentrum net vir Pro en 'n kategorie net vir admins
LeserHulpsentrumArtikel in admin-kategorie
Afgemelde besoekerAanmeldbladsyVersteek
Pro-kliënt, adminKan leesKan lees
Pro-kliënt, lidKan leesVersteek
Gratis kliënt, adminToegangsboodskapVersteek

Geweierde artikels word uit resultate weggelaat en direkte URL's gee nie gevind nie. 'n Privaat hulpsentrum wys 'n aanmeld- of toegangsboodskap met jou handelsmerk in plaas van sy inhoud. Sy werfkaart is leeg en indeksering word nie toegelaat nie; artikels net vir besoekers word ook uit openbare werfkaarte uitgesluit. KI-antwoorde en Copilot-herwinning gebruik dieselfde reëls vir die gesprek se geverifieerde kliëntidentiteit.

Opgelaaide beeld-URL's is openbaar. Om 'n artikel te beperk, beskerm nie sy beelde as iemand reeds die beeld-URL het nie.

Verander of verwyder 'n gehoor

Wysig 'n gehoor met sy potlood-knoppie en kies Stoor gehoor. Reëlveranderinge geld by die volgende versoek. Bygewerkte kliënteienskappe vereis 'n nuwe JWT of hulpsentrum-aanmelding; bestaande ondertekende lesersessies behou hul eienskappe totdat hulle verval.

Om 'n benoemde beperking van een plek te verwyder, kies Alle geverifieerde kliënte (of Almal in die oorgeërfde gehoor) onder Kliëntgehoor en stoor dan. Om daardie inhoud openbaar te maak, kies ook Almal onder Wie kan dit lees? en maak seker dat sy ouers openbare toegang toelaat.

Die gehoor se skrap-knoppie wys hoeveel artikels, kategorieë en hulpsentrums dit gebruik. Skrapping verwyder daardie groep se eienskapreëls; gekoppelde inhoud bly net vir geverifieerdes en behou enige ander oorgeërfde beperkings. Kliënte wat voorheen nie aan die geskrapte reël voldoen het nie, kan nou toegang kry. Hersien daardie toewysings voordat jy bevestig.

Los toegangsprobleme op

'n Geverifieerde kliënt sien die aanmeldbladsy
Gaan die verifikasiemodus op hierdie kanaal se Regstreekse klets-oortjie, die JWT se vervaltyd, die ondertekeningsgeheim en die hulpsentrum se aanmeld-URL na. Aanmelding by die personeelpaneelbord is apart van kliëntaanmelding.
Die kliënt is aangemeld maar kan nie 'n antwoord lees nie
Gaan elke oorgeërfde gehoor en die presiese ondertekende eienskapname, -tipes en -waardes na. 'n Pro-kliënt kan steeds 'n kategorie se Admin-reël misluk.
Wie kan dit lees? is gedeaktiveer
Die hulpsentrum of kategorie stel die basiese gehoor. Wysig daardie ouer om dit te verander; gebruik Kliëntgehoor om geverifieerde toegang verder te vernou.
Geen ooreenstemmende lesers verskyn nie
Beperkings net vir besoekers en net vir geverifieerdes bots. Gebruik oorgeërfde toegang wanneer dit aangebied word, of korrigeer eers die hulpsentrum-/kategorie-instellings.
'n Veranderde plan het nog nie toegang verander nie
Skep 'n nuwe JWT met die bygewerkte eienskappe en identifiseer weer in die widget. Vir gehoste of pasgemaakte-domeinbladsye voltooi jy weer die hulpsentrum-aanmelding. Bestaande koekies behou hul ondertekende eienskappe totdat hulle verval.
'n Artikel ontbreek in soektogte of die widget
Maak seker dat dit gepubliseer is, die sentrum Regstreeks is, Soek vir soekresultate aangeskakel is, en die leser aan alle beperkings voldoen. 'n Leë Hulp-oortjie word versteek.

Verwante dokumentasie