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
- Open je website in het dashboard en ga naar Instellingen & geheimen.
- Scroll naar beneden. Onder je lijst met instellingen staat het blok Instelling toevoegen.
- Vul een naam in, in hoofdletters met liggende streepjes, zoals
MOLLIE_API_KEYofCONTACT_EMAIL. - 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,PASSWORDofTOKENworden vanzelf als geheim gemarkeerd. - 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:
- "Zet de instelling CONTACT_EMAIL op info@bakkerijjansen.nl."
Of zelf in de terminal, in de map van je website:
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 listZonder 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.