Overzicht van de algemene webservice connector

De webserviceconnector integreert identiteiten via webservicebewerkingen met Microsoft Identity Manager (MIM) 2016 SP1. De connector vereist dat het webserviceprojectbestand verbinding maakt met de juiste gegevensbron. Dit project kan worden gedownload vanuit Microsoft Downloadcentrum samen met documentatie voor het gebruik van de connector met Oracle eBusiness, Oracle PeopleSoft en SAP. U kunt deze ook maken met behulp van het hulpprogramma voor webserviceconfiguratie.

Wanneer de MIM-synchronisatieservice de webserviceconnector aanroept, wordt het geconfigureerde projectbestand (WsConfig-bestand) geladen. Dit bestand helpt het bij het herkennen van het eindpunt van de gegevensbron dat moet worden gebruikt om een verbinding tot stand te brengen. Het bestand geeft ook aan welke workflow moet worden uitgevoerd om een MIM-bewerking te implementeren. Voor het uitvoeren van de geconfigureerde werkstromen maakt de webserviceconnector gebruik van de runtime-engine van .NET 4 Workflow Foundation.

Configuratie van werkstroom met het configuratiehulpprogramma voor webservices

Benodigdheden

Het implementeren van deze connector vereist mogelijk wijzigingen in de configuratie van het doelsysteem, evenals configuratiewijzigingen in MIM. Voor implementaties waarbij MIM wordt geïntegreerd met een systeem van derden in een productieomgeving, raden we klanten aan om samen te werken met hun adreslijstserverleverancier of een implementatiepartner voor hulp, richtlijnen en ondersteuning voor deze integratie.

Webservicelagen

Er worden twee hoofdlagen gebruikt om de MA-oplossing (Web Service Management Agent) te implementeren:

  • Hulpprogramma voor webserviceconfiguratie
  • Runtime-connector geïmplementeerd met Workflow .NET 4.0

Ondersteunde gegevensbronnen voor webservicedetectie

Het hulpprogramma voor webserviceconfiguratie implementeert de volgende functies:

  • SOAP Discovery: hiermee kan de beheerder het WSDL-pad invoeren dat beschikbaar wordt gesteld door de doelwebservice. Discovery zal een boomstructuur van zijn gehoste webservices produceren met hun interne eindpunten/bewerkingen, samen met de beschrijving van de metagegevens van de operaties. Er is geen limiet voor het aantal detectiebewerkingen dat kan worden uitgevoerd (stap voor stap). De gedetecteerde bewerkingen worden later gebruikt om de workflow van bewerkingen te configureren die de bewerkingen van de connector uitvoeren voor de gegevensbron (zoals Import/Export/Wachtwoord).

  • REST-detectie: hiermee kan de beheerder restful servicedetails invoeren, bijvoorbeeld service-eindpunt, resourcepad, methode en parameterdetails. Een gebruiker kan een onbeperkt aantal Restful-services toevoegen. De rest services-informatie wordt opgeslagen in discovery.xml bestand van wsconfig project. Ze worden later door de gebruiker gebruikt om de Rest Web Service-activiteit in de werkstroom te configureren.

  • Configuratie van connectorruimteschema: hiermee kan de beheerder het connectorruimteschema configureren. De schemaconfiguratie bevat een lijst met objecttypen en kenmerken voor een specifieke implementatie. De beheerder kan de objecttypen opgeven die worden ondersteund door de webservice-MA. De beheerder kan hier ook de kenmerken kiezen die deel uitmaken van het connectorruimteschema.

  • Configuratie van de bewerkingsstroom: de gebruikersinterface van de werkstroomontwerper voor het configureren van de implementatie van FIM-bewerkingen (Import/Export/Password) per objecttype via functies voor beschikbaar gemaakte webservicebewerkingen, zoals:

    • Toewijzing van parameters van connectorruimte aan webservicefuncties.
    • Toewijzing van parameters van webservicefuncties aan de connectorruimte.

Resources die worden gegenereerd door het hulpprogramma voor webserviceconfiguratie

