Inloggning

Med pluginet mail-auth loggar alla utom super-admin in med e-post: de skriver in sin adress och får en länk som loggar in dem. De har inget lösenord.

• Länken gäller 10 minuter och en gång. Den leder tillbaka till den sajt där den begärdes.
• Samma svar oavsett adress. Den som ber om en länk får alltid samma besked på inloggningssidan (Om kontot finns har vi skickat en inloggningslänk till din e-post.), också om adressen saknar konto; mejl går bara till kända adresser. Så avslöjas inte vilka adresser som har konto.
• En adress, ett konto. Har två konton samma adress skickas ingen länk. Hälsokontrollen säger till.
• Ändrade rättigheter gäller direkt. Tar du bort någon ur en grupp, eller stänger av kontot, gäller det vid nästa sidvisning, inte först när personen loggar ut.
• Mejlen är på svenska (eller engelska), se Mejlen nedan.

Formuläret sajten börjar med

Logga in i sidhuvudet, och en skyddad sida för den som inte är inloggad, visar ett av två formulär:

• Användarnamn och lösenord (standard). Det formulär super-admin använder. Alla andra klickar vidare till Logga in med länk.
• Länk via e-post. Formuläret där man skriver in sin adress och får en länk. Under det står länken Logga in med användarnamn och lösenord, så super-admin når alltid sitt formulär.

Välj länk via e-post när nästan alla som loggar in är e-postkonton.

• Alla sajter, också nya: System-Admin → Temainställningar → Header — links → Sign-in form. Det gäller varje sajt som inte har ett eget val.
• En sajts eget val: sajtens Site-Admin → Inställningar, samma fält. Bara super-admin ändrar det.

Inloggningsmejlet leder alltid till formuläret för länk via e-post, oavsett vad sajten börjar med (Mejlen, nedan).

Hur länge inloggningen gäller

En inloggning gäller tills den inte har använts på en viss tid. Tiden ställs in en gång, för alla sajter i installationen:

• Var: Admin på grundsajten → Configuration → System → Session → Timeout, i sekunder. Det sparas i user/config/system.yaml som session.timeout.
• Standard: 1800, alltså 30 minuter. 7200 är 2 timmar, 2592000 är 30 dagar.
• Räknat från senaste aktivitet. Varje sidvisning eller sparning startar om tiden. Den som är borta längre än så får logga in igen.
• Gäller alla sajter. En inloggning gäller alla sajter, och därför är tiden densamma överallt. Detsamma gäller alla andra inställningar under Session. En sajts egen Admin visar grundsajtens värden och säger ifrån om man försöker ändra dem där.
• Kom ihåg mig (rutan vid super-adminens inloggning med lösenord) håller inte kvar någon längre än den inställda tiden.
• Admin har en egen inloggning, men den följer samma tid. Står Admin öppen utan att användas längre än så, ber den om en ny inloggning.

Mejlen

Tre mejl kan gå ut, alla som HTML och text. Ämnesraden har sajtens titel (en subsajts egen titel i dess mejl), och mejlet slutar med sajtens titel, inte med någons namn:

Alla slutar med "Har du inte bett om det här kan du bortse från mejlet." Inget mejl säger något om kontot (grupper, rättigheter, vem som lade till det). Glömt lösenord i Admin skickar Admins eget mejl, på engelska.

• Språket är inställningen Mail language i pluginet mail-auth (mail_language: sv eller en, i user/config/plugins/mail-auth.yaml, gemensamt för alla sajter). En subsajt kan ha ett eget i sin config/plugins/mail-auth.yaml. Är Gravs flerspråkighet påslagen används det aktiva språket i stället. Andra språk än svenska och engelska ger engelska. Inloggningssidorna följer i stället temats Interface language (se Temainställningar → Gränssnittets språk).
• Avsändaren är e-postpluginets inställningar: adressen from och namnet from_name (Admin → Plugins → Email). Sätt namnet till sajtens namn.
• Egen text: mallarna ligger i pluginet (templates/emails/mail-auth/) och kan skrivas över med en fil med samma namn i temats templates/, se pluginets README.md → Mails.

Lägga till ett konto

Från public/:

php bin/plugin mail-auth add anna@example.com --group styrelsen --name "Anna Andersson"

Kontot får adressen, rätten att logga in och grupperna. Inget lösenord sätts. Finns adressen redan på ett konto säger kommandot ifrån.

• --mail skickar inloggningsmejlet: en välkomst med länk till sajtens formulär för länk via e-post. Utan --mail skickas inget mejl.
• --site <sajt> gäller en av flera sajter: grupperna får sajtens namn först (--site medlem --group styrelsen ger gruppen medlem--styrelsen) och mejlet länkar till den sajtens inloggning. Med --group editors blir personen också editor för den sajten (adressen läggs i sajtens lista).
• Gruppnamn följer samma regel som i avsnittet Members: gemener, siffror, _ och enkla bindestreck (inte - först eller sist, inte --).

php bin/plugin mail-auth add anna@example.com --site medlem --group styrelsen --mail

Oftast behövs inte kommandot: sajtens site-admins bjuder in medlemmar själva, se Medlemmar och grupper. php bin/plugin mail-auth check listar adresser med flera konton och e-postkonton som ändå har ett lösenord.

Skapar du kontot i Admin (Accounts → Users) kräver Admin ett lösenord, men det tas bort direkt om kontot inte är super-admin. Ett e-postkonto kan inte heller få ett lösenord i Admin efteråt.

Grupper

En grupp ger sidrättigheter på vanligt sätt (se Åtkomst): gruppen styrelsen med behörigheten site.group.styrelsen i Admin (Accounts → Groups), och sidan med regeln site.group.styrelsen: true. Site-admins skapar grupper själva i Medlemmar och grupper.

Med flera sajter har en sajts grupper sajtens namn först: medlem--styrelsen hör till sajten medlem. En grupp utan sajtnamn (styrelsen) hör till grundsajten och är gemensam: alla sajter kan välja den i sin regel, till exempel en styrelse som läser både den publika sajten och medlemswebben. De gemensamma grupperna sköts av system-admin och grundsajtens site-admin. En sajt kan aldrig välja en annan sajts grupper.