Naar de inhoud

Instellingen en geheimen

Instellingen en wachtwoorden voor je website, zoals API-sleutels, veilig bewaren.

Soms heeft je website gegevens nodig die niet in de code horen. Bijvoorbeeld:

  • een API-sleutel: een soort wachtwoord waarmee je website een andere dienst mag gebruiken, zoals een betaalsysteem of een kaart;
  • een wachtwoord voor je beheerpagina;
  • een instelling, zoals het e-mailadres waar contactformulieren naartoe gaan.

Die bewaar je bij Instellingen & geheimen. Programmeurs noemen dit environment variables (omgevingsvariabelen). Je website kan ze lezen, maar ze staan niet in je bestanden en dus ook niet op GitHub.

#Een instelling toevoegen in het dashboard

  1. Open je website in het dashboard en ga naar Instellingen & geheimen.
  2. Scroll naar beneden. Onder je lijst met instellingen staat het blok Instelling toevoegen.
  3. Vul een naam in, in hoofdletters met liggende streepjes, zoals MOLLIE_API_KEY of CONTACT_EMAIL.
  4. Vul de waarde in en zet de schakelaar Geheim aan of uit. Een geheim kun je daarna niet meer inzien, alleen vervangen. Namen met KEY, SECRET, PASSWORD of TOKEN worden vanzelf als geheim gemarkeerd.
  5. Sla de instelling op. Klik op Toevoegen (of op Vervangen, als de naam al bestaat). Er verschijnt een gele melding Herstart nodig: klik daarin op Herstart nu. Je website leest de nieuwe instelling pas na een herstart.

#Via je AI of de terminal

Je kunt het ook aan je AI vragen:

Of zelf in de terminal, in de map van je website:

Terminal
npx -y @switchboard-host/cli@latest env set CONTACT_EMAIL info@bakkerijjansen.nl
npx -y @switchboard-host/cli@latest env set MOLLIE_API_KEY --secret
npx -y @switchboard-host/cli@latest env list

Zonder waarde (zoals bij de sleutel hierboven) vraagt de terminal erom, zodat de sleutel niet in je geschiedenis terechtkomt. Verwijderen doe je met npx -y @switchboard-host/cli@latest env unset NAAM.

#De instelling gebruiken in je website

Vertel je AI welke instelling er is, bijvoorbeeld: "De Mollie-sleutel staat in de instelling MOLLIE_API_KEY. Gebruik die voor de betaling." Je AI weet hoe hij hem moet uitlezen.

Voor het voorbeeld op je eigen computer zet je AI dezelfde instellingen in een bestand .env in je websitemap. Dat bestand gaat nooit naar Switchboard of GitHub.

#Namen die al bezet zijn

Sommige instellingen regelt Switchboard zelf, zoals DATABASE_URL en PUBLIC_URL. Die kun je niet zelf instellen. Ook namen die beginnen met SB_, EMAIL_, AWS_, S3_ of SWITCHBOARD_ zijn gereserveerd. Zie platformvariabelen.

Had je hier iets aan?

Handleiding

Zoeken in de handleiding

Typ een woord of een vraag. Tip: druk op Ctrl K om dit venster overal te openen.