Versions Compared

Old Version 27

changes.mady.by.user jtel Support

Saved on

compared with

New Version 28

changes.mady.by.user jtel Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languagede

Einführung

Auf dieser Seite finden Sie eine Anleitung für die erforderliche Konfiguration zur Aktivierung der jtel Teams Presence API in Ihrem jtel System.

Die API-Funktionen sind hier im Detail beschrieben.

Azure Konfiguration - Voraussetzungen

Die Konfiguration sollte von einem Azure AD Mandant-Administrator durchgeführt werden. Der konfigurierende Benutzer muss Zugriff auf Folgendes haben:

  • Active Directory-Verwaltung
  • Benutzer-Administration
  • Rollenadministration
  • API-Berechtigung Verwaltung

Azure Konfiguration - Schritt für Schritt Anleitung

Info
titleMicrosoft Dokumentation

Die Informationen auf dieser Seite wurden von Microsoft entnommen und können von Microsoft geändert werden. Bitte lesen Sie die folgende Microsoft-Dokumentationsseite, wenn Sie Probleme mit den beschriebenen Schritten haben:

https://learn.microsoft.com/en-us/graph/auth-register-app-v2 

App-Registrierung erstellen

Navigieren Sie im Azure Active Directory Ihres Tenants zu App-Registrierungen und erstellen Sie eine neue Registrierung. Nach Angabe eines Namen auf "Registrieren" klicken.

Erstellen Sie einen Benutzer mit Berechtigungen zur Nutzung der Anwendung

Navigieren Sie zu Azure Active Directory → Benutzer und erstellen Sie einen neuen Benutzer.

Weisen Sie dem neuen Benutzer die Rolle "Cloudanwendungsadministrator" zu.

Zusätzliche Benutzerkonfiguration

Das Passwort des Benutzers muss bei der ersten Anmeldung geändert werden. Loggen Sie sich z. B. mit einem anderen Browser in das Konto ein, um die Erstanmeldung abzuschließen und ein neues Passwort festzulegen.

Info
titleAutomatic Passwort Reset

Abhängig von Ihrer Azure AD-Konfiguration und Sicherheitsrichtlinien wird das Passwort des Benutzers nach einer bestimmten Zeit eventuell standardmäßig zurückgesetzt. Wenn Sie dies für diesen Benutzer nicht deaktivieren möchten muss sichergestellt werden, dass bei Ändern des Passworts dieses ebenso in jtel konfiguriert wird, da der jtel Teams Presence Aggregator das Passwort des Benutzers enthält.

Weisen Sie den Benutzer der Anwendung zu

Navigieren Sie zur registrierten App-Konfiguration und fügen Sie auf der Registerkarte "Besitzer" den Benutzer hinzu.

Berechtigungen erteilen

Der Presence Connector benötigt Berechtigungen, um den Präsenzstatus der Benutzer zu lesen. Konfigurieren Sie im Reiter "API-Berechtigungen" die folgenden Berechtigungen mit "Berechtigung hinzufügen" und gewähren Sie die Berechtigungen durch Klicken auf "Admin-Zustimmung für <Mandantenname> gewähren".

Ein Kundengeheimnis erstellen

Navigieren Sie zu Zertifikate & Geheimnisse und klicken Sie auf "Neuer geheimer Clientschlüssel", um ein neues Geheimnis hinzuzufügen.

Info
titleExpiry

Das Geheimnis läuft nach der Spezifizierten Zeit ab und muss nach Erneuern ebenfalls in jtel konfiguriert werden, da es im jtel Teams Presence Aggregator hinterlegt ist.


Information Zusammentragen

Bitte geben Sie alle Informationen in der folgenden Tabelle an die Kontaktperson weiter, die den jtel Teams Presence Connector in Ihrer jtel ACD konfigurieren wird:

Hinweis: Der Wert des geheimen Clientschlüssel ist erforderlich, nicht die geheime ID.

DataValue
Anwendungs-ID (Client)



Schlüssel Wert
Benutzer E-Mail Adresse
Benutzer Passwort


Configuration d'Azure

Créer un token d'accès pour l'application

Créez l'application et enregistrez-la comme décrit ici:

https://docs.microsoft.com/en-us/graph/auth-register-app-v2

Image Removed

Accorder des autorisations

Le Connecteur de Présence aura besoin d'au moins cela. Cliquez également sur Accorder le consentement de l'administrateur pour Jtel GmbH.

Image Removed

Créer un secret client

Image Removed

Rassembler toutes les informations

Vous aurez besoin :

  • L'Application (client) ID
  • le répertoire (tenant) ID
  • Le secret du client
  • Scope: https://graph.microsoft.com/.default
  • Utilisateur : adresse e-mail (Nous n'avons pas besoin d'une licence)
  • Mot de passe: xxxxxxxxxxxx.

L'utilisateur et le mot de passe sont l'email et le mot de passe de l'administrateur de Teams.

Collections du Postman

Pour voir ce qui se passe, importez les collections postman comme décrit ici:

https://github.com/microsoftgraph/microsoftgraph-postman-collections

Demo:

Application: Get App Only Access Token

Image Removed

Application: Get Users

Image Removed

On Behalf of a User: Get User Access Token

Image Removed

Get Presence status of a specific user

Cette requête n'existe pas dans la collection Postman, vous devez créer une nouvelle requête GET comme ci-dessous :

URL: https://graph.microsoft.com/beta/users/{{users_id}}/presence

Authorization: Bearer token en utilisant la variable: {{UserAccessToken}}.

Image Removed

Pour plus de détails sur la préséance de MS Graph Get pour les utilisateurs multiples, voir

https://docs.microsoft.com/en-us/graph/api/cloudcommunications-getpresencesbyuserid?view=graph-rest-1.0&tabs=http

Sv translation
languagefr