HTTPS op Marketplace integraties

De marketplace Integraties worden gepubliceerd als webpagina en draaien standaard op HTTP. Onderstaande artikel geeft meer info ivm de aanpassing van de integraties naar een beveiligde verbinding. Gezien de Marketplace enkel binnen eigen netwerk actief is, is opzet van HTTPS zelden nodig. 

Enkel indien u wil gebruik maken van de nieuwe "DMS-Addin" of wanneer interne policy's dit verplichten.

Om via HTTPS te werken is er een certificaat nodig. Hier heb je  verschillende opties, we geven er 2 mee, maar uw ict beheerder zal zelf kunnen bepalen welke van beide of alternatief  er genomen wordt.

• Domein certificaat: Makkelijkste optie er is enkel 1 extra DNS record nodig die de vertaling doet van hostname naar IP adres. (Ofwel via DNS server ofwel via 'hostfile' )
• Zelfgetekend (self signed) certificaat, nadeel is dat dit zowel op de database server als clients moet worden uitgerold.

Eens keuze gemaakt is voegt u het certificaat toe aan de Windows machines en gaat u nadien het certificaat aan alle poorten van de actieve Marketplace addons gaan koppelen (binden). 

Alle geïnstalleerde plugins inclusief hun poorten kan je bekijken via Admin > Home > Config > Algemeen > marketplace > Open daar de config van de Marketplace manager.

Note: Browsers zelf zullen een zelf gemaakt certificaat of domein certificaat niet automatisch vertrouwen maar je kan deze  wel gebruiken voor Outlook. 

Voor de binding heb je de certificate hash of thumbprint nodig, deze is terug te vinden binnen de  eigenschappen van uw  het certificaat. Zie ook artikel (bovenstaande link). De 'APP ID is optioneel.

Eens het certificaat gekoppeld is aan alle poorten, kan je de algemene switch maken. Dit doe je door de parameter "Https=Y" in het bestand "settings.ini" toe te voegen. Dat bestand kan j eterugvinden in de installatiemap van  Hermes, op de database server ( folder "C:\Program Files (x86)\Syneton\Hermes"). Indien dat bestand er niet staat moet je die eerst aanmaken. 

Daarna moeten Alle Hermes services herstart worden op de database server. Stop hiervoor alle services waarvan de naam start met 'Hermes servicenaam'. Start de service "Hermes Manager", die start dan op zich de andere services op. 

Vanaf dan draait de services als HTTPS. 

Na succesvol toepassen zal je de marketplace via de applicatie moeten kunnen openen en elke plugin ook apart de config moeten kunnen openen.
De Manager zou dan ook moeten aangeven dat die op https draait en niet op http zoals nu zal weergegeven worden. (zie afb) 
 
Als dat niet het geval is dan liep er iets mis met de port bindings en moet dat herbekeken worden. Je kan dan de parameter uit de settings.ini halen en alle services weer herstarten om een tijdelijke rollback door te voeren.

Indien je dit instelt voor gebruik van nieuwe DMS addon, dan kan je na succesvolle implementatie van dit gedeelte kan je via de MArketplace DMS plugin het manifest downloaden, deze zal dan ook een https url bevatten en zal de import in de O365 ook omgeving lukken. Zie ook gelinkt artikel of voorgaand indien je van daar werd doorverwezen.

Deze setup dient opgezet te worden door uw ICT beheerder gezien deze de juiste rechten heeft om dit toe te passen. Onze support medewerkers kunnen hierbij niet helpen.