🔗 Bronartikel (Salesforce): Klik hier
Gebruik dit artikel om als titularis of administrator een nieuwe API-sleutel aan te maken of een bestaande API-sleutel te vernieuwen in CareConnect Pharmacist (CCP). Na het doorlopen van de stappen hieronder is uw API-sleutel aangemaakt, gekopieerd naar CareConnect Pharmacist en opgeslagen, zodat de cloudverbinding van uw apotheek weer actief is.
Samenvatting
Log in als titularis of administrator in uw software. U kunt een nieuwe API-sleutel genereren via het webportaal.
Ga via uw naam (rechtsboven in de cloud) naar "Configuraties".
Open het scherm "Beveiliging & toegang", waar u een nieuwe API-sleutel kunt aanmaken.
Geef de API-sleutel een naam (bijvoorbeeld API 2026).
Selecteer de juiste apotheek.
Kies bij "Toegangsrechten" de optie Lezen & schrijven.
Selecteer bij "Scope" de optie Volledige toegang.
Kies bij "Vervaldatum" voor een standaardvernieuwing 12 maanden.
Kopieer na het aanmaken de API-sleutel naar het klembord.
Ga terug naar de knop "Cloud" in het startscherm van CareConnect Pharmacist.
Klik op "Plakken" om de nieuwe API-sleutel toe te voegen en klik daarna op "Opslaan".
Statussen van het Cloud-icoon op de startpagina
Het Cloud-icoon op de startpagina van CareConnect Pharmacist toont de status van uw API-sleutel.
Als uw API-sleutel nog niet is verlopen, is het cloudpictogram oranje met een rood uitroepteken
.
Als de apotheek geen API-sleutel heeft geconfigureerd, of als uw geconfigureerde API-sleutel is verlopen, heeft het cloudpictogram een rood kruisje
.
Oplossing: een API-sleutel vernieuwen of aanmaken
De titularis van de apotheek kan zelf de API-sleutel vernieuwen of aanmaken
. Om de API-sleutel te vernieuwen of aan te maken, moet er een MCN-token aangevraagd zijn met de gegevens van de titularis (via eID of via SOS met het SSIN-certificaat van de titularis).
Stap 1: Start CareConnect Pharmacist op met de gebruikersnaam en het wachtwoord van de titularis
.
Stap 2: Klik op het Cloud-icoon op de startpagina van CareConnect Pharmacist. Dit icoon is oranje als de API-sleutel bijna vervalt, of heeft een rood kruis als er geen geldige API-sleutel meer aanwezig is.
Het Cloud-configuratievenster opent. Controleer hier of het de API-sleutel is die vernieuwd moet worden of vervallen is, of controleer uw certificaat(en). Voor vragen over certificaten kan u onze helpdesk contacteren.
Er zijn twee methodes om de API-sleutel te vernieuwen:
Methode 1: inloggen via de knop "Webportaal" op de startpagina.
Methode 2: klikken op de knop "Generatie API-sleutel" nadat u op het Cloud-icoon heeft geklikt om de cloudomgeving te openen.
Methode 1: via de knop "Webportaal" op de startpagina
Via de knop "Webportaal" komt u automatisch in de cloud terecht en kan u verder bij de stap "Een nieuwe API-sleutel aanmaken" verderop in dit artikel.
Let op: u moet in uw software ingelogd zijn als titularis.
Methode 2: via de knop "Generatie API-sleutel"
Stap 3: De cloudmodule opent in een nieuw venster in uw browser. Klik op "Aanmelden".
Stap 4: Meld u aan via Corilus Passport met behulp van uw identiteitskaart.
Tip: wanneer u zich niet kunt aanmelden met uw eID omdat het scherm blijft laden of omdat u telkens uw certificaat uit een lange lijst moet kiezen, maak dan eerst de Windows Certificate Store leeg en probeer daarna opnieuw. Raadpleeg hiervoor de handleiding.
Een nieuwe API-sleutel aanmaken
Stap 5: Klik, nadat u bent aangemeld, rechtsboven op de naam van de titularis. Kies in het menu de optie "Configuratie".
Stap 6: Klik op de tegel "Beveiliging en toegang" om toegang te krijgen tot de API-sleutelconfiguratie.
Klik vervolgens rechtsbovenaan op "Nieuw" om een nieuwe API-sleutel te genereren.
Stap 7: Er opent een nieuw venster om de details van de API-sleutel in te geven. Er wordt gevraagd om een omschrijving voor de API-sleutel in te geven
. We adviseren om hier een duidelijke naam te gebruiken (bijvoorbeeld het API-jaartal en de naam van de titularis), zodat u later weet in welke context deze API-sleutel werd aangemaakt
.
Aangezien u in de applicatie bent ingelogd als apotheker voor een specifieke apotheek, kan u de "Organisatie" niet wijzigen.
Er zijn verder opties beschikbaar om de toegangsrechten van de nieuwe API-sleutel te configureren. Indien u een API-sleutel aanmaakt om in CareConnect Pharmacist te gebruiken, dient u de standaardwaarden te behouden, namelijk "Lezen & schrijven" en "Volledige toegang".
Daarnaast kan u de vervaldatum
voor de API-sleutel selecteren. Standaard staat deze op 1 week, en dit kan maximaal uitgebreid worden tot 12 maanden. Nadien is de API-sleutel niet meer geldig en dient u een nieuwe aan te maken. Voor de vervaldatum zijn een aantal standaardopties beschikbaar, of u kan via de optie "Aangepast" zelf een einddatum selecteren.
Klik vervolgens op de knop "Creëren"
rechtsonderaan om de nieuwe API-sleutel aan te maken met de door u geselecteerde instellingen.
Wanneer de API-sleutel succesvol werd aangemaakt, krijgt u hiervan een bevestiging.
Kopieer de API-sleutel meteen naar het klembord via de hiervoor voorziene knop. De API-sleutel wordt nadien niet meer bewaard en kan dus niet meer opgeroepen worden als u het venster sluit. Als u vergeet de API-sleutel te kopiëren voordat u het venster sluit, moet u een nieuwe API-sleutel aanmaken.
Als de API-sleutel naar het klembord werd gekopieerd, krijgt u hiervan ook een bevestiging:
Tip: we adviseren u om het scherm met de API-sleutel nog even open te laten staan in uw browser tot u de laatste stappen succesvol hebt uitgevoerd. Zo kan u de API-sleutel nog opnieuw naar het klembord kopiëren mocht er in de volgende stap iets misgaan.
Ga nu terug naar de Cloud-configuratie in CareConnect Pharmacist. Klik op de knop "Plakken"
om de gekopieerde API-sleutel hier in te geven. Klik vervolgens op de knop "Opslaan" in dit scherm
.
Certificaten bij het vernieuwen van een API-sleutel
Bij het vernieuwen van een API-sleutel is het niet nodig om de certificaten van de apotheek opnieuw te uploaden, behalve als een of beide certificaten niet langer geldig zijn. Dit herkent u aan het rode kruisje
.
In dit geval moet u het "SOS MCN"-wachtwoord invoeren
voordat u op "Certificaten uploaden"
klikt. Hierdoor worden de certificaten gevalideerd. Klik vervolgens op "Opslaan".
Dezelfde procedure is van toepassing als het certificaat van de apotheek en/of de titularis is gewijzigd.