Intégration Microsoft OCS/Lync


À propos de cette intégration
IntegrationIntroduction

Il existe plusieurs moyens d’intégrer des systèmes tiers avec Product name - ev itsm.png. Cela, en fonction des besoins métiers, des contraintes d’architecture et de sécurité en vigueur ainsi que des spécificités de chaque application ou service tiers.

Cette page présente un processus d’intégration type déjà mis en œuvre dans un contexte client. 

Pour plus de détails sur cette intégration (scripts à utiliser, etc.), veuillez contacter les départements "Consulting & Professional Services" et Support d'Logo - EasyVista.png ou vos fournisseurs de services et intégrateurs habituels.
 

Synthèse de l'intégration

Cette intégration permet à un opérateur du Service Desk ou à un utilisateur qui sont en relation (chat) via Microsoft Lync, de lancer l'écran de prise d'appel Product name - ev itsm.png d'un incident (Quick Call) pour un contact présent dans la fenêtre de conversation de Lync. La prise d'appel est alors automatiquement pré-renseignée avec les informations connues du contact Lync. 

2 méthodes sont possibles et sont détaillées dans les processus d'intégration pas à pas.
 

Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Product name - ev itsm - big.png

Up arrow.png

Logo - Lync.png

  • Product name - ev itsm.png SaaS : SSO (SAML)
  • Product name - ev itsm.png On-premise : SSO et fonction d’authentification/autorisation

1ère méthode :

  • Configuration de Lync en ajoutant une commande EasyVista QuickCall dans le menu contextuel, via l’ajout d’une clé dans la base de registre (BDR) Windows du serveur Microsoft Lync
  • Puis requête HTTP vers l'écran de prise d'appel via une page web (script) de Back Office et une page web spécifique Product name - ev itsm.png (SaaS)

2ème méthode :

  • Configuration de Lync en ajoutant une commande EasyVista QuickCall dans le menu contextuel grâce à l’ajout d’une clé dans la base de registre (BDR) Windows du serveur Microsoft Lync
  • Puis requête HTTP vers l'écran de prise d'appel via une page web (script) de Back Office et un lien d’auto-connexion vers Product name - ev itsm.png (On-premise version 2016 et SaaS)

1ère méthode : Page web (script) de Back Office et Page web spécifique Product name - ev itsm.png

Product name - ev itsm.png SaaS

Product name - ev itsm.png On-premise

Check icon.png

Not check icon.png

2ème méthode : Page web (script) de Back Office et Lien d'auto-connexion

Product name - ev itsm.png SaaS

Product name - ev itsm.png On-premise (> Version 2016)

Check icon.png

Check icon.png

Version SaaS du produit tiers

Version On-premise du produit tiers

Question mark icon.png

Check icon.png

Versions supportées du produit tiers
Logo - Lync 2010.png Logo - Lync 2013.png

Processus d'intégration pas à pas

1ère méthode : Page web spécifique, en version SaaS uniquement

Description du processus :

  • L'intégration est réalisée en ajoutant une commande (point de menu) spécifique dans un menu contextuel de la fenêtre de conversation Lync, via la modification de la base de registre Windows du serveur Microsoft Lync.
  • La commande lance une requête HTTP vers une page web PHP de Back Office en passant le paramètre contactId, qui a pour valeur le paramètre URI SIP (ou SIP-ID) du contact Lync pour lequel la commande du menu contextuel a été activée.
    Le paramètre URI SIP utilisé est %contact-id%, qui a pour valeur Contacts=<sip:surname.name@domain.com>.
  • La page web (script) de Back Office transforme la valeur du paramètre initial en ne conservant que l’adresse e-mail (de type firstname.lastname@domain.com selon votre configuration) et vérifie que cette adresse contenue dans le paramètre contactId existe dans l’annuaire Active Directory via la classe ADUser.
    • Si l'adresse e-mail existe, la page est redirigée vers une page web PHP spécifique sso_samlindexlync.php ouvrant l'écran de prise d'appel dans Product name - ev itsm.png (SaaS). Le paramètre url_requestor a comme valeur l'adresse e-mail (identifiant USERID requis par Product name - ev itsm.png) du contact Lync sélectionné précédemment. L'écran est automatiquement pré-renseigné avec les informations disponibles pour ce contact Lync.
    • Si l’adresse e-mail n'existe pas, une redirection est effectuée vers la page d’authentification Product name - ev itsm.png sso_samlindex.php.
       

