Leer hoe je API-toegang verleent aan externe applicaties in je Banqup-space met het nieuwe vereenvoudigde autorisatiesysteem.
Als je bedrijf aangepaste software of externe applicaties gebruikt die moeten verbinden met Banqup, kan je ze nu toegang verlenen via een eenvoudige interface in je space-instellingen. Dit vermijd het gebruik van complexe handmatige API-configuraties.
Wat zijn externe applicaties?
Externe applicaties zijn aangepaste softwareoplossingen of externe tools die ontwikkelaars maken om te werken met je Banqup-gegevens via onze API's. Deze kunnen omvatten:
Aangepaste integraties specifiek gebouwd voor je bedrijf.
Externe bedrijfstools.
Geautomatiseerde workflowsystemen die je facturen of betalingen verwerken.
Hoe autorisaties voor externe apps werken
Wanneer een ontwikkelaar een applicatie maakt die toegang nodig heeft tot je Banqup-space, registreren ze deze eerst in het Banqup Developer Portal en maken ze een app, waarna ze een App ID ontvangen (een unieke identificatie voor hun applicatie).
Om effectief toegang te krijgen tot je gegevens, moet jij als space manager expliciet toestemming geven aan dat App ID. Een beetje zoals hoe je een nieuwe gebruiker zou uitnodigen voor je space en hen een rol zou toewijzen.
Toegang verlenen aan externe applicaties
Ga naar je Space instellingen
Klik op de kaart Externe applicaties.
Klik op Externe app toevoegen.
Een installatiewizard begeleidt je door het proces:
Stap 1 - App-details:
Applicatienaam: Voer een herkenbare naam in voor de applicatie (dit is voor je eigen referentie).
App ID: Voer het unieke App ID in dat door de ontwikkelaar is verstrekt.
Stap 2 - Toegang verlenen:
Kies de juiste rol(len) voor deze applicatie. De rol bepaalt welke gegevens en acties de app kan benaderen in je ruimte. Het zijn dezelfde rollen die je aan gebruikers kunt toewijzen.
Stap 3 - Bevestigen:
Bekijk de details en bevestig door te klikken op Applicatie toevoegen.
Zodra je externe applicaties hebt toegevoegd, verschijnen ze in een tabel met de app-naam, App ID en hun status.
Best practices voor beveiliging
Verleen alleen noodzakelijke autorisaties: Geef externe applicaties het minimale toegangsniveau dat ze nodig hebben om te functioneren.
Controleer App ID's zorgvuldig: Controleer het App ID dat door je ontwikkelaar is verstrekt om er zeker van te zijn dat je toegang verleent aan de juiste applicatie.
Regelmatige beoordeling: Bekijk periodiek je externe applicaties en verwijder toegang voor die niet meer nodig zijn.
Vertrouw je ontwikkelaars: Verleen alleen toegang aan applicaties van ontwikkelaars en bedrijven die je vertrouwt.
Rollen van een externe applicatie bewerken
Na het toevoegen van een applicatie kun je nog steeds de autorisaties bewerken:
Klik op de drie puntjes in de kolom Acties voor de applicatie van je keuze.
Klik op Details bekijken. Vanaf daar kun je de huidige toegewezen rollen zien.
Klik op Bewerken om rollen toe te voegen of te verwijderen.
Sla je wijzigingen op.
Je kunt op elk moment aanvullende externe applicaties toevoegen met hetzelfde proces.
Een externe applicatie verwijderen
Als je de toegang van een externe applicatie tot je ruimte moet verwijderen:
Klik op de drie puntjes in de kolom Acties voor de applicatie die je wilt verwijderen.
Klik op Verwijderen.
Bevestig je keuze.
Dit verwijdert volledig alle toegang voor die applicatie tot je Banqup-ruimte.
Werken met ontwikkelaars
Bij het werken met een ontwikkelaar om een aangepaste integratie te maken:
Zij maken de app: De ontwikkelaar zet een account op in het Banqup Developer Portal en maakt hun applicatie.
Zij verstrekken het App ID: De ontwikkelaar geeft je het unieke App ID voor hun applicatie.
Jij verleent autorisaties: Je gebruikt het bovenstaande proces om het juiste toegangsniveau te verlenen.
Testen en implementatie: De ontwikkelaar kan dan hun integratie testen en implementeren.
FAQ
Het App ID werkt niet, wat moet ik doen?
Controleer het App ID bij je ontwikkelaar en zorg ervoor dat ze hun applicatie correct hebben geregistreerd in het Developer Portal.
Hoe verander ik de autorisaties van een app?
Je kan rollen bewerken voor elke externe applicatie zoals hierboven uitgelegd in de sectie Rollen van een externe applicatie bewerken.