Externe diensten

Sommige apps hebben een dienst buiten kvyk.ai nodig: een kaart die haar tegels laadt, of een dienst die de coördinaten van een adres opzoekt. De app roept zo’n dienst rechtstreeks aan vanuit de browser van wie de app gebruikt, dus de dienst ontvangt hun verzoeken en hun IP-adres. Daarom staat elk extern adres dat een app aanroept op de pagina van de app, en beslist een Administrator welke Live mag aanroepen.

Een adres dat de app niet opgeeft, is geblokkeerd, in Preview en op Live.

Hoe een app een extern adres krijgt

Vraag het de assistent in het gesprek van de app, bijvoorbeeld Toon de leveringen op een kaart of Zoek de coördinaten op als iemand een adres typt. De assistent somt elk extern adres op dat de app aanroept, elk met de reden waarom, en zorgt dat de app er tegen kan als een aanroep mislukt.

Probeer het in Preview

Preview roept de adressen die de app opgeeft meteen aan, zodat je de app direct kunt proberen. Boven de preview zegt de pagina van de app wat ze gebruikt dat Live nog niet toestaat, bijvoorbeeld Gebruikt nominatim.openstreetmap.org, nog niet toegestaan op Live.

Zie wat een app aanroept

Op de pagina van de app staat onder Externe diensten elk adres dat de app aanroept, met:

• Waarom: de reden die de app ervoor geeft;
• Aangeroepen door: of de versie op Preview, op Live of allebei het aanroepen, of Geen versie roept het aan als het niet meer gebruikt wordt;
• Op Live: wie het toestond en wanneer, of Wacht op een Administrator.

Een adres toestaan op Live

Een externe dienst die de apps aanroepen, is een van de toegestane diensten van je organisatie, dezelfde lijst die zegt welke diensten je automatisaties mogen aanroepen. Live laat een app een adres aanroepen zodra een Administrator die app toestond op de toegestane dienst van het adres. Elke app wordt apart toegestaan: roept een tweede app dezelfde dienst aan, dan wacht die op haar eigen toestemming, en de dienst blijft één keer op de lijst staan.

Een Administrator staat een app op een van deze plaatsen toe, en dat is meteen de goedkeuring:

• Op de pagina van de app, onder Externe diensten, kies je Toestaan naast het adres en bevestig je.
• Publiceer je een versie die een adres aanroept dat nog geen Administrator toestond, dan noemt de publicatiekaart elk adres en de reden ervan, en zegt ze dat publiceren ze toestaat op Live. Kies Toestaan en publiceren.
• Onder Technisch → Toegestane diensten open je de dienst en kies je de app onder Een app toestaan.

Heeft nog geen toegestane dienst het adres, dan vraagt toestaan om de Naam, de Ontvanger (het bedrijf erachter) en het Doel van de dienst, en komt hij bij je toegestane diensten.

Vraag je de assistent een adres toe te staan, dan vraagt hij je eerst in het gesprek om te bevestigen.

Als de app van een Builder een adres nodig heeft

Een Builder kan de app meteen maken en proberen in Preview. Roept zijn versie een adres aan dat de app op Live nog niet mag aanroepen, dan krijgen de Administrators de vraag: die staat op hun Goedkeuringen met de app, het adres en waarom, en elk krijgt een mail zoals Shop toestaan om nominatim.openstreetmap.org te gebruiken?. Een Administrator kiest Goedkeuren, en vult de dienst in als die er nog niet is, of Afwijzen, waarmee het op Live geblokkeerd blijft.

Tot dan kan de Builder al het andere publiceren, maar die versie niet: de kaart zegt De Administrators krijgen de vraag om … toe te staan, en de versie blijft intussen werken in Preview.

Elke toestemming en elke intrekking staat onder Technisch → Gebeurtenissen, met wie het deed.

Een toestemming intrekken

Kies op de pagina van de app Intrekken naast het adres en bevestig, of open de dienst onder Toegestane diensten en kies Intrekken naast de app. Live blokkeert het meteen, en dat doet het ook als je de dienst verwijdert. Een versie die het nog aanroept, wacht weer op een Administrator voordat ze wordt gepubliceerd.

Roept de app een adres niet meer aan, dan bereikt ze het niet meer vanaf de volgende versie die je publiceert. De toestemming blijft in de lijst staan met Geen versie roept het aan, zodat je ze kunt intrekken.

Goed om te weten

• Het gaat hier alleen om aanroepen vanuit de browser van de bezoeker. Sleutels voor een externe dienst horen in Variabelen en geheimen, nooit in de code van de app.
• Scripts en stijlen die een app van andere sites laadt, zoals een chatvenster, staan bij haar versie: zie Publiceer een app.
• Bereikt je app een dienst niet, vraag de assistent dan Waarom bereikt mijn app … niet?. Meestal geeft de app het adres nog niet op, of staat Live het nog niet toe.