Publika skärmar och registrering

Innan någon loggar in i en app har hon redan sett skärmar från den: den för inloggning, den för att återställa lösenordet och, när den finns, den för registrering. Det är systemskärmarna — och i Keplin är de ingen fast sida i plattformen: de är skärmar i din app, designade i samma byggare, med appens tema och appens formuleringar.

Den här sidan handlar om dem och om vad som avgör när de serveras.

#De tre systemskärmarna

I appens träd, i minifliken UI, börjar gruppen Skärmar med en mapp System som har tre poster:

Skärm	Rutt	Vad den är till för
Login	/	Appens ingång. Det är den som svarar när någon kommer utan session.
Återställ lösenord	/recover	Frågar efter e-postadressen och skickar återställningslänken.
Registrering	/register	Skapar ett nytt konto. Serveras bara med publik registrering påslagen.

De finns alltid — de varken skapas eller tas bort. Det man gör är att designa dem.

#Designa en systemskärm

Klicka på namnet så öppnas skärmen i byggaren, precis som vilken annan som helst:

Du har paletten Widgetar till vänster, duken i mitten med de tre storlekarna (Webb, Surfplatta, Mobil) och egenskaperna till höger. Du kan ändra vad du vill — lägga dit logotypen, ändra texter, lägga till en panel med en bild bredvid, pilla på färgerna, skriva händelser i TypeScript.

Det som inte går att ändra står i själva panelen: ”Systemskärm — rutt, parametrar och åtkomst är fasta.”

Vad som är fast	Varför
Rutten (/register, /recover)	Det är via den appen serverar skärmen; att ändra den skulle bryta ingången.
Parametrarna	En systemskärm tar inte emot parametrar från rutten.
Åtkomsten	De är publika till sin natur — det vore meningslöst att kräva session av skärmen som ger sessionen.

Allt annat finns där: Skärmens mall (layouten), Data, Beteende, Utseende (bakgrundsfärgen, en bild från appens filer) och Händelserna — onLoad, onParamsChange, onUnload.

#Hur skärmarna beter sig i runtime

#Inloggning

Personen skriver Användarnamn och Lösenord och klickar på Logga in. Kontona är appens konton — se Appens användare.

Om appen kör i läget OAuth / OpenID Connect delegeras inloggningen till organisationens identitetsleverantör och Login-skärmen fungerar som port in i det flödet.

#Återställa lösenordet

Länken Jag har glömt lösenordet leder till /recover:

Personen skriver sin e-postadress, klickar på Skicka, och får en länk för att återställa lösenordet.

#Publik registrering

Skärmen frågar efter Namn, E-post, Användarnamn och Lösenord och skapar kontot med Registrera. Tillbaka till inloggningen för personen tillbaka till ingången.

#Slå på (eller av) den publika registreringen

Reglaget finns under Appens inställningar → Autentisering, i avsnittet Registrering och återställning — ”publika systemskärmar i runtime: registrering av användare och återställning av lösenord”.

Fält	Vad det gör
Tillåt publik registrering	Påslaget: ”vilken besökare som helst kan skapa ett konto på skärmen /register. Avstängt serveras inte skärmen”.
Roll för nya registreringar	”Roll som automatiskt tilldelas den som registrerar sig.” Eller Ingen roll.

Spara med Spara (”Autentiseringen har sparats.”).

Och det omvända gäller också: en öppen registrering är en öppen dörr. I en intern applikation är det normala att ha den publika registreringen avstängd och skapa kontona för hand i inställningarna. Slå på den bara när allmänheten verkligen är allmänheten — en kundportal, ett anmälningsformulär.

#Öppna en vanlig skärm för allmänheten

Utöver de tre systemskärmarna kan vilken skärm som helst i appen serveras utan session. Öppna skärmen i byggaren, klicka på en tom yta på duken för att markera skärmen, och slå på Publik skärm (utan session) i egenskapernas avsnitt Åtkomst.

Varningen som dyker upp efteråt är hela regeln: ”Serveras utan inloggning. Data kommer bara från publika API:er.”

Vad det innebär i praktiken:

1. Skärmen serveras till den som kommer via adressen, utan autentisering.
2. De data den visar måste komma från API:er som markerats som publika. Ett API som inte är publikt returnerar ingenting: ”det här API:et har ingen publik läsning — på en skärm utan session laddas inga data.”
3. I tabell-API:erna slår avsnittet Publik åtkomst (utan session) på operation för operation — ”operationer som publika skärmar (utan inloggning) får anropa. Aktivera bara det som behövs.”

Typiska fall: en statussida, ett kontaktformulär, en katalog. Se Publika API:er.

#Vanliga frågor

Var är skärmen för ”ange nytt lösenord”? Det är återställningens andra halva och den serveras via länken som skickas i mejlet. Skärmen du designar är den som frågar efter e-postadressen.

Jag ändrade Login-skärmen och den gamla visas fortfarande. Skärmen som serveras är den i den version som adressen serverar. Om du redigerade i en annan version fortsätter den publicerade adressen att servera den version som är kopplad till den — se Versioner och publicering.

Kan jag dölja återställningslänken? Ja — Login-skärmen är din. Ta bort länken på duken. Skärmen /recover finns kvar, men har inte längre någon dörr från ingången.

Registreringen skapar kontot men personen kan inte logga in. Kontrollera att kontot blev Aktiv och att Roll för nya registreringar pekar på en roll som finns. Ett aktivt konto utan roll loggar in och ser ingenting, vilket brukar tolkas som ”jag kunde inte logga in”.