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 vuoi | Che cosa configurare |
|---|---|
| I membri accedono con l’account Microsoft e ognuno ha la propria casella | il client dell’organizzazione – basta questo |
| In più caselle condivise (info@, vendite@), o l’accesso alle caselle impostato centralmente, senza i loro proprietari | in più la registrazione dell’organizzazione |
| Non vuoi l’accesso con l’account Microsoft | le 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’organizzazione | Registrazione dell’organizzazione | |
|---|---|---|
| Che cosa fa | l’accesso dei membri con il pulsante Accedi con Microsoft e il pulsante Collega Outlook accanto alla propria casella | l’accesso dell’assistente alle caselle senza che i loro proprietari accedano |
| Dove in draften | Organizzazione → Login e accesso alla posta → riquadro Accesso con account e collegamento delle caselle | Organizzazione → Login e accesso alla posta → riquadro Registrazioni per caselle condivise e gestione centrale |
| Chi se ne occupa in draften | il proprietario dell’organizzazione | il proprietario o un gestore dell’organizzazione |
| Autorizzazioni in Entra | delegate (Delegated) | dell’applicazione (Application) |
| Chi deve accedere alla casella | il proprietario di ogni casella, una volta | nessuno |
| Quali caselle raggiunge | solo quelle che le persone collegano da sé | le caselle della directory (si può restringere) |
| Caselle condivise | no – non hanno un proprio accesso | sì |
| Quando una persona lascia l’azienda | dopo il blocco del suo account la casella si scollega | non 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.
- 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/callbacke/mailboxes/connect/callback. Copiali da lì; devono corrispondere carattere per carattere. - 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
- 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.
- Name – per esempio
- Nella pagina Overview copia l’Application (client) ID e il Directory (tenant) ID (l’icona di copia accanto al valore).
- 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. - 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. - 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.ReadWriteeMailboxSettings.ReadWritee in basso fai clic su Add permissions.User.Readdi solito è nell’elenco già dalla creazione. Senzaoffline_accessil collegamento non dura – draften non riceverebbe un refresh token. - 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
- 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.
- 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.
- 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.
- Poi Testa la connessione.
Quando la casella si scollega
- Il segreto del client è scaduto – in Entra apri App registrations → la registrazione del client (per esempio
draften – accesso) → Certificates & secrets → + New client secret e copia il Value. Salvalo nel riquadro Accesso con account e collegamento delle caselle e sulle caselle fai clic su Ricollega Outlook. - La persona se n’è andata o il suo account è stato bloccato – Microsoft smette di rilasciare token e draften scollega la casella. Una casella senza un proprio accesso collegala con la registrazione dell’organizzazione (qui sotto).
- “Il fornitore non ha rilasciato un refresh token” – al client manca l’autorizzazione
offline_access(passo 7). - “Ha effettuato l’accesso un account diverso dall’indirizzo della casella” – durante il collegamento accedi con l’account proprio di quella casella; chi ha nel browser più account Microsoft sceglie quello giusto.
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.
- 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
- 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.
- Name – per esempio
- Nella pagina Overview copia l’Application (client) ID e il Directory (tenant) ID (l’icona di copia accanto al valore).
- 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. - API permissions → + Add a permission → Microsoft Graph → Application permissions (non Delegated). Nella ricerca scrivi e seleziona
Mail.ReadWriteeMailboxSettings.ReadWritee in basso fai clic su Add permissions.MailboxSettings.ReadWriteserve solo per il colore della categoria in Outlook; senza, la categoria viene aggiunta senza colore. Se vuoi, aggiungiUser.Read.All– con questa draften verifica gli alias della casella, senza il test della connessione scrive per gli alias che non può verificarli. - 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
- 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.
- 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.
- 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:
- 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). - In draften, in Organizzazione → Login e accesso alla posta, accanto alla registrazione scegli Nuovo segreto e inserisci il nuovo valore e la nuova data.
- 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 messaggio | Che cosa significa | Che cosa fare |
|---|---|---|
AADSTS7000215, AADSTS7000222, invalid_client | client secret errato o scaduto | creare un nuovo segreto e salvarlo in draften |
AADSTS700016, AADSTS90002, unauthorized_client | Application ID o Directory ID errato | ricopiare entrambi gli ID da Overview |
AADSTS65001, AADSTS650057, consent_required | manca il consenso dell’amministratore | Grant admin consent nell’app |
token senza Mail.ReadWrite | l’autorizzazione manca o non ha il consenso | aggiungere l’autorizzazione e concedere il consenso |
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008 | il collegamento con l’account è scaduto o è stato revocato | Ricollega Outlook |
HTTP 403 AppOnly AccessPolicy | la casella non è nel gruppo della policy di accesso | aggiungerla al gruppo e attendere |
| HTTP 404 | questa casella non esiste | controllare l’indirizzo; la casella deve avere Exchange Online |
| HTTP 401 | un’altra directory, o manca l’autorizzazione | controllare il Directory ID e le autorizzazioni |
Altri errori li descrive Risoluzione dei problemi.