Via cette méthode, Lync peut être intégré avec Product name - ev itsm.png en 4 étapes simples :


Étape 1 : Vérifier la liste des prérequis

    Note

Pour Product name - ev itsm.png SaaS, EasyVista peut vous fournir et configurer sur demande (via le support) 2 pages web PHP spécifiques d’authentification en SSO vous permettant la réalisation de l’intégration Microsoft Lync :

  • Pour votre environnement de production : https://companyname.easyvista.com/sso_samlindexlync.php?do_quickcall=1&url_requestor=USERID
  • Pour votre environnement sandbox : https://companyname.easyvista.com/sso_samlindexlyncsbox.php?do_quickcall=1&url_requestor=USERID

Les autres informations décrites dans le processus d'intégration (création d’une clé de registre et code php d’une page web de Back Office) sont fournies à titre d’exemple et ne font pas partie du support Product name - ev itsm.png. En effet, d’autres moyens ou langages de développement peuvent être utilisés pour aboutir à des résultats équivalents ou différents selon les besoins métiers.

Le point important est de pouvoir passer comme valeur du paramètre url_requestor des pages php indiquées ci-dessus une adresse e-mail d’un utilisateur identifié dans votre annuaire des employés Product name - ev itsm.png (adresse e-mail de type firstname.lastname@domain.com selon votre configuration). Cette valeur sert de clé d’unicité entre vos environnements Microsoft Active Directory et Lync server et votre environnement Product name - ev itsm.png (identifiant USERID).

 

Liste des prérequis :

  • Votre annuaire Active Directory doit être correctement synchronisé avec l’annuaire des employés Product name - ev itsm.png SaaS.
  • Vous devez disposer des droits et privilèges suffisants pour ajouter une clé dans la base de registre Windows de votre serveur Microsoft Lync.
  • Le mécanisme de SSO doit être activé sur votre plateforme Product name - ev itsm.png SaaS.
  • L’opérateur du Service Desk lançant la commande du menu contextuel dans la fenêtre de conversation Lync doit avoir un profil lui permettant d’utiliser l'écran de prise d'appel Product name - ev itsm.png d'un incident (Quick Call).
     


Étape 2 : Créer une page web PHP de Back Office

Cette étape consiste à transformer l’identifiant (paramètre URI SIP) du contact Lync pour lequel la commande du menu contextuel a été activée en clé d’unicité dans votre environnement Product name - ev itsm.png (via les 2 URL spécifiques mentionnées à l'étape 1).

Example documentation icon FR.png  Vous pouvez utiliser une page web et le code PHP ci-dessous pour effectuer des tests d’intégration avec la sandbox de votre environnement Product name - ev itsm.png :
    http://sysweb/easyvista/ssolyncsbox.php?contactId=%contact-id%

$url1 = "https://companyname.easyvista.com/sso_samlindexlyncsbox.php?do_quickcall=1&url_requestor=";
$url2 = "https://companyname.easyvista.com/sso_samlindexsbox.php";

if (!empty($_GET["contactId"])) {
    $contactid = $_GET["contactId"];
    $contactid = str_replace("Contacts=<", "", $contactid);
    $contactid = str_replace(">", "", $contactid);
    $aduser = new ADUser();
    $aduser->loadFromSIP($contactid);
    if ($aduser->valid) {
        $url1.=$aduser->userid;
        header("Location: " . $url1);
        exit;
    }
}
header("Location: " . $url2);

 


Étape 3 : Ajouter une clé dans la base de registre Windows du serveur Lync

    Open url.png voir Note de publication Microsoft TechNet : Ajout de commandes aux menus de Lync 2010 (EN)
    Open url.png voir Note de publication Microsoft TechNet : Ajout de commandes aux menus de Lync 2013 (EN)
    Open url.png voir Note de publication Microsoft msdn : Ajout de commandes aux menus de Lync 2013 (EN)

1. Dans la base de registre, double-cliquez pour ajouter une nouvelle clé.
2. Saisissez la valeur de la clé et sauvegardez la base de registre.
3. Redémarrez le serveur Lync.

Example documentation icon FR.png   Ajouter une clé permettant de lancer l'écran de prise d'appel Product name - ev itsm.png via une commande nommée EasyVista QuickCall Sandbox dans le menu contextuel de la fenêtre de conversation Lync

[HKEY_LOCAL_MACHINE\SOFTWARE\YourServerConfigurationParameters\Microsoft\Communicator\SessionManager\Apps]
[HKEY_LOCAL_MACHINE\SOFTWARE\YourServerConfigurationParameters\Microsoft\Communicator\SessionManager\Apps]
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Communicator\SessionManager\Apps\{e865bf6c-a2ab-4187-aed5-c04ecd394385}]
"Name"="EasyVista QuickCall Sandbox"
"Path"="YourBackOfficeWebPageURL"
"ApplicationType"=dword:00000001
"SessionType"=dword:00000000
"ExtensibleMenuAll"="MainWindowRightClick;ConversationWindowActions;ConversationWindowRightClick;ContactCardMenu"
"ExtensibleMenu"="MainWindowRightClick;ConversationWindowRightClick;ContactCardMenu"

    Notes :

  • Vous pouvez remplacer la valeur du paramètre Name par la valeur de votre choix.
  • Vous pouvez ajouter une deuxième clé pour afficher un autre point d’entrée permettant de créer un incident dans une autre base d'Product name - ev itsm.png (ex. : base 50004).

 


