För dig på Whitespace

Dela en webbplats med Kvarts

Du har en prototyp, en demo eller en sida som andra behöver se. Med Kvarts kan du publicera den på en webbadress och vid behov kräva inloggning.

Så kommer du igång

När passar Kvarts?

Använd Kvarts när du vill ge kollegor eller en kund en länk till något de ska titta på, testa eller lämna synpunkter på.

  • Visa en prototyp. Dela en fungerande webbversion inför en avstämning eller ett användartest.
  • Publicera en mindre webbplats. Lägg ut exempelvis projektdokumentation, en demo eller en informationssida som den här.
  • Dela en befintlig tjänst med inloggning. Låt Kvarts kontrollera besökarnas åtkomst innan de når tjänsten.

Två sätt att dela

Publicera filer som en statisk webbplats

Du laddar upp en mapp med HTML, CSS, JavaScript och bilder. Kvarts visar filerna på en adress som min-demo.kvarts.network, med HTTPS.

Det passar även en webbplats byggd med exempelvis React eller Vue, så länge du publicerar den färdigbyggda mappen. Kvarts kör inte en egen Node- eller PHP-server åt en statisk webbplats.

Din mappKvartsEn länk att dela

Visa en befintlig webbplats genom en proxy

En proxy skickar besökarens förfrågan vidare till en webbplats som redan körs någon annanstans. Du kan ge den en Kvarts-adress och lägga till regler för inloggning.

Den befintliga webbplatsen måste fortsätta vara igång. Kvarts flyttar inte dess innehåll, databas eller administration.

Vem får komma in?

En webbplats kan vara öppen eller kräva inloggning för hela sidan eller valda delar. På skyddade sidor loggar besökaren in med sitt personliga konto via Rauthy, tjänsten som hanterar inloggningen.

Att ha ett konto ger inte tillgång till alla sidor. Ditt konto behöver också rätt behörighet, ofta genom en grupp för projektet eller webbplatsen.

Två olika behörigheter
Du villDu behöver
Besöka en skyddad sidaEtt personligt konto och tillgång till just den sidan.
Publicera eller ändra en sidaKvarts kommandoradsverktyg, en API-nyckel med rätt behörigheter och projektets ID.

En länk är inte ett åtkomstskydd

Kontrollera att rätt inloggningsregler är aktiva innan du delar material som inte ska vara offentligt. För en proxy kan den ursprungliga adressen fortfarande vara öppen. Ta hjälp av den som ansvarar för tjänsten om även den vägen behöver stängas.

Kom igång med din första sida

  1. Välj vad du vill dela. Har du färdiga webbfiler, eller en webbplats som redan körs? Bestäm också vilka som ska få se den.
  2. Kontakta projektets ansvariga. Be om hjälp att publicera, eller få verktyget kvarts, en API-nyckel och rätt projekt-ID om du ska göra det själv.
  3. Publicera och kontrollera. Öppna länken och testa att sidor, bilder och länkar fungerar. Om sidan ska vara skyddad, kontrollera den även utloggad i ett privat webbläsarfönster.
  4. Dela länken. Berätta vad mottagaren ska titta på och om ett konto eller en särskild behörighet behövs.
För dig som publicerar själv i terminalen

Du behöver ha kvarts installerat och din API-nyckel tillgänglig i miljövariabeln MALM_API_KEY. Verktyget använder https://api.kvarts.network som standard.

Byt ut DITT_PROJEKT_ID mot projektets ID och välj ett ledigt namn i stället för min-demo:

kvarts create min-demo --project-id DITT_PROJEKT_ID
kvarts deploy ./dist --name min-demo

Mappen ./dist ska innehålla den färdiga webbplatsen, med index.html direkt i mappen. Sidan får adressen https://min-demo.kvarts.network/. Det kan ta en stund innan adressen och HTTPS är klara.

För att uppdatera sidan kör du samma kvarts deploy-kommando igen. Behöver du skydda sidan, ordna inloggningsreglerna med projektets ansvariga innan du publicerar känsligt innehåll.

Vanliga frågor

Behöver jag kunna använda terminalen?

Bara om du ska publicera själv. För att titta på, testa och dela en sida räcker webbläsaren. En kollega med rätt behörighet kan hjälpa dig med publiceringen.

Jag kan logga in, men kommer inte åt sidan. Varför?

Inloggning och tillgång till sidan är två olika saker. Be projektets ansvariga kontrollera att ditt konto har rätt grupp eller behörighet för sidan.

Kan jag lägga upp en WordPress-webbplats?

En WordPress-installation behöver en server och databas. En redan fungerande installation kan visas genom en proxy. Kvarts-inloggning ger inte automatiskt ett konto eller en administratörsroll i WordPress.

Kan sidan ha en egen domän?

Ja. Ta hjälp av den som ansvarar för Kvarts för att koppla domänen och ordna dess DNS-inställningar.

Fördjupning

Här finns nästa steg för dig som publicerar själv, utvecklar en tjänst eller administrerar åtkomst.