Overzicht: een Azure-ondersteunde invoegtoepassing registreren met het registratiehulpprogramma voor CRM-invoegtoepassingen

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Dit overzicht laat zien hoe u Microsoft Azure Active Directory Access Control Service (ACS) kunt configureren en een service-eindpuntstap kunt registreren met het Hulpmiddel Voor Invoegtoepassingsregistratie. Zodra het is geconfigureerd, kunnen Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online de uitvoeringscontext van de huidigebewerking op een Microsoft Azure oplossingseindpunt plaatsen. Voor dit overzicht is de stap geregistreerd om de uitvoeringscontext van het bericht CreateRequest voor een Account entiteit op de Microsoft Azure Service Bus te plaatsen.

De volgende vereisten worden voltooid voordat u dit overzicht start:

• Toegang tot het hulpmiddel Plug-in Registration. U kunt het uitvoerbare bestand van het programma in de Tools\PluginRegistration map van SDK zoeken.Download het Microsoft Dynamics CRM SDK-pakket.

• Schaf een account aan in Microsoft Dynamics CRM 2015 of Microsoft Dynamics CRM Online.

• U hebt de rol Systeemaanpasser, Systeembeheerder of een vergelijkbare rol nodig om deze stappen te kunnen uitvoeren. Zie Hoe op rollen gebaseerde beveiliging kan worden gebruikt om toegang tot entiteiten te beheren in Microsoft Dynamics CRM 2015 voor meer informatie.

• U moet toegang hebben tot een Microsoft Azure platformservicenaamruimte die ACS version 2 gebruikt, waarop Microsoft Dynamics 365 het bericht zal plaatsen.Voor meer informatie over een ACS-naamruimte maken zie Een nieuwe servicenaamruimte maken.

• Als u Microsoft Dynamics CRM 2015 gebruikt, moet de server worden geconfigureerd voor integratie met Microsoft Azure volgens de instructies in het onderwerp Azure-integratie met Microsoft Dynamics CRM 2015 configureren.

• Er moet een listenertoepassing actief luisteren naar het opgegeven oplossingeindpunt voor Microsoft Dynamics 365 om het bericht juist te plaatsen op de Microsoft Azure Service Bus. Zie Schrijf een listener voor een Microsoft Azure-oplossing voor meer informatie.

Stappen

Dit scenario bevat de volgende stappen:

1. Verbinding maken met de Microsoft Dynamics CRM-server

2. Maak een service-eindpuntconfiguratie

3. ACS configureren

4. Registreer een service-eindpuntstap voor een gebeurtenis

5. Test de eindpuntregistratie

Verbinding maken met de Microsoft Dynamics CRM-server

Volg de onderstaande stappen om verbinding met de Microsoft Dynamics 365 server te maken via het Hulpmiddel Voor Invoegtoepassingsregistratie.

1. Voer het hulpmiddel Plug-in Registration uit.

2. Kies Nieuwe verbinding maken.

3. In het dialoogvenster Aanmelden, selecteert u het keuzerondje van het installatietype dat overeenkomt met de Microsoft Dynamics 365 server waarmee u een service-eindpunt wilt registreren. Het keuzerondje On-premises bevat een IFD-implementatie, de knop Online is voor de Windows Live provider van Microsoft Dynamics CRM Online, en de knop Office 365 button is voor de Microsoft Online Services provider van Microsoft Dynamics CRM Online.

   Aanmeldingsformulier voor online implementatie

   Aanmeldingsformulier voor on-premises implementatie

4. Als u Beschikbare organisaties altijd weergeveninschakelt, krijgt u een lijst met organisaties te zien waar u lid van bent nadat u klikt of tikt op Aanmelden. Hierdoor kunt u de organisatie waarmee u een service-eindpunt wilt registreren. Anders wordt de standaardorganisatie gebruikt.

5. Voer vervolgens de weergegeven informatie over de server en aanmeldingsnaamaccount in, en klik of tik op Aanmelden.