Étape 4 : Utilisation de la commande dans le client Lync

1. Dans la fenêtre de conversation Lync, cliquez droit sur le nom du contact Lync pour lequel vous souhaitez créer un incident et lancez l'option de menu configurée à l’étape 3.

         Example documentation icon FR.png  Easyvista QuickCall Sandbox
         Contextual option example.png

2. L'écran de prise d'appel Product name - ev itsm.png d'un incident (Quick Call) est ouvert, avec les informations disponibles du contact Lync pré-renseignées.
         Quick Call.png

2ème méthode : Lien d'auto-connexion

Description du processus :

  • L'intégration est réalisée en ajoutant une commande (point de menu) spécifique dans un menu contextuel de la fenêtre de conversation Lync, via la modification de la base de registre Windows.
  • La commande lance une requête HTTP vers le serveur web Product name - ev itsm.png via un lien d’auto-connexion en passant le paramètre contactId, qui a pour valeur le paramètre URI SIP (ou SIP-ID) du contact Lync pour lequel la commande du menu contextuel a été activée.
    Le paramètre URI SIP utilisé est %contact-id%, qui a pour valeur Contacts=<sip:surname.name@domain.com> (adresse e-mail de type firstname.lastname@domain.com selon votre configuration).
  • L'écran de prise d'appel est ouvert et est automatiquement pré-renseigné avec les informations disponibles du contact Lync.

Note : Le lien d’auto-connexion utilise une clé d'unicité entre vos environnements Microsoft Active Directory et Lync server et votre environnement Product name - ev itsm.png (identifiant USERID). Utilisez de préférence l'adresse e-mail du contact Lync.
Pour cela, vous devez réaliser une page web (script) de Back Office (en utilisant le langage de votre choix : php, ...) pour conserver uniquement l’adresse e-mail contenue dans le paramètre URI SIP.

 

Via cette méthode, Lync peut être intégré avec Product name - ev itsm.png en 4 étapes simples :


Étape 1 : Vérifier la liste des prérequis

  • Votre annuaire Active Directory doit être correctement synchronisé avec l’annuaire des employés Product name - ev itsm.png SaaS.
  • Vous devez disposer des droits et privilèges suffisants pour ajouter une clé dans la base de registre Windows de votre serveur Microsoft Lync.
  • L’opérateur du Service Desk lançant la commande du menu contextuel dans la fenêtre de conversation Lync doit avoir un profil lui permettant d’utiliser l'écran de prise d'appel Product name - ev itsm.png d'un incident (Quick Call).
     


Étape 2 : Créer un lien d'auto-connexion dans Product name - ev itsm.png

    Open url.png Pour plus de détails, voir Lien d’auto-connexion

1. Dans Product name - ev itsm.png, allez sur l'écran Administration > Gestion des accès > Lien d'auto-connexion

2. Saisissez les informations comme indiqué ci-dessous.
         Auto Connect Link.png

