Presenza bidirezionale

Condizioni

Dipendenze

Per configurare l'integrazione della presenza in Microsoft Teams, è necessario un accesso di livello amministrativo per quanto segue:

1. Microsoft Azure Active Directory (AD) con accesso amministrativo a Microsoft Office 365 Global

2. Accesso amministrativo ai clienti o ai partner dell'account CloudLink del cliente

Integrazione di Microsoft Teams in un account cliente (nuovo cliente)

L'integrazione di Microsoft Teams in un account cliente prevede due procedure separate:

Configurazione dei requisiti di funzionalità in Azure per i nuovi clienti

L'impostazione della configurazione di Azure per un nuovo cliente comporta diversi passaggi, tra cui la registrazione di una nuova applicazione Azure, la configurazione dei segreti, la definizione degli URI di reindirizzamento, la specificazione delle autorizzazioni API e la creazione di nuovi utenti per i monitor di presenza. I passaggi di configurazione di un nuovo cliente sono descritti di seguito.

Registrazione dell'app nel portale Azure

La registrazione dell'applicazione Azure viene effettuata per stabilire la sincronizzazione della presenza da CloudLink a Microsoft Teams.

1. Nel Portale Azure, fare clic su Registrazioni app.

   

2. Nella pagina Registrazioni app, fare clic su + Nuova registrazione.

3. Nella pagina Registrare un'applicazione, inserire il nome desiderato e mantenere l'impostazione predefinita per Tipo di account supportato.

4. In URI di reindirizzamento (facoltativo), selezionare come piattaforma Web e creare un URI di reindirizzamento Web basato sulla regione in cui è stato creato inizialmente l'account, come indicato di seguito. Per ulteriori informazioni fare riferimento a Reindirizzamento URI.

   • Cloud USA https://workflow.us.api.mitel.io/2017-09-01/integrations/office365outlook/sso

   • Cloud UE https://workflow.eu.api.mitel.io/2017-09-01/integrations/office365outlook/sso

   • Could AP https://workflow.ap.api.mitel.io/2017-09-01/integrations/office365outlook/sso

   Nota: Se non si è sicuri della posizione Cloud del proprio account, fare riferimento a Informazioni sull'account dell'amministratore clienti.

5. Fare clic su Registra

   

6. L'applicazione viene creata con i seguenti dettagli:

   • ID applicazione (client)

   • ID directory (tenant)

     

Configurazione delle autorizzazioni API

1. Una volta completata la registrazione dell'app, passare alle Autorizzazioni API nel pannello di navigazione a sinistra e fare clic su +Aggiungi un’autorizzazione. Viene visualizzata la pagina Richiesta autorizzazioni API.

   1. Dal pannello a destra, selezionare la scheda API Microsoft e fare clic su Microsoft Graph. Selezionare Autorizzazioni applicazione.

      L'applicazione richiede le seguenti autorizzazioni per il funzionamento della sincronizzazione bidirezionale:

      Autorizzazioni Microsoft Graph	Tipo	Descrizione
      Presence.ReadWriteAll	Applicazione	È necessaria per sincronizzare le informazioni di presenza da Mitel a MS Teams
      User.Read.All	Applicazione	È necessaria per recuperare l'ID utente da MS Teams.
      Application.ReadAll	Applicazione	Questa autorizzazione è necessaria per accedere e recuperare le autorizzazioni e il segreto del client associati all'integrazione.
      email	Delegate	È necessaria per visualizzare l'indirizzo e-mail dell'utente.
      offline_access	Delegate	È necessaria per mantenere l'accesso ai dati a cui si ha accesso.
      openid	Delegate	È necessaria per l'accesso degli utenti.
      User.Read	Delegate	È necessaria per ottenere lo stato di autorizzazione di un monitor di presenza
      User.Read.All	Delegate	È necessaria per gli utenti con monitor di presenza per leggere gli ID degli utenti di MS Teams e creare sottoscrizioni di presenza
      Subscription.ReadAll	Delegate	Consente all'applicazione di leggere tutte le sottoscrizioni webhook per conto dell'utente che ha effettuato l'accesso.
      Presence.Read	Delegate	Consente all'applicazione di leggere le informazioni sulla presenza per conto dell'utente che ha effettuato l'accesso
      Presence.ReadWrite	Delegate	Consente all'applicazione di leggere le informazioni sulla presenza e di scrivere attività e disponibilità per conto dell'utente che ha effettuato l'accesso. Le informazioni sulla presenza includono attività, disponibilità, nota di stato, messaggio di calendario fuori ufficio, fuso orario e posizione.
      Presence.Read.All	Delegate	È necessaria affinché un monitor di presenza possa leggere lo stato di presenza di tutti i 650 utenti.
      profilo	Delegate	È necessaria per visualizzare il profilo di base dell'utente.