Maak een service-eindpuntconfiguratie

Volg de onderstaande stappen uit om een Microsoft Azure service-eindpunt te registreren.

1. Selecteer het tabblad van de organisatie waarmee u een service-eindpunt wilt registreren.

2. Op de werkbalk van het tabblad, klik of tik op Registreren en vervolgens op Nieuw service-eindpunt registreren.

3. Het dialoogvenster Service-eindpuntregistratie wordt weergegeven. Dit venster bevat informatie die gerelateerd is aan de connectoroplossing, zoals weergegeven in de volgende afbeelding en beschreven in de volgende tabel. Zorg dat het contract dat u opgeeft hetzelfde contract is dat wordt gebruikt door de listenertoepassing van de oplossing.

   

   Gebruikersinterface-element	description
   Naam (veld)	Een naam voor uw service-eindpuntregistratie.
   Beschrijving (veld)	Een beschrijving van deze eindpuntregistratie.
   Oplossingsnaamruimte (veld)	De naam van de servicenaamruimte van de oplossing.
   Pad (veld)	Het pad van het project. Bijvoorbeeld, bij een service-eindpunt URL of https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo, wordt het pad TwoWayService/Demo.
   Contract (vervolgmenu)	Het eindpuntcontract. Een listenertoepassing moet dit contract gebruiken om het bericht te lezen. Zie Schrijf een listener voor een Microsoft Azure-oplossing voor meer informatie.
   Claim (vervolgmenu)	De claims om te verzenden naar Microsoft Azure. Gebruik Geen voor de standaardclaim. Geef Gebruikers-id of Gebruikersinformatie op om meer informatie over de aangemelde gebruiker te verzenden.
   Federatieve Modus (selectievakje)	Schakel dit vakje in om de federatieve modus te gebruiken.
   ID (veld)	Niet-beschrijfbaar veld waarin automatisch de id van uw eindpuntconfiguratie wordt ingevuld.
   Opslaan en ACS configureren (knop)	Hiermee slaat u de ingevoerde configuratie op en wordt de configuratie van ACS voor u geautomatiseerd. Biedt een interactieve manier om uit te voeren wat in het onderwerp Overzicht: Microsoft Azure ACS configureren voor integratie met Microsoft Dynamics CRM 2015 is beschreven.
   Opslaan en verificatie controleren (knop)	Hiermee slaat u de ingevoerde configuratie op en controleert u of ACS juist is geconfigureerd.
   Opslaan (knop)	Hiermee slaat u de ingevoerde configuratie op en sluit u het dialoogvenster.

4. Als u de integratie van ACS met Microsoft Dynamics 365 nog niet hebt geconfigureerd, en u wilt dat het hulpmiddel voor plug-inregistratie de configuratie voor u doet, klikt of tikt u op ACS opslaan en configureren en volgt u de instructies in het volgende gedeelte van dit overzicht. Als u ACS al hebt geconfigureerd, klikt of tikt u op Authenticatie opslaan en controleren of Opslaan en gaat u door met de instructies in Registreer een service-eindpuntstap voor een gebeurtenis.

ACS configureren

Volg de onderstaande stappen om Microsoft Azure Active Directory Access Control Service (ACS) te configureren.