3. Cliquez sur [ GÉNÉRER LE LIEN ].

4. Effectuez un copier-coller du lien contenu dans le champ URL.
 


Étape 3 : Créer une page web PHP de Back Office

Cette étape consiste à  réaliser une page web de Back Office (en utilisant le langage de votre choix : php, ...) pour conserver uniquement l’adresse e-mail contenue dans le paramètre URI SIP.

Dans l’étape suivante d’ajout d’une clé de registre Windows, ceci va permettre une redirection vers cette page afin de construire une URL du type https://companyname.easyvista.com/autoconnect_mail.php?field1=5C0F051E580F056F19&field2=&field4=%7B90D54E77-40A5-4F0F-8029-5A7A05F5814D%7D&field5=ViewDialog&field6=contactId.

  • Le paramètre contactId a pour valeur l’adresse e-mail contenue dans le paramètre URI SIP du contact Lync pour lequel la commande du menu contextuel a été activée.
     


Étape 4 : Ajouter une clé dans la base de registre Windows du serveur Lync

    Open url.png voir Note de publication Microsoft TechNet : Ajout de commandes aux menus de Lync 2010 (EN)
    Open url.png voir Note de publication Microsoft TechNet : Ajout de commandes aux menus de Lync 2013 (EN)
    Open url.png voir Note de publication Microsoft msdn : Ajout de commandes aux menus de Lync 2013 (EN)

1. Dans la base de registre, double-cliquez pour ajouter une nouvelle clé.
2. Saisissez la valeur de la clé et sauvegardez la base de registre.
3. Redémarrez le serveur Lync.

Example documentation icon FR.png   Ajouter une clé permettant de lancer l'écran de prise d'appel Product name - ev itsm.png via une commande nommée EasyVista QuickCall Sandbox dans le menu contextuel de la fenêtre de conversation Lync

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\YourServerConfigurationParameters\Microsoft\Communicator\SessionManager\Apps]
[HKEY_LOCAL_MACHINE\SOFTWARE\YourServerConfigurationParameters\Microsoft\Communicator\SessionManager\Apps]
[HKEY_LOCAL_MACHINE\SOFTWARE\YourServerConfigurationParameters\Microsoft\Communicator\SessionManager\Apps\{YourServerConfigurationParameters}]
"Name"="EasyVista QuickCall Sandbox"
"Path"="YourBackOfficeWebPageURL"

"ApplicationType"=dword:00000001
"SessionType"=dword:00000000
"ExtensibleMenuAll"="MainWindowRightClick;ConversationWindowActions;ConversationWindowRightClick;ContactCardMenu"
"ExtensibleMenu"="MainWindowRightClick;ConversationWindowRightClick;ContactCardMenu"

    Notes :

  • La valeur du paramètre Path correspond à l’URL du lien d’auto-connexion obtenu à l’étape 2, dans laquelle vous devez remplacer la valeur du champ field6 (ex. : morley) par %contact-id%, i.e. l’adresse e-mail du contact pour lequel la commande du menu contextuel a été activée.
    Remarques : La structure et les codes indiqués dans le lien d’auto-connexion seront toujours les mêmes dans votre environnement Product name - ev itsm.png. Seule la valeur du champ field6 sera différente. En revanche, les codes indiqués peuvent être différents d’un environnement Product name - ev itsm.png à un autre.
  • Vous pouvez remplacer la valeur du paramètre Name par la valeur de votre choix.
  • Vous pouvez ajouter une deuxième clé pour afficher un autre point d’entrée permettant de créer un incident dans une autre base d'Product name - ev itsm.png (ex. : base 50004).

 


Étape 5 : Utilisation de la commande dans le client Lync

1. Dans la fenêtre de conversation Lync, cliquez droit sur le nom du contact Lync pour lequel vous souhaitez créer un incident et lancez l'option de menu configurée à l’étape 3.

         Example documentation icon FR.png  Easyvista QuickCall Sandbox
         Contextual option example.png

2. L'écran de prise d'appel Product name - ev itsm.png d'un incident (Quick Call) est ouvert, avec les informations disponibles du contact Lync pré-renseignées.
         Quick Call.png

Tags:
Modifié par Utilisateur inconnu le 2017/04/24 21:29
Créé par Administrator XWiki le 2016/09/29 14:46

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020