Delen via


Verbinden met een modelgestuurde app

De Unified Service Desk-client is een agenttoepassing die u kunt gebruiken om verbinding te maken met het Microsoft Dataverse-exemplaar waar u uw Unified Service Desk-entiteiten en -configuratiegegevens hebt geïnstalleerd. Wanneer u zich aanmeldt met behulp van de clienttoepassing wordt de Unified Service Desk-configuratie in het Dataverse-exemplaar gelezen en worden de besturingselementen en de functionaliteit dienovereenkomstig in de toepassing weergegeven.

Aanmelden bij Unified Service Desk

Ga naar Aanmeldingsgegevens configureren als u de aanmeldingservaring wilt configureren, zoals het vooraf invullen van waarden in het aanmeldingsvenster of het automatisch aanmelden van gebruikers zonder het aanmeldingsvenster weer te geven.

  1. Start de Unified Service Desk-client door te dubbelklikken op de snelkoppeling voor de toepassing op uw bureaublad.

  2. Verstrek in het aanmeldingsvenster van Unified Service Desk verificatiedetails om verbinding te maken met uw Dataverse-server.

    Clientaanmeldscherm van Unified Service Desk.

    • Selecteer voor Dataverse Microsoft 365.

    • Voor on-premises implementaties van Dynamics 365 Customer Engagement (on-premises) selecteert u On-premises en selecteert u vervolgens een van de volgende Verificatiebronnen.

      • Active Directory Selecteer deze verificatiebron als u intern verbinding maakt met Customer Engagement (on-premises) via uw netwerk en geen verbinding maakt met Dataverse via internet.

      • Internet-facing Deployment (IFD). Selecteer deze verificatiebron als u verbinding maakt met Customer Engagement (on-premises) via internet.

      • OAuth. Selecteer deze verificatiebron als u verbinding maakt met Customer Engagement (on-premises) door gebruik te maken van een beveiligingstokenservice (STS), anders dan Windows Server, die het open kader OAuth ondersteunt.

    • Als u meerdere organisaties hebt en de organisatie wilt selecteren waar Unified Service Desk is geïmplementeerd, schakelt u het selectievakje Lijst met beschikbare organisaties weergeven in en selecteert u vervolgens Aanmelden.

  3. Als u meer organisaties hebt, selecteert u de organisatie waarmee u verbinding wilt maken.

  4. Het welkomstscherm van Unified Service Desk wordt weergegeven. Dit scherm toont de informatie over de configuratiegegevens die door de client op de achtergrond worden gelezen. Vervolgens wordt het hoofdvenster weergegeven en wordt u gevraagd uw Dataverse-serverreferenties in te voeren. Voer uw referenties in en meld u aan bij de Unified Service Desk-clienttoepassing.

    Wanneer u de Unified Service Desk-client start en u opnieuw moet aanmelden, hoeft u niet meer uw verbindingsgegevens in te voeren. Uw referenties worden opgeslagen in de Windows Credential Manager en andere verbindingsinformatie wordt opgeslagen in het standaard Default_USD.config-bestand op C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> en wordt gebruikt voor toekomstige aanmeldactiviteiten.

    Als u uw verbindingsgegevens wilt wijzigen om u aan te melden, selecteert u Referenties wijzigen in het introductiescherm. U ziet het eerste dialoogvenster om u aan te melden waar u andere referenties kunt invoeren.

    Scherm Referenties wijzigen van Unified Service Desk.

Eenmalige aanmelding (SSO) voor Unified Service Desk

Eenmalige aanmelding (SSO) voor Unified Service Desk biedt een betere opstartprestatie en gebruikerservaring door gebruikers te verifiëren voor toegang tot modelgestuurde apps zonder dat ze hun referenties meerdere malen hoeven in te voeren. Hierdoor hoeft hetzelfde wachtwoord niet opnieuw te worden ingevoerd, zodat aanmeldingfouten eventueel kunnen worden voorkomen, wat een naadloze ervaring ten goede komt.

In Unified Service Desk 4.1.1.1433 en later is SSO standaard uitgeschakeld.

In versies voorafgaand aan Unified Service Desk 4.1.1.1433 is SSO standaard ingeschakeld.

