Variabelen en geheimen

Apps hebben vaak een sleutel nodig: een voor een kaart, een analytics-ID of de API-sleutel van een externe dienst. Zo’n sleutel schrijf je nooit in de code van een app: wie de app opent, kan de code lezen, en kvyk.ai houdt een versie met een sleutel erin tegen. Sleutels en instellingen horen in Variabelen en geheimen, op Technisch → Sleutels en geheimen in de zijbalk.

Alleen Builders en Administrators zien en wijzigen ze.

Variabelen en geheimen

Elk item heeft een naam, zoals MAPS_KEY, een waarde voor Preview en een waarde voor Live, zodat je apps in Preview een testsleutel kunnen gebruiken en in Live de echte.

Elk item is een van twee soorten:

• Variabele. Je apps kunnen ze in de browser lezen, in de stage waarin ze draaien. Iedereen die de app opent, kan ze zien, dus gebruik dit alleen voor sleutels die openbaar mogen zijn, zoals een Maps-sleutel die je bij de aanbieder beperkt tot het adres van je app.
• Geheim. Het komt nooit in een browser. Alleen code op de servers van kvyk.ai kan het gebruiken, zoals de aanroepen van andere diensten door je automatisaties. Een nieuw item is een geheim, tenzij je iets anders kiest.

De pagina toont elk item in een tabel: de naam, de soort, In de browser (Ja voor een variabele, die apps in de browser mogen lezen, Nee voor een geheim, dat op de server blijft), de waarden voor Preview en Live, en Wacht op publiceren als Live het nog niet heeft. De waarden van een variabele worden getoond. De waarden van een geheim zijn verborgen achter puntjes: eenmaal opgeslagen worden ze nooit meer getoond, ook niet aan jou. Kies een rij om het item te openen.

Een item toevoegen

1. Open Technisch → Sleutels en geheimen en kies onder Variabelen en geheimen Toevoegen.
2. Geef het een naam in hoofdletters, cijfers en _, zoals MAPS_KEY.
3. Kies de soort: Geheim of Variabele.
4. Typ de waarde voor Preview en de waarde voor Live als je ze hebt, en kies Toevoegen.

De waarde van een geheim blijft verborgen terwijl je typt. Om ze op een tikfout te controleren, kies je het oog naast het veld (Waarde tonen), en kies je het nog eens (Waarde verbergen) om ze weer te verbergen. Een opgeslagen waarde wordt nooit meer getoond, dus het oog verschijnt pas als je iets typt.

Om een item te wijzigen, open je het. Bovenaan de pagina staat waar de waarden mogen komen: Apps kunnen het in de browser lezen voor een variabele, Alleen op de server: komt nooit in een browser voor een geheim. De waarden van een variabele pas je ter plaatse aan; maak er een leeg om ze weg te halen. Bij een geheim typ je een nieuwe waarde om ze te vervangen, of kies je Wissen om ze weg te halen. Kies daarna Opslaan. Als je van een geheim een variabele maakt, wordt dat eerst gevraagd, want de waarden worden zichtbaar voor iedereen die je apps opent.

Je kunt het ook aan de assistent vragen, bijvoorbeeld Mijn kaart heeft een Google Maps-sleutel nodig. Hij stelt het item voor op een kaart in de chat, waar je de waarden zelf typt: ze gaan rechtstreeks naar kvyk.ai, en de assistent ziet ze nooit. Plak een sleutel nooit in de chat zelf.

Preview en Live

Preview gebruikt een wijziging meteen, zodat je ze direct in de preview van je app kunt uitproberen. Live blijft gebruiken wat het had tot je publiceert: een nieuw item, een nieuwe waarde voor Live, een gewijzigde soort en een verwijdering zeggen Opgeslagen, wacht op Publiceren. en wachten samen als één item onder Variabelen en geheimen in het publicatiepaneel, dat Publiceren in de bovenbalk opent. Vink het aan, samen met de app die ze nodig heeft, en kies Publiceren. Zie Wijzigingen publiceren en terugdraaien.

Een variabele gebruiken in een app

Als de assistent een app bouwt die een sleutel nodig heeft, leest hij de variabele in plaats van de sleutel in de code te schrijven. Een gepubliceerde app leest ze in de stage waarin ze draait: de waarde voor Preview op het Preview-adres, die voor Live op het eigen adres. Als een waarde verandert, hoef je geen nieuwe versie te bouwen, alleen de wijziging te publiceren.

Een item verwijderen

Kies op de pagina van het item Verwijderen en bevestig. Preview verliest het meteen en Live zodra je publiceert; apps die het lezen, krijgen dan niets meer.

Elke wijziging staat onder Technisch → Gebeurtenissen, met de naam van het item en wie ze maakte, nooit de waarden.