2. Fare clic su Aggiungi autorizzazioni. Per maggiori dettagli sulle autorizzazioni Applicazione e Delegate, consultare la Documentazione Microsoft.

Consenso dell'amministratore globale per le autorizzazioni API

1. Andare su Autorizzazioni API nel pannello di navigazione a sinistra.

2. Fare clic su Concedi consenso amministratore per test Azure AD e su Sì nella notifica Conferma concessione consenso amministratore.

Segreto Client

Il segreto client è una tecnica di autenticazione che utilizza un valore stringa nell'applicazione Azure. In sostanza, serve come password dell'applicazione, utilizzata per autenticare i token per l'accesso alle applicazioni Azure. Dopo aver verificato con successo il segreto client, Azure AD emette un token, concedendo l'accesso alla risorsa specificata.

Creazione dei segreti client

1. Passare a Certificato & segreti nel pannello di navigazione a sinistra e fare clic sulla scheda Segreti client.

2. Fare clic su + Nuovo segreto client.

   Viene visualizzata la finestra di dialogo Aggiungi un segreto client.

   Nota: Il campo Descrizione del segreto client viene usato per il Nome dell'integrazione su CloudLink. Questo campo aiuta l'applicazione a determinare se il segreto client sta per scadere o è scaduto.

3. Immettere la Descrizione e selezionare il tipo di scadenza. È possibile scegliere la durata della scadenza da una data specifica a un'altra data specifica (con un periodo di scadenza massimo di 2 anni). Fare clic su Aggiungi per creare i segreti client.

   

4. Una volta generati i segreti client, copiarne la descrizione in Descrizione e salvare il segreto per la configurazione nella console dell'account.

   

Quando si creano i segreti client, è essenziale attenersi alle best practice e considerare i punti chiave per garantire la sicurezza e il corretto funzionamento dell'applicazione. Ecco alcuni punti da ricordare:

• Creare un segreto per la funzione MS Teams.

• Creare un segreto client individuale per ogni monitor di presenza. La best practice è quella di avere un segreto client sicuro separato per ogni monitor.

• Si consiglia di inserire un valore significativo nel campo Descrizione per aiutare a mantenere organizzati i segreti client.

URI di reindirizzamento

Un URI di reindirizzamento è la destinazione verso cui il server di autorizzazione indirizza l'utente dopo l'autorizzazione dell'applicazione, con conseguente rilascio di un codice di autorizzazione o di un token di accesso.

Creazione dei monitor di presenza degli utenti

Per facilitare il rilevamento delle modifiche alla presenza nelle applicazioni MS Teams, Microsoft richiede la creazione di una serie di monitor di presenza. I monitor di presenza sono necessari per monitorare le modifiche alla presenza in MS Teams. L'amministratore di Azure crea il numero necessario di monitor per la sincronizzazione della presenza, come specificato in Mitel Administration.

Per creare i monitor di presenza, seguire questi passaggi:

1. Nel Portale Azure, andare alla pagina utenti e fare clic su + Nuovo utente. Selezionare l'opzione Crea nuovo utente.

   

2. Nella pagina Crea nuovo utente , nella scheda Informazioni di base inserire i seguenti valori:

   • Nome principale dell'utente

   • Nome mostrato

   • Password: la password può essere generata automaticamente o creata manualmente.

   • Account abilitato: questa opzione deve essere abilitata, altrimenti l'accesso dell'utente sarà bloccato.

   

3. A questo punto, nella scheda Proprietà, impostare l'E-mail dell'utente.

   

4. Per creare un nuovo utente, fare clic su Rivedi e +Crea.

   Viene creato un nuovo utente monitor presenza.

   Nota:

   • Evitate di configurare gli amministratori globali come monitor di presenza. Poiché gli amministratori globali hanno accesso a tutte le risorse, il flusso di lavoro può ricevere dati non necessari che non sono essenziali per il suo funzionamento.

   • L'amministratore di Azure deve avere un elenco dei nomi principali degli utenti e dei segreti client per ogni monitor creato e inviarli all'amministratore di CloudLink. Se l'amministratore di CloudLink autorizza questi monitor, le password di ciascun monitor devono essere inviate all'amministratore di CloudLink.

Integrazione di Microsoft Teams in un account cliente (cliente esistente)

I clienti con la funzione di sincronizzazione unidirezionale della presenza abilitata possono configurare Microsoft Teams in due modi:

1. Gli amministratori possono eliminare l'applicazione Azure esistente, configurare i monitor di presenza e creare nuove applicazioni Azure con la configurazione indicata in Presenza bidirezionale .