Als SSO is ingeschakeld en uw organisatie de time-out van de sessie bij inactiviteit heeft afgedwongen voor agenten, worden de agenten niet automatisch afgemeld wanneer de time-out van de sessie bij inactiviteit verloopt. Als u dus een time-out voor een inactiviteitssessie wilt afdwingen voor agenten in eerdere versies van het product, moet u de SSO-functie uitschakelen.

Zie Eenmalige aanmelding in- of uitschakelen als u SSO wilt in- of uitschakelen.

Notitie

  • De SSO-functie is alleen beschikbaar voor modelgestuurde apps en Unified Service Desk.

  • SSO wordt niet ondersteund voor Dynamics 365 Customer Engagement (on-premises).

SingleSignOnThreshold is een UII-optie waarmee de time-outperiode in milliseconden (ms) wordt aangegeven die Unified Service Desk moet wachten, alvorens een dialoogvenster weer te geven waarin referenties moeten worden ingevoerd voor aanmelding bij de Dataverse-server. Standaard is de waarde SingleSignOnThreshold 5.000 milliseconden. De UII-optie SingleSignOnThreshold werkt alleen als u de UII-optie SingleSignOnEnabledBrowsers configureert en een geldige waarde opgeeft. Zie voor meer informatie Opties in Unified Service Desk beheren.

Als u de time-outwaarde wilt wijzigen, configureert u de UII-optie in SingleSignOnThreshold en voert u een waarde in het bereik tussen 1.000 en 60.000 milliseconden in. Als u een waarde van minder dan 1000 ms of meer dan 60.000 ms invoert, wordt de waarde in Unified Service Desk opnieuw ingesteld op de standaardwaarde van 5000 ms.

Waarde in ms Omschrijving
5,000 Default value
1000 - 60.000 Geaccepteerd waardebereik
> 60.000 De waarde wordt opnieuw ingesteld op 5.000 milliseconden

De SingleSignOnThreshold-waarde wijzigen

  1. Aanmelden bij de Unified Service Desk Administrator-app.

  2. Selecteer Opties.

  3. Selecteer op de pagina Actieve UII-opties de optie Nieuw.

  4. Voor Naam voert u SingleSignOnThreshold in. Voer voor Waarde de tijd in milliseconden (ms) in.

  5. Selecteer Opslaan.

Nadat u de UII-opties hebt ingesteld, wordt de SSO-functie ingeschakeld. Wanneer u zich aanmeldt bij de Unified Service Desk-clienttoepassing, hoeft u de referenties maar één keer in te voeren.

SSO inschakelen of uitschakelen

Als u de SSO-functie wilt inschakelen, moet u de UII-optie SingleSignOnEnabledBrowsers configureren en instellen op Waar. Als u geen waarde invult, wordt SSO nog steeds ingeschakeld. Stel de waarde in op False om de SSO-functie uit te schakelen.

SSO inschakelen of uitschakelen

  1. Aanmelden bij de Unified Service Desk Administrator-app.

  2. Selecteer Opties.

  3. Selecteer op de pagina Actieve UII-opties de optie Nieuw.

  4. Voor Naam voert u SingleSignOnEnabledBrowsers in. Voor Waarde voert u Chrome in.

  5. Selecteer Save.

Belangrijk

Chrome en EdgeWebView2 SSO mogen niet tegelijkertijd worden ingeschakeld. Als beide browsers worden vermeld in de UII-optie SingleSignOnEnabledBrowsers, werkt SSO niet. Zorg ervoor dat slechts één van de opties wordt vermeld voor de UII-optie.

Aanmeldingsgegevens configureren

Indien nodig, kunnen beheerders de aanmeldingservaring voor Unified Service Desk configureren en de waarden in het aanmeldingsvenster vooraf laten invullen (behalve gebruikersnaam en wachtwoord), zodat gebruikers verbinding kunnen maken met het opgegeven Dataverse-exemplaar of ze kunnen instellen dat gebruikers automatisch worden aangemeld bij een on-premises exemplaar van Dataverse op basis van hun Active Directory-referenties zonder dat het aanmeldingsvenster zelfs maar wordt weergegeven.

Notitie