Het hulpprogramma voor webserviceconfiguratie genereert de benodigde resources voor het configureren van een volledig functionele webservice-MA, waaronder:

  • Connector Space Schema: een binair bestand dat de schemaconfiguratie bevat. Het bestand wordt door MIM geïmporteerd via de Get Schema-interface wanneer de MA is geconfigureerd met behulp van de FIM-synchronisatiegebruikersinterface. Vervolgens wordt het omgezet naar een ECMA2 Schema-object in indeling.

  • Werkstromen: Een reeks werkstroomdefinities. Ze worden tijdens runtime door de webservice-MA gebruikt om een geschikte bewerking uit te voeren.

  • WCF-configuratiebestand: een configuratiebestand dat wordt geproduceerd door de detectiebewerking. Het bestand bevat de bindings- en eindpuntgegevens die nodig zijn om een webservicebewerking aan te roepen voor de gegevensbron.

  • Assembly van gegevenscontract: Aangezien de webserviceconnector nu zowel SOAP- als REST-services ondersteunt, zullen de gegenereerde gegevenscontracten in het generated.dll-bestand verschillen.

  • SOAP-assembly: Tijdens het parseren van de WSDL-invoer genereert het configuratieprogramma voor webservices gegevenscontracttypen. Dit zijn gegevensstructuren die door de webservicebewerkingen worden gebruikt om te communiceren met de externe service. Deze contracttypen worden ook gebruikt om externe gegevensbronentiteiten beschikbaar te maken voor kenmerktoewijzing van objecttypen.

  • REST-assembly: Tijdens het parseren van een voorbeeldaanvraagantwoord voor REST Web Service genereert het configuratieprogramma typen (klassen), die in de werkstroom worden gebruikt om te communiceren met webservice via activiteit Webserviceoproep. Elke aanvraag/reactie wordt gedefinieerd in een eigen naamruimte. De naamruimte heeft een syntaxis als <ServiceName>.<ResourceName->.<MethodName>. [Aanvraag/antwoord]. Als u elke aanvraag/reactie verpakt in een afzonderlijke naamruimte, kunt u problemen verminderen vanwege een dubbele type(klasse)naam.

het maken van een werkstroom voor een .wsconfig-bestand door het configuratieprogramma voor webservices voor gebruik door de beheeragent voor webservices

Projectbestandstype

De webservice-MA wordt opgeslagen in gecomprimeerd bestand (ZIP-indeling) met de naam die is opgegeven door de gebruiker en de bestandsextensie WsConfig. De bestandsextensie 'WsConfig' is geregistreerd en is gekoppeld aan het configuratieprogramma van de webservice door het installatieprogramma. Bestaande MA-projecten kunnen worden geopend, gewijzigd en opgeslagen. Ze kunnen worden opgeslagen in de map FIM Synchronization Service-extensies of op een andere locatie. Wijzigingen met betrekking tot objecttype en kenmerken vereisen synchronisatie aan de FIM-zijde. Het configuratiehulpprogramma is een multi-instantietoepassing die is ontworpen om MA('s) te maken en te wijzigen.

Ondersteunde beveiligingsmodi

De REST/SOAP-webservicetoepassing kan worden beveiligd via een webserver zoals IIS. Met de toepassing kan de gebruiker de beveiligingsmodus selecteren, zoals wordt weergegeven in de volgende afbeelding. De beveiligingsmodi omvatten Basic, Digest, Certificate, Windows of Geen.

beveiligingsmodi

Ondersteunde gegevenstypen

De volgende gegevenstypen worden ondersteund:

  • SOAP (verouderd): Het SOAP-gegevenstype wordt ondersteund zoals beschreven in dit MSDN-artikel. Er wordt alleen ondersteuning geboden voor de BAPI-stack (Business Application Programming Interface). Voorbeelden van SOAP-sjablonen zijn beschikbaar in het Microsoft Downloadcentrum.
  • REST (niet ODATA): een op HTTP-protocol gebaseerde connector/web.

Volgende stappen

  • Last updated on