2. Un approccio alternativo prevede che l'amministratore Azure mantenga l'attuale configurazione dell'applicazione Azure delineata nella sezione Presenza unidirezionale. In questo scenario saranno necessari ulteriori passaggi di configurazione, oltre a quelli specificati nella sezione Presenza unidirezionale:

   1. Creare i monitor di presenza. Per i passaggi, fare riferimento alla sezione Creazione dei monitor di presenza degli utenti.

   2. Aggiungere l'URI di reindirizzamento, come evidenziato nella sezione URI di reindirizzamento.

   3. Creare segreti client come delineato nella sezione Segreto Client.

   4. Aggiungere le autorizzazioni API aggiuntive per i seguenti elementi dalla sezione Configura autorizzazione API:

      • User.Read.All

      • Presence.Read.All

      • Presence.Read

Configurazione della funzione di presenza bidirezionale in Mitel Administration (come amministratore di CloudLink)

Dopo aver integrato Microsoft Teams in un account cliente, è possibile abilitare la funzione Presenza bidirezionale per tale account cliente. La sincronizzazione della funzione Presenza prevede un processo in due passaggi. Nel primo passaggio, avviene la sincronizzazione dello stato di presenza dell'utente da CloudLink a MS Teams, operazione nota anche come Presenza unidirezionale (per i dettagli, fare riferimento alla sezione su Presenza unidirezionale), seguita dalla sincronizzazione della presenza tra MS Teams e CloudLink, nota anche come Presenza bidirezionale.

Aggiornamento dell'ID tenant e/o dell'ID client di Microsoft Teams

Se è necessario aggiornare il tenant di Microsoft Teams Integration e/o l'ID del client, ciò influirà anche sui monitor di presenza creati per la funzione secondaria Sincronizzazione della presenza da MS Teams a CloudLink. Ciò è dovuto al fatto che condividono lo stesso tenant e lo stesso ID client. Se l'ID del tenant e/o l'ID del client vengono aggiornati, la funzione secondaria dei monitor smetterà di funzionare finché non verranno rinnovati.

1. Modificare l'integrazione Microsoft Teams e cambiare l'ID del tenant e/o l'ID del client. Se vi sono dei monitor esistenti, l'amministratore verrà informato di questa modifica.

   

2. Fare clic su Salva.

3. Andare su Configurazione della presenza da MS Teams a CloudLink e fare clic sul pulsante Rinnova per ogni monitor che mostra "Aggiornamento necessario".

   

4. Inserire il Nuovo segreto client. Fare clic su Autorizza ora. Verranno aggiornati i segreti dell'ID tenant e dell'ID client.

Verifica della configurazione di MS Teams

Per verificare o risolvere la configurazione dell'integrazione di MS Teams, seguire i passaggi seguenti:

1. In Mitel Administration, andare su Integrazioni & app. Nel pannello Integrazioni, fare clic su Verifica configurazione associato a Microsoft Teams.

2. Viene visualizzata la finestra "Verificare o risolvere i problemi di configurazione della presenza in MS Teams".

   

3. Fare clic su Avvia verifica.

   Quando tutti i test sono stati eseguiti correttamente	Problemi di configurazione presenti

   Per ogni errore riscontrato, c'è un'azione corrispondente per correggere l'errore (o gli errori), fare clic su Avvia verifica finché tutti i test non vengono eseguiti correttamente.

4. Configurazione utente - Configurazione utente consente all'amministratore di CloudLink di indagare sul problema.

   Caso d'uso 1: Problema con la presenza di un utente specifico:

   1. Selezionare la scheda Configurazione utente.

      

   2. Richiedere lo stato di presenza di un utente inserendo la sua e-mail. Una volta fornita l'e-mail, appare il pulsante Ottieni presenza.

      

   3. Per copiare i dati, fare clic su Copiare i dati di presenza. Segnalare il problema seguendo la procedura standard.

   4. Fare clic su Ripristina stato telefono e su Sincronizza la presenza di tutti gli MS Teams con MiCollab.

   5. Fare clic su Fine.

   Caso d'uso 2: Numero multiplo di utenti non sincronizzati.

   Quando tutti i test sono stati eseguiti correttamente dopo aver fatto clic su Avvia verifica nella scheda Configurazione del sistema, è necessario seguire i seguenti passaggi:

   1. Selezionare la scheda Configurazione utente.

      

   2. Fare clic su Sincronizza la presenza di tutti gli MS Teams con MiCollab.

      Viene visualizzato il messaggio "L'operazione Sincronizza tutto è stata completata...".

      

   3. Fare clic su Fine