U kunt de velden in het aanmeldingsvenster van Unified Service Desk niet toevoegen of verwijderen. U kunt alleen de waarden in de velden opgeven die worden weergegeven wanneer een gebruiker probeert zich aan te melden. Gebruikers kunnen echter de vooraf ingevulde waarden in het aanmeldingsvenster van Unified Service Desk wijzigen voordat zij zich aanmelden.

Als u de aanmeldingsgegevens wilt configureren, gebruikt u het UnifiedServiceDesk.exe.config-bestand dat beschikbaar is in de clientinstallatiedirectory (meestal C:\Program Files\Microsoft Dynamics CRM USD\USD).

  1. Voer Kladblok uit als beheerder.

  2. In Kladblok opent u het UnifiedServiceDesk.exe.config-bestand in de clientinstallatiedirectory (meestal C:\Program Files\Microsoft Dynamics CRM USD\USD).

  3. Voeg de volgende sleutels onder het <appSettings> knooppunt in het UnifiedServiceDesk.exe.config-bestand toe.

    <add key="CrmDeploymentType" value="<DEPLOYMENT_TYPE>" />  
    <add key="CrmUseSSL" value="<VALUE>" />  
    <add key="CrmOrg" value="<ORG_NAME>" />  
    <add key="CrmPort" value="<PORT_NUMBER>" />  
    <add key="CrmServerName" value="<CRM_SERVER_NAME>" />  
    <add key="UseDefaultCreds" value="<VALUE>" />  
    <add key="CacheCredentials" value="<VALUE>" />  
    <add key="CrmOnlineRegion" value="<CRM_ONLINE_REGION>" />  
    <add key="AuthHomeRealm" value="<VALUE>" />  
    <add key="AskForOrg" value="<VALUE>" />  
    <add key="CrmDomain" value="<DOMAIN_NAME>" />  
    
  4. Verstrek een passende waarde voor elk sleutel. Elke sleutel verwijst naar een individueel veld in het aanmeldingsvenster. De volgende tabel bevat geldige sleutelwaarden.

    Key Weergegeven als
    CrmDeploymentType Prem of O365

    Prem moet worden gebruikt als u verbinding maakt met Customer Engagement (on-premises); O365 moet worden gebruikt als u verbinding maakt met Dataverse.
    CrmUseSSL True of False

    Deze sleutel is alleen van toepassing als u Prem hebt opgegeven in de sleutel CrmDeploymentType.
    CrmOrg Geef de Dataverse-organisatienaam op.
    CrmPort Geef het Dataverse-poortnummer op.

    Deze sleutel is alleen van toepassing als u Prem hebt opgegeven in de sleutel CrmDeploymentType.
    CrmServerName Geef de Dataverse-servernaam.

    Deze sleutel is alleen van toepassing als u Prem hebt opgegeven in de sleutel CrmDeploymentType.
    UseDefaultCreds True of False

    Opmerking: Voor Customer Engagement (on-premises)-installatie (<add key="CrmDeploymentType" value="Prem" />) en Active Directory-verificatie (<add key="AuthHomeRealm" value="Active Directory" />) stelt u de waarde van deze sleutel in op True om gebruikers direct aan te melden bij de opgegeven Dataverse-server of organisatie zonder zelfs maar het aanmeldingsvenster weer te geven.
    CacheCredentials True of False

    Opmerking: U kunt de weergave van het verbindingsvenster afdwingen telkens wanneer de Unified Service Desk-client wordt gestart door de waarde van deze sleutel in te stellen op False. Standaard slaat de client de meest recente verbindingsgegevens op in het cachegeheugen en gebruikt deze om de volgende keer een verbinding tot stand te brengen met de Dataverse-server (tenzij de gebruiker annuleert en een andere verbinding opgeeft).
    CrmOnlineRegion NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND of NorthAmerica2

    Als u de online regio niet weet, laat u de waarde leeg: value=""

    Deze sleutel is alleen van toepassing als u O365 hebt opgegeven in de sleutel CrmDeploymentType.
    AuthHomeRealm Active Directory of Internet-facing deployment(IFD)

    Deze sleutel is alleen van toepassing als u Prem hebt opgegeven in de sleutel CrmDeploymentType.
    AskForOrg True of False

    Geeft aan of het selectievakje Lijst met beschikbare organisaties weergeven is ingeschakeld in het aanmeldingsvenster.
    CrmDomain Geef de naam van het Windows-domein op.

    Deze sleutel is alleen van toepassing als u Prem hebt opgegeven in de sleutel CrmDeploymentType.
  5. Sla het bestand UnifiedServiceDesk.exe.config op.

  6. Doe het volgende op de computer van elke gebruiker voor wie u aanmeldingsgegevens wilt configureren:

    1. Als u het bestaande bestand wilt vervangen, kopieert u het UnifiedServiceDesk.exe.config-bestand dat u zojuist hebt gewijzigd, naar de clientinstallatiedirectory (meestal C:\Program Files\Microsoft Dynamics CRM USD\USD).

    2. Verwijder de aanmeldingsgegevens voor Unified Service Desk uit de zwervende gebruikersprofielen op de computer van de gebruiker. Als de gebruiker zich vanaf deze computer tenminste eenmaal heeft aangemeld bij Unified Service Desk, werden de volgende bestanden gemaakt in de directory C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk: Default_USD.config en Default_USD. U moet beide bestanden voor de configuratie-instellingen verwijderen in het bestand UnifiedServiceDesk.exe.config om deze van kracht te laten worden.

    Wanneer de gebruiker de toepassing Unified Service Desk op de computer start:

    • Het aanmeldingsdialoogvenster bevat de waarden die zijn opgegeven in het UnifiedServiceDesk.exe.config-bestand en maakt ook het Default_USD.config-bestand in de directory C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk om de verbindingsinformatie op te slaan (behalve gebruikersnaam en wachtwoord, deze worden opgeslagen in Windows Credential Manager). Vervolgens maakt de clienttoepassing gebruik van het bestand Default_USD.config om de aanmeldingsgegevens weer te geven of om automatisch aan te melden bij Unified Service Desk.

    • Als u bij een Customer Engagement (on-premises)-installatie met Active Directory-verificatie automatische aanmelding hebt geconfigureerd voor de gebruiker zonder weergave van het aanmeldingsvenster (<add key="UseDefaultCreds" value="True" />), wordt het aanmeldingsvenster niet weergegeven, maar wordt het bestand Default_USD.config gemaakt in de directory C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk om de verbindingsgegevens op te slaan (met uitzondering van de gebruikersnaam en het wachtwoord). Vervolgens maakt de clienttoepassing gebruik van het bestand Default_USD.config om automatisch aan te melden bij Unified Service Desk.

