ABB: API Management

Dienstbeschrijving

Een aanvraag voor dienstverlening dient via het SSP (Self Service Portaal) Topdesk gedaan te worden. Vanuit het Integratie platform beheer ontvangt u desgewenst begeleiding en support op de geboden dienstverlening.

1.1.      Dienst Toegang

De dienstverlening voor platformtoegang omvat het veilig configureren, implementeren en beheren van toegangsrechten tot de RIVA-bouwstenen van het Integratie platform. Er is een strikte scheiding tussen toegang voor de OTA en de P-omgeving.

1.2.      Dienst P-omgeving

Onze technische dienstverlening voor de productieomgeving van een platform omvat het beheren, monitoren en optimaliseren van de operationele Integratie platform functionaliteit. 

We bieden support, ondersteunen het troubleshooten bij incidenten en voeren updates van de RIVA-bouwstenen uit om de werking en security van het platform te waarborgen.

1.3.      Dienst OTA-omgeving

Onze technische dienstverlening voor ontwikkel, test en acceptatie (OTA) omgevingen voor platforms omvat het opzetten, onderhouden en beheren van gescheiden omgevingen.

Hiermee bieden we voor onze klanten de mogelijkheid om een gestructureerde workflow voor het ontwikkelen, wijzigen, testen en valideren van Apps op te zetten.

Op deze wijze kan de stabiliteit, betrouwbaarheid en de prestaties van de ontwikkelde of gewijzigde Apps gegarandeerd worden voordat deze naar de productie-omgeving worden uitgerold.

1.4.      Dienst Valideren

Onze technische dienstverlening voor ontwikkel, test, acceptatie en productie (OTAP) omgevingen voor platforms omvat verschillende testen en quality gates voor verzekering dat elke component naar behoren functioneert.

Hiermee bieden we voor onze klanten de kwaliteitsgarantie dat applicaties getest worden op functionaliteit, belasting, compliance, beveiliging en gebruikersacceptatie. Per deployment stap naar de volgende (O-T-A-P-) omgeving moet de applicatie aan specifieke kwaliteitsvoorwaarden voldoen, voor deze naar de volgende omgeving toe mag.

De quality gates worden in deze gebruikt door IVP teams voor het uitvoeren van vastgestelde smoke- en regressie-testen en Productie testen gebeuren daarnaast tevens met een deployment checklist. Allen vastgelegd op Azure. Vanuit de gebruiker worden Gebruiker Acceptatie Tests (GAT) gevraagd en verwacht kort na, maar niet later dan 2 werkdagen na deployment op zowel de Acceptatie als Productie omgevingen. Resultaat wordt vastgelegd middels een bevestiging per mail van de gebruiker naar aanvrager.

Naast test activiteiten verwachten wij voor goede GAT testen tevens dat de gebruiker beschikt over een Acceptatie / Test omgeving die gelijk is aan de Productie omgeving qua inrichting zodat de ESB getest kan worden in een end-2-end situatie. Bij niet aanwezig zijn van zo’n omgeving kan werking van de Productie oplossing bij wijzigingen niet gecontroleerd en gegarandeerd worden.

1.5.      Dienst Support

Onze dienstverlening support op het Integratie platform omvat het bieden van ondersteuning en probleemoplossing aan gebruikers. We behandelen vragen, incidenten en verzoeken om assistentie, bieden begeleiding bij het gebruik van het platform en streven naar een hoge klanttevredenheid door duidelijke communicatie en oplossingsgericht handelen.

Hieronder volgt een opsomming van de support onderwerpen die we leveren:

1. Klantondersteuning op aanvraag voor nieuwe klanten in de vorm van uitleg en toelichting over de RIVA-bouwstenen en aansluitvoorwaarden.
2. Klantondersteuning op aanvraag voor bestaande klanten in de vorm van uitleg en toelichting over de (toekomstige) veranderingen in het Integratie platform. Denk hierbij aan bijv. roadmapsessies.
3. Klantondersteuning in de vorm van documentatie over het Integratie platform.
4. Klantondersteuning op aanvraag m.b.t. informatie- en wijzigingsverzoeken (Topdesk RfI en RfC).
5. Klantondersteuning op aanvraag bij het verhelpen van incidenten en uitvoeren van (gepland)onderhoud.
6. Het bieden van de gelegenheid om gezamenlijk met CIV IVP en de platform gebruikers de inzet van IP technologie binnen Rijkswaterstaat te bevorderen.

Kostenmodel
Voor het gebruik van deze dienst worden geen kosten gerekend.

Functionele Specificaties

De Control Plane is het centrale beheersysteem. Het biedt functionaliteit voor het ontwerpen, publiceren, beveiligen, monitoren en beheren van APIs, ongeacht waar ze draaien (cloud, on-premises, hybride).

API Lifecycle Management

• API Manager:

  • Beheer van API proxies en policies (OAuth, JWT, rate limiting, IP whitelisting)
  • Versiebeheer en lifecycle tracking van API assets
  • SLA-beheer en traffic control via rate limiting
  • Groepering van APIs in API Groups

• Access Management:

  • Rolgebaseerde toegang tot API assets
  • Ondersteuning voor SSO, MFA en externe identity providers

Monitoring & Observability

• Monitoring:

  • Real-time metrics van API flows en API endpoints
  • Dashboards en alerts voor performance, errors en resourcegebruik
  • Log aggregatie en trace functionaliteit
  • Custom dashboards voor KPI’s en SLA’s

• API Functional Monitoring:

  • Black-box en white-box tests op API gedrag
  • BDD-gebaseerde testcases via BAT CLI of UI
  • Schedules en locaties voor testuitvoering
  • Rapportage en notificaties via externe tools

Deployment & Governance

• Runtime Manager (via Control Plane):

  • Starten, stoppen, herstarten van applicaties op on-premises servers
  • Beheer van clusters, servers en applicatieversies
  • Alerts en loginzage voor on-premises runtimes
  • CI/CD integratie via Maven plugin en CLI

• Policy Governance:

  • Toepassen van policies op APIs, ongeacht locatie
  • API Gateway ondersteuning voor decentrale API gateways

Roadmaps

https://samenwerken.sp01.intranet.rws.nl/sites/vpr0000641/SitePages/Roadmap-Integratie.aspx 

Landingslocaties

De landingslocatie van de Mulesoft Control Plane bevindt zich in de SaaS oplossing van Mulesoft (onderdeel van Salesforce). Binnen Mulesoft is een afgesloten Rijkswaterstaat tenant aanwezig. De SaaS oplossing van Mulesoft bevindt zich in het Amazon Web Services datacenter te Frankfurt, Duitsland.

Beschikbare SBBs 

Mulesoft Anypoint Platform

Koppelvlakken

Interfaces en afhankelijkheden tussen verschillende architectuurelementen. Dit zijn bijvoorbeeld de protocollen die kunnen worden gebruikt door andere bouwblokken die gebruik maken van het ABB.

Afhankelijkheden

ABB: API Register  > is afhankelijk van > Unsupported Confluence link

ABB: API Runtime environment > is afhankelijk van > Unsupported Confluence link

EIRA Koppeling

Dit bouwblok is gekoppeld binnen de EIRA aan: API Manager, Management Console, PaaS, Analytics

Een overzicht van alle relevante EIRA bouwblokken staan hier: EIRA Technology & Physical