Creazione app Microsoft

Estimated reading: 5 minutes 167 views

Requisiti

  • Devi poter accedere a Microsoft Azure con un account amministratore
  • Sullo stesso browser accedi anche all’interfaccia OCC del tuo TVox, sempre come amministratore, nella sezione Account esterni – Credenziali applicazione

Procedura per la creazione dell’app

Registrazione nuova APP

In Microsoft Azure, digita “Registrazione app” nella barra di ricerca in alto e seleziona l’opzione REGISTRAZIONI APP dai risultati. Successivamente, clicca su Nuova registrazione.

Compila in questo modo i primi campi richiesti:

  • Nome: dai un nome alla tua app
  • Tipi di account supportati: seleziona Account in qualsiasi directory dell’organizzazione (qualsiasi tenant di Microsoft Entra ID – Multi-tenant)
  • URI di reindirizzamento: seleziona Web nel primo campo, nel successivo inserisci l’url https://dominiodeltuotvox/system/external_accounts/microsoft
 

Infine clicca sul pulsante REGISTRA.

Credenziali applicazione

Per configurare l’app su TVox ti serviranno due dati:

  • Client ID
  • Client secret

Dal menu di navigazione dell’app che trovi a sinistra accedi alla sezione Panoramica.

Qui troverai alcune informazioni tra cui un ID applicazione (client). Questo è il Client ID che ti servirà su TVox.

Sempre dal menu di sinistra, accedi alla sezione Gestione – Certificati e segreti, poi clicca in centro pagina sul pulsante Nuovo segreto client.

Sulla parte destra diventerà disponibile una sezione dove dovrai inserire una descrizione (a piacere) e impostare la scadenza. La scadenza non può essere impostata maggiore di due anni a partire dalla data in cui stai facendo la configurazione.

Importante

Appena creato, il valore del codice segreto verrà visualizzato.

Assicurati di copiarlo in un documento separato, poiché una volta usciti da questa pagina, il valore non sarà più visibile.

Autorizzazioni API

Dopo la registrazione, ti troverai nella pagina di configurazione della tua nuova app.

Nel menu laterale di sinistra, clicca su Gestione – Autorizzazione API, quindi a centro pagina clicca su Aggiungi un’autorizzazione.

Si aprirà una finestra dal titolo Richiedi le autorizzazioni dell’API in sovrimpressione sulla metà destra del monitor. Qui dovrai selezionare prima Microsoft Graph, poi Autorizzazioni delegate.

In questa sezione potrai selezionare le api ed i servizi necessari per la tua app.

Gestione email di sistema – Account esterno/Oauth2 (SMTP)

Se stai configurando l’app per gestire l’invio di email di sistema, utilizzando il campo di ricerca devi trovare e spuntare le seguenti autorizzazioni (tra le autorizzazioni delegate) :

  • User.Read
  • offline_access
  • openid
  • IMAP.AccessAsUser.All
  • SMTP.Send

Clicca quindi sul pulsante Aggiungi autorizzazioni.

Gestione email di sistema – Applicazione esterna (API)

In questo caso, utilizzando il campo di ricerca devi trovare e spuntare le seguenti autorizzazioni (tra le autorizzazioni applicazione) :

  • Mail.Send

Clicca quindi sul pulsante Aggiungi autorizzazioni.

Importante

Dopo aver selezionato le autorizzazioni che servono alla tua app, nella schermata di riepilogo delle autorizzazioni configurate devi cliccare sul pulsante Concedi consenso amministratore per NOME TUA AZIENDA e confermare la scelta premendo poi sul pulsante SI.

Configurazione OCC

Spostati nella finestra di TVox che avevi aperto all’inizio, nella sezione Account esterni – Credenziali applicazione.

Clicca su NUOVO e compila il form che si presenta:

  • Servizio di autenticazione: Microsoft
  • Nome: dai un nome, ad esempio lo stesso dell’app creata sul portale Azure
  • Client ID: è quello che trovi nella sezione Panoramica dell’app, su Azure, come indicato al paragrafo Credenziali applicazione qui sopra.
  • Client secret: è il valore che precedentemente hai generato nella sezione Certificati e segreti, e che hai copiato su un documento a parte.
  • Tenant ID: Identificatore univoco della tua organizzazione in Azure. E’ indicato nella panoramica dellìapplicazione come Directory (tenant) ID. Questo valore è obbligatorio solo se spunti la casella Email di sistema via API
  • Canale Support: se l’app deve essere usata anche per canale Support, spunta la casella.
  • Email di sistema via API: Se selezionato, l’applicazione può essere utilizzata per abilitare l’email di sistema all’invio di notifiche tramite le API di Microsoft Graph
  • Url di callback: la trovi già compilata, è l’url che hai usato prima per registrare l’app all’inizio di questa procedura.

Clicca su CONFERMA.

Nota

I prossimi passaggi NON sono necessari se stai configurando l’app per abilitare l’invio email di sistema trami API di Microsoft Graph.

Sempre su TVox, spostati ora nella tab Account esterni.

Qui dovrai autenticare l’utente microsoft (o più di uno a seconda delle tue necessità) che userai per, ad esempio, la configurazione dell’email di sistema per invio di allarmi, messaggi di casella vocale e così via.

Clicca su NUOVO e compila il form in questo modo:

  • Servizio di autenticazione: Microsoft
  • Nome: dai un nome che identifichi l’utente
  • Credenziali applicazione: seleziona le credenziali inserite precedentemente
  • Scopo: seleziona Account di posta se hai bisogno di collegare a TVox alla casella di posta dell’utente che autenticherai a breve, altrimenti seleziona T4YOU/BLF se hai bisogno di usare l’account per monitorare la presence per utenti Posto Operatore

Clicca su CONFERMA.

Si aprirà in automatico una nuova finestra del browser che ti invita ad accedere a Microsoft.

Inserisci le credenziali dell’account microsoft che vuoi usare.

La finestra successivamente chiederà di concedere le autorizzazioni: metti la spunta su Acconsenti per conto dell’organizzazione e poi clicca su Accetto.

L’account risulterà creato ed in stato Attivo.

Condividi documento

Creazione app Microsoft

Oppure copia il link

Contenuti

Prenota la tua demo!

Compila il form

Prenota la tua demo!

Compila il form

Prenota la tua demo!​

Compila il form

Subscribe

×
Cancel