> For the complete documentation index, see [llms.txt](https://docs-it.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-it.docbits.com/administration-and-setup/settings/document-processing/import/o365-tenant.md).

# O365 Tenant

## Registrare un'App su Azure AD

<mark style="color:red;">**Nota**</mark>: Le autorizzazioni potrebbero richiedere l'autorizzazione di un amministratore.

1. Accedere al [Portale Azure](https://portal.azure.com/) utilizzando le proprie credenziali.
2. Dai servizi Azure, individuare e aprire Azure Active Directory (noto anche come Azure AD).

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_1.png)

3. Nella sezione **Manage**, selezionare **App registrations**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_2.png)

4. Nella schermata App registrations, fare clic su **+ New registration**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_3.png)

5. Viene visualizzata la schermata **Register an application**. Inserire il nome visualizzato rivolto all'utente per l'App in **Name**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_4.png)

6. Selezionare uno dei seguenti tipi di account a seconda delle proprie esigenze:

* **Accounts in any organizational directory (Any Azure AD directory Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)**
* **Accounts in any organizational directory (Any Azure AD directory Multitenant)**

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_5.png)

7. Lasciare l'opzione **Redirect URI (optional)** così com'è.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_6.png)

8. Fare clic su **Register** per completare la registrazione dell'App. Questo ti riporterà alla schermata della nuova App.
9. Nella schermata dell'App, individuare l'**Application (client) ID**. Copiarlo per utilizzarlo durante la configurazione dell'importazione delle email per **DocBits**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_7.png)

10. Dal pannello di sinistra, selezionare **Certificates & secrets**:

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_8.png)

11. Nella schermata **Certificates & secrets**, fare clic sul pulsante **+ New client secret** nella sezione **Client secrets**:

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_9.png)

12. Nella finestra di dialogo **Add a client secret**, fare clic sul pulsante **Add**:

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_10.png)

Si consiglia di compilare una descrizione per identificare questo segreto tra molti (al momento il limite è di 2 segreti per App).

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_11.png)

<mark style="color:red;">**Nota**</mark>: Selezionare questa data di scadenza in base alla politica aziendale. Una volta scaduto, sarà necessario creare un nuovo client secret e specificarlo per ogni configurazione email in cui è stato utilizzato in precedenza.

13. Il client secret appena generato sarà visibile. Copiare questo client secret per utilizzarlo durante la configurazione dell'importazione delle email per DocBits.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_12.png)

**Importante:** Assicurarsi di aver copiato il client secret poiché il client secret non verrà più visualizzato una volta chiuso.

14. Selezionare **Authentication** nel pannello di sinistra. Questo mostrerà la schermata **Authentication** sul lato destro.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_13.png)

15. Nella sezione **Advanced settings**, fare clic su **Yes** per **Default client type**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_14.png)

16. Fare clic su **Save** per confermare le modifiche.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_15.png)

17. Selezionare **API permissions** nel pannello di sinistra. Questo mostrerà la schermata delle autorizzazioni API.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_16.png)

18. Per impostazione predefinita, l'autorizzazione **User.Read** da **Microsoft Graph** è presente, lasciarla così com'è.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_17.png)

<mark style="color:red;">**Nota**</mark>: Questa è un'autorizzazione obbligatoria. Se questa autorizzazione non è disponibile, aggiungere l'autorizzazione con i passaggi menzionati di seguito per l'autorizzazione **Mail.ReadWrite**.

19. Fare clic su **+ Add a permission**. Questo aprirà il pannello **Request API permissions**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_18.png)

20. Fare clic su **Microsoft Graph**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_19.png)

21. Dalle due sottocategorie, selezionare **App Permissions**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_20.png)

22. Digitare **Mail.ReadWrite** nella casella di ricerca. Selezionare la casella di controllo **Mail.ReadWrite** per l'autorizzazione.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_21.png)

23. Questo abiliterà il pulsante **Add permissions** nella parte inferiore del pannello. Fare clic su **Add permissions**.

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_22.png)

24. Questo aggiungerà l'autorizzazione **Mail.ReadWrite** all'elenco delle **Configured permissions** per l'App.

<mark style="color:red;">**Nota**</mark>: Potrebbero essere necessarie autorizzazioni di amministratore. L'amministratore dovrà autorizzare l'App per l'utilizzo di queste autorizzazioni. Una volta autorizzato, lo stato concesso sarà indicato come segue:

![](https://raw.githubusercontent.com/Fellow-Consulting-AG/docbits/refs/heads/main/readme/.gitbook/assets/o365_tenant_23.png)