1. Nadat u op Opslaan en ACS configureren hebt geklikt, wordt het dialoogvenster ACS-configuratie weergegeven. Voer de juiste gegevenswaarden in de formuliervelden in, zoals wordt beschreven in de volgende tabel.

   Veldnaam	Beschrijving
   Beheerderssleutel	De beheerderssleutel voor uw oplossing. U verkrijgt deze sleutelwaarde uit de Azure-beheerportal. Een beheerderssleutel voor een servicebusnaamruimte verkrijgen Meld u aan bij de Azure-portal. Selecteer in het linkervenster Servicebus en selecteer vervolgens de doelnaamruimte in de lijst. Klik of tik onder aan de pagina op de koppeling Verbindingsinformatie. In het dialoogvenster Verbindingstoeganginformatie wordt de Standaardsleutel weergegeven. Dit is de beheerderssleutel. Notitie Als u de symmetrische sleutel hebt gewijzigd, voert u die sleutel in plaats van de standaardsleutel in het veld Beheerderssleutel in. Als u dat niet doet, krijgt u wellicht fouten met een beschrijving als volgt: "ACS50012: Verificatie mislukt".
   Certificaatbestand	Het openbare certificaatbestand dat is gebruikt om Microsoft Dynamics 365 te configureren voor integratie met Microsoft Azure. U kunt voor Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update dit certificaatbestand van de server downloaden. In de webtoepassing van Microsoft Dynamics 365 klikt of tikt u op Instellingen > Aanpassingen en vervolgens op Resources voor ontwikkelaars. Download het certificaatbestand en sla het op met de koppeling onder Microsoft Azure Service Bus Verlenercertificaat.
   Naam uitgever	De naam van de uitgever. Deze naam moet dezelfde naam zijn als de naam die is gebruikt om integratie van Microsoft Dynamics 365 met Microsoft Azure te configureren. U kunt de naam van de uitgever verkrijgen van de webpagina Resources voor ontwikkelaars die is genoemd in de vorige beschrijving. Zie Azure-integratie met Microsoft Dynamics CRM 2015 configureren voor meer informatie.

   2. Kies ACS configureren. Er wordt een logboek van het configuratieproces weergegeven in het uitvoergebied van het formulier.

   3. Kies Sluiten.

   4. Klik op Opslaan en verificatie controleren in het dialoogvenster Service-eindpuntdetails. Als de verificatie is uitgevoerd, kunt u de dialoogvensters sluiten.

   Registreer een service-eindpuntstap voor een gebeurtenis

   Volg de onderstaande stappen om een stap voor een gebeurtenis te registreren voor het service-eindpunt.

   1. Selecteer het service-eindpunt dat u eerder hebt geregistreerd in de boomstructuur van het hulpprogramma.

   2. Ga naar het menu Registreren en klik of tik op Nieuwe stap registreren.

   3. Vul het dialoogvenster Nieuwe Stap registreren in voor account maak evenement zoals weergegeven in de volgende afbeelding.

      

   4. Kies Nieuwe stap registreren.

   Microsoft Dynamics 365 zal nu het huidige bericht plaatsen met de uitvoeringscontext op de servicebus als het account is gemaakt. Het bericht wordt asynchroon uitgevoerd en niet meteen uitgevoerd.

   Test de eindpuntregistratie

   Nadat u het eindpunt hebt geregistreerd, kunt u het testen. Een listener moet worden uitgevoerd of een wachtrij moet beschikbaar zijn op het doeleindpunt voor het servicebusbericht van de invoegtoepassing om plaats te vinden.

   1. Open de webtoepassing van Microsoft Dynamics 365 voor dezelfde organisatie waaronder u het service-eindpunt hebt vastgelegd.

   2. Kies de knop Maken en kies vervolgens Account.

   3. Voer een accountnaam in, bijvoorbeeld Adventure Works Cycle, in het veld Accountnaam, en klik of tik op Opslaan.

   4. Wacht ongeveer 10 minuten voordat het Microsoft Azure Service Bus bericht verschijnt.

   5. Kies Instellingen > Systeemtaken.

   6. Open de systeemtaak die dezelfde naam heeft die u voor uw service-eindpunt hebt opgegeven. Controleer de status om te zien of het bericht is geslaagd, wacht, of mislukt.

   U kunt nu de registratie van het eindpunt opheffen, indien gewenst, door het in de structuur van het programma te selecteren en op Registratie opheffen te klikken.

   Zie ook

   Azure-extensies voor Microsoft Dynamics CRM 2015
   Azure-integratie met Microsoft Dynamics CRM
   Active Directory en verificatie op basis van claims

   © 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht