Julkiset näytöt ja rekisteröityminen
Sovelluksen järjestelmänäytöt — sisäänkirjautuminen, salasanan palautus ja rekisteröityminen — miten ne suunnitellaan, milloin niitä tarjoillaan, ja miten näyttö avataan yleisölle.
Ennen kuin kukaan kirjautuu sovellukseen, hän on jo nähnyt sen näyttöjä: sisäänkirjautumisen, salasanan palautuksen ja, kun se on olemassa, rekisteröitymisen. Ne ovat järjestelmänäyttöjä — eivätkä ne Keplinissä ole alustan kiinteä sivu: ne ovat sinun sovelluksesi näyttöjä, suunniteltuja samassa rakentimessa, sovelluksen teemalla ja sovelluksen sanoilla.
Tämä sivu käsittelee niitä ja sitä, mikä päättää, milloin niitä tarjoillaan.
Kolme järjestelmänäyttöä
Sovelluksen puussa, minivälilehdellä UI, ryhmä Näytöt alkaa kansiolla Järjestelmä, jossa on kolme kohtaa:
| Näyttö | Reitti | Mihin se on |
|---|---|---|
| Login | / |
Sovelluksen sisäänkäynti. Se vastaa, kun joku saapuu ilman istuntoa. |
| Salasanan palautus | /recover |
Pyytää sähköpostin ja lähettää palautuslinkin. |
| Rekisteröityminen | /register |
Luo uuden tilin. Tarjoillaan vain, kun julkinen rekisteröityminen on päällä. |
Ne ovat aina olemassa — niitä ei luoda eikä poisteta. Se, mitä tehdään, on niiden suunnittelu.
Järjestelmänäytön suunnittelu
Napsauta nimeä, ja näyttö avautuu rakentimeen, täsmälleen kuten mikä tahansa muu:
Vasemmalla on Widgetit-paletti, keskellä canvas kolmella koolla (Web, Tabletti, Mobiili) ja oikealla ominaisuudet. Voit muuttaa mitä haluat — laittaa logon, vaihtaa tekstit, lisätä paneelin ja kuvan sen viereen, säätää värejä, kirjoittaa tapahtumia TypeScriptillä.
Se, mitä ei muuteta, sanotaan itse paneelissa: "Järjestelmänäyttö — reitti, parametrit ja pääsy ovat kiinteitä."
| Mikä on kiinteää | Miksi |
|---|---|
Reitti (/register, /recover) |
Sen kautta sovellus tarjoilee näytön; sen muuttaminen rikkoisi sisäänkäynnin. |
| Parametrit | Järjestelmänäyttö ei vastaanota reitin parametreja. |
| Pääsy | Ne ovat luonnostaan julkisia — ei olisi mieltä vaatia istuntoa näytöltä, joka antaa istunnon. |
Kaikki muu on paikallaan: Näytön pohja (layout), Data,
Toiminta, Ulkoasu (taustaväri, kuva sovelluksen tiedostoista) ja
Tapahtumat — onLoad, onParamsChange, onUnload.
Dica
Sisäänkirjautumisnäytön ei tarvitse olla laatikko keskellä valkoista taustaa. Puolet sisäisten sovellusten sisäänkirjautumisnäytöistä paranee valtavasti yrityksen logolla ja kuvalla vasemmalla — ja se on puoli tusinaa widgetiä raahattuna canvasille.
Miten näytöt käyttäytyvät ajonaikana
Sisäänkirjautuminen
Henkilö kirjoittaa kenttiin Käyttäjä ja Salasana ja painaa Kirjaudu sisään. Tilit ovat sovelluksen tilejä — katso Sovelluksen käyttäjät.
Jos sovellus on tilassa OAuth / OpenID Connect, sisäänkirjautuminen delegoidaan organisaation identiteetintarjoajalle ja Login-näyttö toimii porttina siihen virtaan.
Salasanan palauttaminen
Linkki Unohdin salasanani vie osoitteeseen /recover:
Henkilö kirjoittaa sähköpostinsa, painaa Lähetä ja saa linkin salasanan palauttamiseen.
Atenção
"Salasanan palautus lähettää linkin Ilmoitusasetusten sähköpostikanavan kautta (sen on oltava käytössä ja SMTP täysin määritettynä)." Ilman tuota kanavaa näyttö on olemassa eikä kelpaa mihinkään — kukaan ei saa sähköpostia. Ja tilillä pitää olla sähköposti täytettynä sen tiedoissa.
Julkinen rekisteröityminen
Näyttö pyytää kentät Nimi, Sähköposti, Käyttäjä ja Salasana ja luo tilin painikkeella Rekisteröidy. Takaisin kirjautumiseen vie henkilön takaisin sisäänkäynnille.
Julkisen rekisteröitymisen kytkeminen päälle (tai pois)
Kytkin on kohdassa Sovelluksen asetukset → Tunnistautuminen, osiossa Rekisteröityminen ja palautus — "ajoympäristön julkiset järjestelmänäytöt: käyttäjien rekisteröityminen ja salasanan palautus".
| Kenttä | Mitä se tekee |
|---|---|
| Salli julkinen rekisteröityminen | Päällä "kuka tahansa vierailija voi luoda tilin /register-näytöllä. Pois päältä näyttöä ei tarjoilla". |
| Uusien rekisteröitymisten rooli | "Rooli, joka annetaan automaattisesti rekisteröityvälle." Tai Ei roolia. |
Tallenna painikkeella Tallenna ("Tunnistautuminen tallennettu.").
Atenção
Älä koskaan jätä Uusien rekisteröitymisten roolia arvoon ”Ei roolia”
sovelluksessa, jonka rekisteröityminen on auki. Rekisteröityvä
kirjautuu sisään eikä näe mitään — ja raportoi sen sovelluksen virheenä.
Luo sisääntuloroolin (esimerkiksi leitura, minimioikeuksin) ja osoita
se tähän.
Ja käänteinenkin on totta: avoin rekisteröityminen on avoin ovi. Sisäisessä sovelluksessa normaalia on pitää julkinen rekisteröityminen pois päältä ja luoda tilit käsin asetuksissa. Kytke se päälle vain, kun yleisö on oikeasti yleisö — asiakasportaali, ilmoittautumislomake.
Tavallisen näytön avaaminen yleisölle
Kolmen järjestelmänäytön lisäksi minkä tahansa sovelluksen näytön voi tarjoilla ilman istuntoa. Avaa näyttö rakentimessa, napsauta canvasin tyhjää aluetta valitaksesi näytön, ja kytke ominaisuuksien osiossa Käyttöoikeus päälle Julkinen näyttö (ilman istuntoa).
Seuraavaksi ilmestyvä huomautus on koko sääntö: "Tarjoillaan ilman kirjautumista. Data tulee vain julkisista API:sta."
Mitä tämä käytännössä tarkoittaa:
- Näyttö tarjoillaan jokaiselle, joka saapuu osoitteeseen, ilman tunnistautumista.
- Datan, jota se näyttää, on tultava julkisiksi merkityistä API:sta. API, joka ei ole julkinen, ei palauta mitään: "tällä API:lla ei ole julkista lukuoikeutta — istunnottomalla näytöllä se ei lataa dataa."
- Taulu-API:ssa osio Julkinen pääsy (ilman istuntoa) kytketään päälle operaatio kerrallaan — "operaatiot, joita julkiset näytöt (ilman kirjautumista) voivat kutsua. Ota käyttöön vain tarvittavat."
Tyypillisiä tapauksia: tilasivu, yhteydenottolomake, katalogi. Katso Julkiset API:t.
Atenção
Julkinen näyttö plus julkinen API on juuri sitä: dataa avoinna Internetiin. Kytke julkinen luku päälle vain niissä operaatioissa ja kentissä, jotka hyväksyt julkaistuiksi, ja kirjoitus ei koskaan ilman erittäin hyvää syytä.
Usein kysyttyä
Missä on "uuden salasanan asettamisen" näyttö? Se on palautuksen toinen puolisko, ja se tarjoillaan sähköpostissa kulkevasta linkistä. Näyttö, jonka sinä suunnittelet, on se, joka pyytää sähköpostin.
Muutin Login-näyttöä, ja vanha näkyy edelleen. Tarjoiltu näyttö on sen version, jota tuo osoite tarjoilee. Jos muokkasit toisessa versiossa, julkaistu osoite tarjoilee edelleen sitä, joka siihen on liitetty — katso Versiot ja julkaisu.
Voinko piilottaa palautuslinkin?
Kyllä — Login-näyttö on sinun. Poista linkki canvasilta. Näyttö /recover
on edelleen olemassa, mutta siihen ei ole enää ovea sisäänkäynniltä.
Rekisteröityminen luo tilin, mutta henkilö ei pääse sisään. Varmista, että tili jäi tilaan Aktiivinen ja että Uusien rekisteröitymisten rooli osoittaa olemassa olevaan rooliin. Aktiivinen tili ilman roolia kirjautuu sisään eikä näe mitään, mikä yleensä luetaan muotoon "en päässyt sisään".