Per gli amministratori
← Tutti gli argomenti

Microsoft 365: collegare le caselle

Il collegamento con l’account della casella (client dell’organizzazione), in più una registrazione per le caselle condivise – e cosa impostare in Microsoft Entra, passo passo.

Perché l’assistente possa leggere la posta in Microsoft 365 e creare lì le bozze, gli serve l’accesso tramite Microsoft Graph. Per questo l’organizzazione registra un’app nel proprio Microsoft Entra ID; draften non ha un’app comune a cui basta dare il consenso. Vale per il nostro servizio come per un’installazione sul tuo server.

Tutto ciò che segue vale solo per gli account aziendali e scolastici di Microsoft 365. Gli account personali outlook.com, hotmail.com e live.com non si possono collegare affatto – vedi Provider supportati e limiti.

Che cosa vuoi e che cosa configurare

Che cosa vuoiChe cosa configurare
I membri accedono con l’account Microsoft e ognuno ha la propria casellail client dell’organizzazione – basta questo
In più caselle condivise (info@, vendite@), o l’accesso alle caselle impostato centralmente, senza i loro proprietariin più la registrazione dell’organizzazione
Non vuoi l’accesso con l’account Microsoftle persone accedono con la password dall’invito, la posta la collega la registrazione dell’organizzazione (oppure IMAP)

Due app diverse

Il client dell’organizzazione e la registrazione dell’organizzazione sono due app separate in Entra. Ognuna fa una cosa diversa e nessuna delle due sostituisce l’altra:

Client dell’organizzazioneRegistrazione dell’organizzazione
Che cosa fal’accesso dei membri con il pulsante Accedi con Microsoft e il pulsante Collega Outlook accanto alla propria casellal’accesso dell’assistente alle caselle senza che i loro proprietari accedano
Dove in draftenOrganizzazione → Login e accesso alla posta → riquadro Accesso con account e collegamento delle caselleOrganizzazione → Login e accesso alla posta → riquadro Registrazioni per caselle condivise e gestione centrale
Chi se ne occupa in draftenil proprietario dell’organizzazioneil proprietario o un gestore dell’organizzazione
Autorizzazioni in Entradelegate (Delegated)dell’applicazione (Application)
Chi deve accedere alla casellail proprietario di ogni casella, una voltanessuno
Quali caselle raggiungesolo quelle che le persone collegano da séle caselle della directory (si può restringere)
Caselle condiviseno – non hanno un proprio accessosì
Quando una persona lascia l’aziendadopo il blocco del suo account la casella si scolleganon cambia nulla

Sono due app di proposito. Il consenso al client dà diritti solo sulle caselle che le persone collegano da sé – mai sulla posta di tutta l’organizzazione. La registrazione dell’organizzazione invece raggiunge tutte le caselle, e per questo draften la riceve solo per l’accesso alle caselle, non per l’accesso dei membri. Non unirle in una sola.

Ogni casella usa uno dei due modi. Puoi avere entrambe le app insieme: per esempio il client per l’accesso e le caselle personali, e la registrazione per la casella condivisa info@.

Non dare mai a nessuna delle due app l’autorizzazione Mail.Send. draften non invia nulla, e senza questa autorizzazione non può nemmeno farlo – ed è proprio questo lo scopo.

Client dell’organizzazione: accesso e Collega Outlook

Il client ha autorizzazioni delegate: l’app può fare solo ciò che può fare la persona che ha effettuato l’accesso, e solo nella sua casella. Lo crei una volta; poi i proprietari delle caselle si collegano da soli e l’amministratore di Entra non serve più.

In Microsoft Entra

Lavori nel Microsoft Entra admin center, https://entra.microsoft.com, con un account di amministratore della tua directory Microsoft 365.

  1. In draften apri prima Organizzazione → Login e accesso alla posta, il riquadro Accesso con account e collegamento delle caselle. Mostra due Redirect URI esatti per il tuo indirizzo di draften – terminano con /auth/callback e /mailboxes/connect/callback. Copiali da lì; devono corrispondere carattere per carattere.
  2. Apri l’elenco delle registrazioni delle app: nel menu a sinistra Entra ID → App registrations (nella versione precedente del menu Identity → Applications → App registrations). Direttamente: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  3. In alto fai clic su + New registration e compila:
    • Name – per esempio draften – accesso,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – nell’elenco a discesa Select a platform scegli Web e accanto inserisci il primo indirizzo del riquadro (termina con /auth/callback).

    Fai clic su Register. Si apre la pagina della nuova app.

  4. Nella pagina Overview copia l’Application (client) ID e il Directory (tenant) ID (l’icona di copia accanto al valore).
  5. Nel menu dell’app a sinistra apri Authentication. Per la piattaforma Web, nella parte Redirect URIs, fai clic su Add URI, inserisci il secondo indirizzo del riquadro (termina con /mailboxes/connect/callback) e in basso fai clic su Save.
  6. Certificates & secrets → scheda Client secrets → + New client secret. Description per esempio draften, in Expires scegli la validità (al massimo 24 mesi) e fai clic su Add. Nella tabella copia subito il valore della colonna Value – viene mostrato solo adesso; il Secret ID a draften non serve. Annota anche la data nella colonna Expires.
  7. API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Nella ricerca scrivi una alla volta e seleziona openid, profile, email, offline_access, User.Read, Mail.ReadWrite e MailboxSettings.ReadWrite e in basso fai clic su Add permissions. User.Read di solito è nell’elenco già dalla creazione. Senza offline_access il collegamento non dura – draften non riceverebbe un refresh token.
  8. Nella stessa pagina fai clic su Grant admin consent for … e conferma con Yes. Su tutte le righe, nella colonna Status, deve esserci la spunta verde. Se la tua organizzazione vieta agli utenti di dare il consenso alle app, senza questo passo il collegamento terminerebbe con il messaggio che il consenso è stato rifiutato.

