API’s en connectors: overzicht van API 2.0, app-registraties en connectorwijzigingen
Mavim introduceert API 2.0 om moderne integraties en connectors te ondersteunen, zoals de Power Platform connector en de SharePoint connector. Op dit moment blijft API 1.0 nog beschikbaar in productie. Hierdoor kunnen klanten geleidelijk overstappen. Zowel bestaande als nieuwe app-registraties kunnen naast elkaar bestaan, zodat organisaties zonder verstoring kunnen migreren.
Dit artikel beschrijft:
-
De nieuwe app-registraties voor API 2.0
-
Wijzigingen in de SharePoint connector
-
Updates voor de Power Platform connector
App-registraties voor API 2.0
De nieuwe release introduceert vier app-registraties die nodig zijn voor API 2.0 en de bijbehorende connectors.
1. Mavim Cloud – Identity Core Access
De Mavim Cloud – Identity Core Access app registratie is verplicht voor alle klanten.
Deze fungeert als de centrale authenticatiecomponent voor toegang tot:
-
Mavim
-
Mavim-integraties
-
API 2.0-services
Je kunt dit zien als de hoofdcontroller voor authenticatie.
2. Mavim Cloud – Identity Web Application Access
De Mavim Cloud – Identity Web Application Access app-registratie ondersteunt verbeterde toegang tot iMprove
3. Mavim Cloud – Identity Power Platform Access
De Mavim Cloud – Identity Power Platform Access app-registratie is nodig voor klanten die de Power Platform connector 2.0 gebruiken.
Deze moet worden geïnstalleerd samen met de Mavim Cloud – Identity Core Access.
4. Mavim Cloud – Identity API Access
De Mavim Cloud – Identity API Access app-registratie is bedoeld voor ontwikkelaars die eigen applicaties bouwen met de Mavim API’s. Ook hiervoor is de Mavim Cloud – Identity Core Access app-registratie vereist.
Overzicht app-registraties
| Use case | Vereiste app-registraties |
|---|---|
| Vereiste voor toegang tot Mavim-producten (met uitzondering van Portal en Manager) | Mavim Cloud – Identity Core Acces |
| Alle "klantgerichte webgebaseerde" "frontend-producten" (met uitzondering van Portal en Manager) | Mavim Cloud – Identity Web Application Access |
| Power Platform connector 2.0 | Mavim Cloud – Identity Core Acces + Mavim Cloud – Identity Power Platform Access |
| Custom API ontwikkeling | Mavim Cloud – Identity Core Acces + Mavim Cloud – Identity API Access |
SharePoint connector 2.0
Mavim ontwikkelt SharePoint connector 2.0 omdat Microsoft Azure ACS-authenticatie uitfaseert.
Zie ook:
Azure ACS retirement in Microsoft 365 (Microsoft Learn)
Huidige SharePoint integratie
De huidige integratie bestaat uit twee onderdelen:
-
Mavim Portal publiceert een term set naar SharePoint
-
Mavim Portal haalt bestanden op uit SharePoint
Wijzigingen in de nieuwe implementatie
De nieuwe connector introduceert de volgende veranderingen:
-
Het publiceren van de term set naar SharePoint is niet langer nodig
-
Mavim Portal maakt verbinding met SharePoint via certificaat-authenticatie
(Dit is dezelfde methode die al in de huidige hotfix wordt gebruikt). -
De dataverbinding van SharePoint naar Mavim wordt verzorgd door een nieuwe SharePoint webpart
-
Deze webpart maakt verbinding via Mavim APIs 2.0
-
Klanten moeten de nieuwe app-registraties 'Mavim Cloud – Identity Core Acces' + 'Mavim Cloud – Identity API Access' installeren om deze oplossing te gebruiken
Als klanten geen nieuwe app-registraties kunnen installeren
Klanten kunnen hun bestaande SharePoint-configuratie blijven gebruiken door:
-
Certificaat-authenticatie te gebruiken (de hotfix oplossing)
-
De term set te blijven publiceren zoals nu
Als Microsoft in de toekomst ook certificaat-authenticatie zou beëindigen, dan moeten klanten overstappen op de nieuwe connector en app-registraties.
Power Platform connector 2.0
Belangrijke kenmerken
-
Werkt alleen met Mavim APIs 2.0
-
Om de nieuwe connector te gebruiken moeten klanten 'Mavim Cloud – Identity Core Acces' + 'Mavim Cloud – Identity Power Platform Access' installeren.
-
Wordt beschikbaar via de Power Platform marketplace
-
Bevat een licentiecontrole
Vereiste app-registraties
Bestaande Power Platform connector (v1.0)
De huidige Power Platform connector 1.0 blijft werken met de oude app-registraties.
Hierdoor kunnen:
-
Oude en nieuwe app-registraties naast elkaar bestaan
-
Klanten stapsgewijs migreren
Overstappen naar Power Platform connector 2.0
Om de nieuwe connector te gebruiken:
-
Installeer de nieuwe app-registraties
-
Gebruik Power Platform connector 2.0
-
Bouw bestaande flows en apps opnieuw met de nieuwe connector
Toegang tot Mavim en MCC
Toegang tot Mavim via MCC wordt alleen beïnvloed wanneer klanten API 2.0-componenten gebruiken, zoals:
-
Power Platform connector 2.0
-
SharePoint connector 2.0
-
Native API applicaties
In dat geval moeten klanten installeren:
-
Mavim Cloud – Identity Core Acces app registration
-
De bijbehorende app-registratie voor de connector of component
Als klanten geen API 2.0-componenten gebruiken, blijft MCC werken met de bestaande app-registratie.
Volgende stappen
Om je voor te bereiden op de overgang:
-
Controleer of je organisatie gebruikmaakt van:
-
SharePoint connector
-
Power Platform connector
-
Custom API-integraties
-
-
Plan de installatie van de nieuwe app-registraties
-
Bepaal of je wilt migreren naar:
-
SharePoint connector 2.0
-
Power Platform connector 2.0
-