Als u de standaardaanmeldingsgegevens moet wijzigen, moet u stappen 1 tot en met 6 herhalen.

Notitie

Om problemen te voorkomen wanneer u zich aanmeldt bij Chrome en SSO hebt ingeschakeld, raden we u aan de UII-optie ChromeWebViewShowOutside in te stellen op TRUE. Meer informatie: Algemene instellingen of opties wijzigen in Unified Service Desk.

Aanmeldingsproblemen oplossen

Unified Service Desk biedt ondersteuning van logboekregistratie voor logboekfouten die kunnen optreden bij het aanmelden bij Dataverse. Een logboekbestand, Login_ErrorLog.log, wordt gemaakt in C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> de eerste keer dat u aanmeldingsproblemen hebt in de clienttoepassing. Daarna wordt het logboekbestand gebruikt om informatie vast te leggen over volgende aanmeldproblemen. Deze informatie \kan nuttig zijn voor het oplossen van problemen met het aanmelden bij Dataverse vanuit de clienttoepassing.

Notitie

In Unified Service Desk wordt tevens een ander logboekbestand, UnifiedServiceDesk.log, op dezelfde locatie gemaakt voor het vastleggen van operationele fouten in de clienttoepassing. Het logboekbestand wordt gemaakt de eerste keer dat er problemen in de clienttoepassing optreden. Meer informatie: Registratie in diagnoselogboek in Unified Service Desk configureren

Zie ook

Toegang beheren in Unified Service Desk
Leren werken met Unified Service Desk
Configuratieanalyses van Unified Service Desk
Overzicht beheren