In draften

  1. Il proprietario dell’organizzazione apre Organizzazione → Login e accesso alla posta e nel riquadro Accesso con account e collegamento delle caselle compila in Registrazione Entra per Accedi con Microsoft e Collega Outlook i valori Application (client) ID (passo 4) e Client secret (passo 6) e fa clic su Salva.
  2. L’accesso con l’account Microsoft lo attiva nella stessa pagina, nel riquadro Come accedono i membri: in ID della directory Microsoft (Entra) inserisce il Directory (tenant) ID. Appena l’organizzazione ha sia il client sia l’ID della directory, i membri accedono con l’account Microsoft e le loro password smettono di funzionare – vedi Come accedono i membri.
  3. Il proprietario della casella apre la pagina della casella e nel riquadro Accesso alla posta, nella riga Collega con l’account della casella:, fa clic su Collega Outlook. Accede con l’account di quella casella – draften rifiuta un altro account – e concede l’accesso. Il pulsante lo vede solo il proprietario della casella, e solo se l’organizzazione ha il client; senza, il riquadro al posto del pulsante scrive che il collegamento con l’account sarà possibile quando il proprietario dell’organizzazione avrà aggiunto il client.
  4. Poi Testa la connessione.

Quando la casella si scollega

Registrazione dell’organizzazione: accesso alla posta senza login

La registrazione ha autorizzazioni dell’applicazione: l’assistente entra nella casella senza che nessuno debba accedere. È adatta alle caselle condivise e alle organizzazioni che vogliono gestire l’accesso alle caselle centralmente. Con l’accesso a draften non ha nulla a che fare.

Ti serve un account con il ruolo di amministratore globale o di amministratore dei ruoli con privilegi – solo loro possono concedere il consenso alle autorizzazioni dell’applicazione di Microsoft Graph. La registrazione in sé può crearla anche un amministratore delle applicazioni.

In Microsoft Entra

Lavori nel Microsoft Entra admin center, https://entra.microsoft.com.

  1. Apri l’elenco delle registrazioni delle app: nel menu a sinistra Entra ID → App registrations (nella versione precedente del menu Identity → Applications → App registrations). Direttamente: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. In alto fai clic su + New registration e compila:
    • Name – per esempio draften – posta,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – lascialo vuoto.

    Fai clic su Register. Si apre la pagina della nuova app.

  3. Nella pagina Overview copia l’Application (client) ID e il Directory (tenant) ID (l’icona di copia accanto al valore).
  4. Nel menu dell’app a sinistra Certificates & secrets → scheda Client secrets → + New client secret. Description per esempio draften, in Expires scegli la validità (al massimo 24 mesi) e fai clic su Add. Nella tabella copia subito il valore della colonna Value – viene mostrato solo adesso; il Secret ID a draften non serve. Annota anche la data nella colonna Expires.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (non Delegated). Nella ricerca scrivi e seleziona Mail.ReadWrite e MailboxSettings.ReadWrite e in basso fai clic su Add permissions. MailboxSettings.ReadWrite serve solo per il colore della categoria in Outlook; senza, la categoria viene aggiunta senza colore. Se vuoi, aggiungi User.Read.All – con questa draften verifica gli alias della casella, senza il test della connessione scrive per gli alias che non può verificarli.
  6. Nella stessa pagina fai clic su Grant admin consent for … e conferma con Yes. Su tutte le righe, nella colonna Status, deve esserci la spunta verde.

