FAQ - CCP - Hoe een API-sleutel aanmaken in CCP?

🔗 Source article (Salesforce): Click here

Samenvatting:

Log in als Titularis/Administrator in uw Software.

U kunt een nieuwe API‑sleutel genereren via het ‘webportaal’.

Ga hiervoor via uw naam (rechtsboven in de cloud) naar ‘Configuraties’.

Open vervolgens het scherm ‘Beveiliging & toegang’, waar u een nieuwe API‑sleutel kunt aanmaken.

Volg deze stappen:

Na het aanmaken kunt u de API‑sleutel kopiëren naar het klembord.

Ga daarna terug naar de knop ‘Cloud’ in het startscherm van CareConnect Pharmacist.

Daar kunt u de nieuwe API‑sleutel toevoegen door op ‘Plakken’ te klikken en vervolgens op te slaan.

Als uw API-sleutel nog niet is verlopen, is het cloudpictogram oranje met een rood uitroepteken

Of als de apotheek geen API-sleutel heeft geconfigureerd of als uw geconfigureerde API-sleutel is verlopen: het cloudpictogram heeft een rood kruisje

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 gebruiker en het wachtwoord van de titularis.

Stap 2:

Klik op het Cloud icoon op de Startpagina van CareConnect Pharmacist.
Dit icoon zal ofwel oranje zijn indien de API-Sleutel bijna gaat vervallen of een rood kruis hebben indien er geen geldige API- Sleutel meer aanwezig is.

Het Cloud configuratie venster opent.
Kijk na of het de API-Sleutel is die vernieuwd moet worden of vervallen is.

Of uw certificaat(en).
Voor certificaten kan u onze helpdesk contacteren.

Via de knop Webportaal komt u automatisch in de Cloud terecht en kan u verder via Stap 5.

Opgelet u moet ingelogd zijn in uw Software als Titularis!

​​Stap 3:

De cloud module zal openen in een nieuw venster in uw browser. Klik op Aanmelden.
​

​​Stap 4:
Meld u nu aan via Corilus Passport met behulp van uw identiteitskaart.
​

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.

Stap 5:

Klik, nadat u bent aangemeld, rechtsboven op de naam van de titularis. Kies in het menu de optie Configuratie.

Stap 6:

Klik daarna op de tegel Beveiliging en toegang om toegang te krijgen tot de API-sleutel configuratie.

Klik vervolgens rechts bovenaan op Nieuw om een nieuwe API-sleutel te genereren.

Stap 6:

Een nieuw venster opent om de details van de API-sleutel in te geven.

Er zal gevraagd worden om een omschrijving voor de API-sleutel in te geven

. We adviseren om hier een duidelijke naam aan te geven zodat u later weet in welke context deze API sleutel werd gemaakt. voor API jaartal en titularis naam

Aangezien u in de applicatie bent ingelogd als apotheker voor een specifieke apotheek, kan u de Organisatie niet wijzigen.

Verder zijn er opties beschikbaar om de toegangsrechten van de nieuwe API-sleutel te configureren. Indien u echter een API-sleutel aanmaakt om in CareConnect Pharmacist te gebruiken dient u de standaardwaarden (respectievelijk “Lezen & schrijven” en “Volledige toegang”) te behouden.

Daarnaast kan u ook de vervaldatum voor de API-sleutel selecteren. Standaard zal deze op 1 week staan en dit kan maximaal uitgebreid worden tot 12 maanden. Nadien zal de API-sleutel niet meer geldig zijn en dient u een nieuwe aan te maken.
Voor de vervaldatum zijn een aantal standaardopties beschikbaar, of u kan door middel van de optie Aangepast zelf een einddatum selecteren.

Klik vervolgens op de knop Creëren rechts onderaan 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 nu meteen de API-sleutel naar het klembord door middel van de hiervoor voorziene knop.
​De API-sleutel wordt nadien niet meer bewaard en zal dus niet meer op te roepen zijn als u het venster sluit.
Als u vergeet de API-sleutel te kopiëren alvorens u het venster sluit zal u dus een nieuwe API-sleutel moeten aanmaken.

Als de API-sleutel effectief naar het klembord werd gekopieerd, zal u hiervan ook een bevestiging krijgen:

​

We adviseren u om het scherm met de API-sleutel nog even open te laten staan in uw browser tot u succesvol de laatste stappen hebt uitgevoerd. Zo kan u de API-sleutel nog opnieuw naar het klembord kopiëren moest er in de volgende stap toch iets misgaan.

Ga nu terug naar de Cloud configuratie in CareConnect Pharmacist.

Klik op de knop Plakkenom de gekopieerde API-sleutel hier in te geven. Klik vervolgens op de knop Opslaan in dit scherm:
​

​

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 invoerenvoordat u op Certificaten uploadenklikt. Hierdoor worden de certificaten gevalideerd.

Vervolgens klikt u op Opslaan.

Dezelfde procedure is van toepassing als het certificaat van de apotheek en/of titularis is gewijzigd.