Configurazione dell'API Graph (Excel, OneDrive)

Requisiti

• Un account amministratore di Office 365
• Diritti per concedere le autorizzazioni API
• Un account del servizio con accesso a OneDrive

All'interno di Azure

Registrare una domanda

1. Accedere a portal.azure.com e fare il login con un account di amministrazione.
2. Andare a Azure Active Directory
3. Vai alle registrazioni delle app
4. Fare clic su + Nuova registrazione
   1. Date un nome a questa applicazione, ad esempio: GoBright Visualizza
   2. Tipi di account supportati: Solo gli account di questa directory organizzativa (Single Tenant).
   3. Fare clic su Registrati
      

Creare un segreto del cliente

1. Aprite l'applicazione che avete appena registrato
2. Vai a Certificati e segreti
3. Vai ai segreti dei clienti
4. Fare clic su + Nuovo segreto cliente
   1. Descrizione - Fornisce una descrizione
   2. Scade - imposta una data di scadenza
   3. Segnate questa data sul calendario e ricordatevi di rinnovare il segreto prima della scadenza.
   4. Annotare il valore segreto, che viene visualizzato una sola volta. Questo valore è necessario in seguito all'interno di GoBright View. L'ID segreto non è necessario.
      Se il valore segreto è stato dimenticato, cancellare questo Client Secret e crearne uno nuovo.

Impostare le autorizzazioni API

1. Aprite l'applicazione appena creata
2. Andare alle autorizzazioni API
3. Cliente + Aggiungi un'autorizzazione
4. Selezionare Microsoft Graph
5. Scegliete Autorizzazioni delegate
6. Aggiungete queste autorizzazioni:
   1. Directory.AccessAsUser.All (delegato)
   2. Files.Read.All (delegato)
   3. Utente.Leggi (delegato)
7. Fate clic su Concedi il consenso dell'amministratore per [Dominio Azure].
8. Vai alla panoramica
   1. Annotare l'ID dell'applicazione (client)
   2. Annotare l'ID della directory (inquilino)

Creare un account di servizio

1. Andare a Azure Active Directory
2. Vai agli utenti
3. Fare clic su + Nuovo utente e poi su + Crea nuovo utente
   1. Selezionare il modello - Creare un utente
   2. Identità
      1. Nome utente - ad esempio: gobright-view@[Azure-Domain]
      2. Nome - ad esempio: GoBright Visualizza account di servizio
   3. Password
      1. Scegliere Generazione automatica della password o Lascia che sia io a creare la password.
      2. Scrivere la password
   4. Fare clic su Crea
   5. Aprire l'utente
   6. Vai alle licenze
   7. Fare clic su + Assegnazioni
      1. Selezionare Microsoft 365 Business Basic
         Questa licenza include l'accesso a OneDrive, di cui abbiamo bisogno.
      2. Fare clic su Salva

Ora dovreste disporre di queste informazioni:

1. ID applicazione (client)
2. ID della directory (inquilino)
3. Valore segreto del cliente
4. Nome utente dell'account del servizio
5. Password dell'account di servizio

Tutti questi passaggi devono essere eseguiti da un amministratore di Azure. Si prega di fornire queste credenziali a coloro che continuano a configurare il sistema. Fate riferimento alle seguenti guide per continuare:

Excel 365

Presentazione di OneDrive

Requisiti

• Un account amministratore di Office 365
• Diritti per concedere le autorizzazioni API

All'interno di Azure

Per configurare l'API Graph è necessario eseguire le seguenti operazioni:

Registrare una domanda

• https://portal.azure.com/#home
• Navigare in Azure Active Directory
• Stampa Registrazioni di app
  
• Creare una nuova registrazione
• Immettere un nome (ad esempio, GoBright View).
• Lasciare le altre impostazioni predefinite e premere il pulsante Registra in basso.

Impostare le autorizzazioni

• Aprire l'applicazione e premere il tasto Visualizza le autorizzazioni API pulsante
  
• Premete il pulsante Aggiungi un permesso e si aprirà una nuova finestra.
• Selezionare Microsoft Graph quando viene richiesta un'API
• Impostare il tipo di autorizzazione su Autorizzazioni di applicazione
• Verrà visualizzato un lungo elenco di autorizzazioni; a seconda delle applicazioni utilizzate, è necessario concedere le seguenti autorizzazioni:
  • APIConnectors.Read.All - Tipo: Applicazione - Per l'autenticazione
  • Application.Read.All - Tipo: Applicazione - Per la navigazione
  • Directory.Read.All - Tipo: Applicazione - Per la navigazione tra diverse cartelle
  • Files.Read.All - Tipo: Applicazione - Utilizzato da OneDrive
  • Reports.Read.All - Tipo: Applicazione - Utilizzato da Excel
  • Sites.Read.All - Tipo: Applicazione - Utilizzato da SharePoint

    Assicurarsi che i permessi siano concessi come permessi di "Applicazione".

• Una volta aggiunti i permessi corretti, premere il tasto Concessione del consenso all'amministrazione pulsante
  

Raccogliere tutte le informazioni e creare un segreto del cliente

Per collegarsi all'applicazione, GoBright View necessita di tre informazioni:

• ID cliente: Si trova nella pagina di panoramica
• Segreto del cliente: deve essere creato in Certificati e segreti.
• ID inquilino: Si trova nella pagina di riepilogo

Per prima cosa, copiamo l'ID cliente e l'ID inquilino dalla Panoramica dell'applicazione. Si trovano nella parte superiore della pagina:

Il prossimo passo è il valore segreto del cliente, per il quale è necessario andare in Certificati e segreti .

Il Segreto del cliente è composto da un ID e da un Valore; il Valore ci servirà.

• Creare un nuovo segreto cliente in fondo a questa pagina
• È possibile aggiungere una descrizione(ad esempio, l'utilizzo all'interno di GoBright View).
• Scegliere la data di scadenza della chiave(nota: si consiglia di impostare la data di scadenza il più lontano possibile nel tempo. Impostate anche un promemoria per il rinnovo della chiave.
• Una volta creato il segreto del client, copiare e annotare immediatamente il valore del segreto, che verrà visualizzato una sola volta. Se non avete ottenuto il valore, potete cancellare questi passaggi per crearne uno nuovo. L'ID segreto non è necessario.

Queste sono tutte le informazioni di cui abbiamo bisogno, poi possiamo usarle all'interno del widget GoBright .