In draften

  1. Apri Organizzazione → Login e accesso alla posta, il riquadro Registrazioni per caselle condivise e gestione centrale. Le registrazioni le gestiscono il proprietario o un gestore dell’organizzazione.
  2. Sistema: Microsoft 365 (Entra). Compila Nome, Directory (tenant) ID, Application (client) ID, Client secret (il valore del passo 4, non il suo ID) e Scadenza del segreto. Fai clic su Aggiungi registrazione. Il segreto viene salvato cifrato e non viene più mostrato.
  3. La registrazione da sola non collega nulla. Nella pagina di ogni casella, nel riquadro Accesso alla posta, scegli in Registrazione dell’organizzazione questa registrazione, fai clic su Applica e poi su Testa la connessione. La scelta la vede solo chi è insieme proprietario della casella e proprietario o gestore dell’organizzazione (il proprietario dell’organizzazione è proprietario di tutte le caselle). L’intera procedura con le schermate la mostra la guida Aggiungere e collegare una casella.

Con la casella automatica attiva (Come accedono i membri) una nuova casella si lega da sola alla registrazione, quando per Microsoft 365 ce n’è esattamente una attiva.

Restringere l’accesso a caselle scelte (facoltativo)

Un’autorizzazione dell’applicazione raggiunge tutte le caselle della directory; a fare da guardiano è draften (un membro non può aggiungere una casella, l’assistente non invia né elimina nulla). Chi vuole anche una barriera tecnica restringe l’app a un gruppo di sicurezza con la policy ApplicationAccessPolicy in Exchange Online. Ti servono PowerShell e il ruolo di amministratore di Exchange (o di amministratore globale).

Passo 1 – il modulo Exchange Online. Installalo una volta: avvia PowerShell come amministratore del computer e inserisci:

Install-Module ExchangeOnlineManagement

Passo 2 – il gruppo e la policy. Accedi a Exchange Online, crea un gruppo di sicurezza con le caselle a cui draften può accedere e la policy che limita l’app solo a quel gruppo. Al posto di <Application (client) ID> inserisci l’ID della registrazione del passo 3 qui sopra, al posto degli indirizzi le tue caselle:

Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - caselle consentite" -Alias draften-caselle -Type Security -Members casella@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-caselle@firma.cz -AccessRight RestrictAccess -Description "draften: solo caselle consentite"

Passo 3 – la verifica. Per una casella nel gruppo il comando deve mostrare AccessCheckResult : Granted, per una casella fuori dal gruppo Denied:

Test-ApplicationAccessPolicy -Identity casella@firma.cz -AppId <Application (client) ID>

Un’altra casella la aggiungi poi al gruppo nell’Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups), oppure con il comando Add-DistributionGroupMember -Identity draften-caselle@firma.cz -Member altra@firma.cz. Una casella fuori dal gruppo termina nel test della connessione con l’errore 403 (AppOnly AccessPolicy). Di solito la policy entra in vigore entro un’ora; abbiamo visto anche quattro ore. Come alternativa più recente Microsoft offre RBAC for Applications in Exchange Online; per ora non la descriviamo.

Sostituire il segreto

Il segreto ha una validità limitata e draften non invia nessun avviso sulla sua scadenza – la data nel riquadro diventa gialla 30 giorni prima della scadenza e rossa dopo. Mettiti un promemoria in calendario. Prima della scadenza:

  1. In Entra apri App registrations → la tua registrazione (per esempio draften – posta) → Certificates & secrets → + New client secret e copia il nuovo Value (come nel passo 4 qui sopra).
  2. In draften, in Organizzazione → Login e accesso alla posta, accanto alla registrazione scegli Nuovo segreto e inserisci il nuovo valore e la nuova data.
  3. Elimina il vecchio segreto in Entra con l’icona del cestino sulla sua riga.

Se il segreto scade prima, le caselle si scollegano (invalid_client) e gli assistenti le saltano. Dopo aver sostituito il segreto esegui Testa la connessione sulle caselle – un test riuscito riattiva la casella.

Errori del test della connessione

Il test verifica tre passaggi: Accesso, Token e autorizzazione e Lettura della Posta in arrivo. Accanto a ciascuno c’è una spunta, o una croce con il motivo:

Nel messaggioChe cosa significaChe cosa fare
AADSTS7000215, AADSTS7000222, invalid_clientclient secret errato o scadutocreare un nuovo segreto e salvarlo in draften
AADSTS700016, AADSTS90002, unauthorized_clientApplication ID o Directory ID erratoricopiare entrambi gli ID da Overview
AADSTS65001, AADSTS650057, consent_requiredmanca il consenso dell’amministratoreGrant admin consent nell’app
token senza Mail.ReadWritel’autorizzazione manca o non ha il consensoaggiungere l’autorizzazione e concedere il consenso
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008il collegamento con l’account è scaduto o è stato revocatoRicollega Outlook
HTTP 403 AppOnly AccessPolicyla casella non è nel gruppo della policy di accessoaggiungerla al gruppo e attendere
HTTP 404questa casella non esistecontrollare l’indirizzo; la casella deve avere Exchange Online
HTTP 401un’altra directory, o manca l’autorizzazionecontrollare il Directory ID e le autorizzazioni

Altri errori li descrive Risoluzione dei problemi.

Versione solo testo