Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

Introduction

This page provides a guide to the required configuration to activate the jtel Teams Presence API in your jtel system.

The API functions are described in detail at this page.

Azure Configuration - Prerequisites

The configuration should be done by a Azure AD Tenant Administrator. The configuring user must have access to the following:

  • Active Directory Administration
  • API permission Administration

Azure Configuration - Step by Step Guide

Info
titleMicrosoft Documentation

Information on this page was extracted from Microsoft and is subject to changes from Microsoft. Please refer to the following Microsoft documentation page if you are having any issues with the described steps:

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

Create App Registration

In the Azure Active Directory of your Tenant, navigate to App registrations and create a New registration. Choose a name and select "Register".

Grant Permissions

The Presence Connector requires permissions to read the users presence status. Configure the following permissions with "Add a permission" and grant the permssions by clicking on "Grant admin consent for <Tenant Name>".

Create a Client Secret

Navigate to Certificates and Secrets and click on "New client secret" to add a new secret.

Info
titleExpiry

As this secret will expire after the configured amount of time, please make note of this because it must be changed in the jtel Teams Presence Aggregator after being renewed in the Azure AD.


Gather all Information

Please provide all information on the following table to the contact who will be configuring the jtel Teams Presence Connector in your jtel ACD:

Note: The Secret Value is required, not the Secret ID.

DataValue
Application (client) ID


Directory (tenant) ID


Secret Value




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

Sv translation
languagede
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.

Image Removed

Erstellen Sie einen Benutzer mit Berechtigungen zur Nutzung der Anwendung

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

Zusätzliche Benutzerkonfiguration

Das Standardpasswort 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

Stellen Sie sicher, dass das Passwort des Benutzers keines der folgenden Sonderzeichen enthält:

[]

<>

?

#

&

Abhängig von Ihrer Azure AD-Konfiguration und Sicherheitsrichtlinien kann das Passwort des Benutzers nach einer bestimmten Zeitspanne standardmäßig zurückgesetzt werden. Wenn Sie dies für diesen Benutzer nicht deaktivieren möchten, stellen Sie sicher, dass Sie das Datum im Auge behalten, da die Konfiguration im jtel Teams Presence Aggregator das Passwort des Benutzers enthält und entsprechend geändert werden muss.

Weisen Sie den Benutzer der Anwendung zu

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

Image Removed

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".

Image Removed

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.

Image Removed

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.

DataValueAnwendungs-ID (Client)

Schlüssel WertBenutzer E-Mail AdresseBenutzer Passwort