Come gestire gli account utente con l'API di amministrazione di Exchange Online

By Mirko Peters · 2026-03-09 · Updated 2026-03-24

Scopri l'API di amministrazione di Exchange Online, un'alternativa basata su REST a Exchange Web Services (EWS). Gestisci in modo efficace gli account utente di Exchange Online.

Automatically translated with AI from the original post. Read the English original

Gestire gli account utente è fondamentale per qualsiasi organizzazione. Garantisce che i dipendenti abbiano l'accesso corretto alle risorse, proteggendo al tempo stesso le informazioni sensibili. L'API di amministrazione di Exchange semplifica e rende più efficiente questo processo. Grazie alle sue potenti funzionalità, puoi creare, aggiornare o eliminare rapidamente gli account utente. Inoltre, ti permette di gestire in modo efficace le cassette postali. Questa API semplifica il flusso di lavoro e ti fa risparmiare tempo, così puoi concentrarti su ciò che conta davvero: il tuo team.

Punti chiave

• L'API di amministrazione di Exchange semplifica la gestione degli account utente, consentendoti di creare, aggiornare ed eliminare account in modo efficiente.

• Usa OAuth 2.0 per un'autenticazione API sicura. Protegge le credenziali degli utenti utilizzando token di accesso al posto delle password.

• Proteggi sempre i token di accesso per prevenire accessi non autorizzati e potenziali violazioni dei dati.

• Implementa strategie di gestione degli errori per affrontare in modo efficace problemi comuni come accessi non autorizzati o richieste non valide.

• Presta attenzione ai limiti di frequenza quando usi l'API. Monitora il tuo utilizzo e valuta la possibilità di raggruppare le richieste per rimanere entro i limiti.

7 fatti sorprendenti sull'API di amministrazione di Exchange

Se gestisci Exchange Online, l'API di amministrazione di Exchange può cambiare il modo in cui automatizzi, proteggi e monitori il tuo ambiente. Ecco sette fatti sorprendenti sull'API di amministrazione di Exchange.

1. Espone la gestione delle cassette postali oltre Graph API. Sebbene Microsoft Graph copra molti scenari relativi a utenti e cassette postali, l'API di amministrazione di Exchange fornisce endpoint specializzati per la configurazione e la gestione specifiche di Exchange non disponibili in Graph, il che la rende la scelta ideale per un'automazione approfondita di Exchange Online.
2. Sono richiesti RBAC granulare e consenso dell'amministratore. L'API applica controlli di accesso basati sui ruoli focalizzati su Exchange e spesso richiede il consenso esplicito dell'amministratore per le operazioni sensibili; per questo, limitare i permessi al minimo necessario e usare entità servizio dedicate sono elementi essenziali per un'automazione sicura.
3. Supporta operazioni in batch e in blocco su larga scala. L'API di amministrazione di Exchange consente modelli di gestione in batch e in blocco (ad esempio, l'aggiornamento dei criteri su molte cassette postali), il che riduce in modo significativo il numero di chiamate e semplifica la gestione del tenant su larga scala.
4. Ha limitazioni e soglie a livello di tenant diverse da Graph. Le regole di throttling e i limiti delle richieste sono distinti da Microsoft Graph; devi progettare una logica di nuovo tentativo e di backoff specifica per il comportamento dell'API di amministrazione di Exchange, per evitare errori imprevisti sotto carico.
5. Abilita controlli avanzati di conformità e audit. L'API espone funzionalità di conformità specifiche di Exchange, come regole del flusso di posta, assegnazioni di criteri di conservazione e configurazioni di audit, consentendo l'applicazione programmatica dei criteri dell'organizzazione su larga scala.
6. Si integra con installazioni Exchange ibride. Per le organizzazioni in modalità ibrida, l'API di amministrazione di Exchange può essere usata insieme agli strumenti di gestione locali per coordinare impostazioni e criteri, facilitando gli scenari di migrazione e coesistenza.
7. Può essere estesa con PowerShell e flussi di autenticazione moderni. Puoi combinare i moduli PowerShell di Exchange Online e l'API di amministrazione di Exchange usando l'autenticazione OAuth 2.0 app-only o i flussi delegati, abilitando un'automazione moderna e sicura e mantenendo, quando necessario, le funzionalità PowerShell legacy.

Usa l'API di amministrazione di Exchange in complemento a Microsoft Graph e PowerShell per una gestione di Exchange Online solida, scalabile e sicura.

Metodi di autenticazione

Panoramica di OAuth 2.0

Quando lavori con l'Exchange Admin API, capire OAuth 2.0 è essenziale. Questo framework rafforza la sicurezza consentendo alle applicazioni di accedere alle risorse senza esporre le credenziali degli utenti. Invece di condividere password, usi token di accesso, che riducono in modo significativo il rischio di accessi non autorizzati. Ecco alcune caratteristiche chiave di OAuth 2.0 che lo rendono una scelta solida per l'autenticazione delle API:

Ottenere i token di accesso

Per interagire con l'Exchange Admin API, devi ottenere i token di accesso. Ecco una guida semplice, passo dopo passo, che ti accompagna nel processo:

1. Registra un'app in Microsoft Entra ID.

2. Assegna le autorizzazioni API richieste.

3. Assegna le autorizzazioni RBAC.

4. Ottieni un token di accesso.

Proteggere i token di accesso è fondamentale. Se i token non sono protetti, possono causare seri rischi per la sicurezza. Ecco alcuni potenziali pericoli dei token di accesso non protetti:

• Le API possono esporre dati sensibili se non sono protette correttamente.

• I token di accesso non protetti possono portare ad accessi non autorizzati e alla manipolazione dei dati.

• L'aumento degli attacchi alle API evidenzia la necessità di misure di sicurezza solide.

Inoltre, se qualcuno impersona un Global Admin, potrebbe ottenere il controllo completo del tuo tenant, incluso l'accesso a servizi come SharePoint Online ed Exchange Online. Ciò potrebbe causare violazioni di dati significative.

Per assegnare i ruoli RBAC di Exchange Online alle applicazioni per l'accesso alle API, segui questi passaggi:

1. Per gli scenari delegati, assicurati che l'utente abbia i ruoli RBAC necessari assegnati in Exchange Online, come Gestione destinatari o Gestione organizzazione.

2. Per gli scenari app-only, assegna i ruoli di Microsoft Entra o i gruppi di ruoli RBAC personalizzati di Exchange all'entità di servizio che rappresenta la tua app.

3. Usa il flusso di token di accesso OAuth 2.0 appropriato per il tipo di applicazione, delegato o app-only.

4. Installa Exchange Online PowerShell e connettiti.

5. Crea una nuova entità di servizio e assegna i ruoli richiesti.

6. Verifica l'assegnazione dei ruoli e testa l'RBAC per le applicazioni.

Seguendo queste linee guida, puoi gestire gli account utente in modo efficace, mantenendo sicure le tue interazioni con le API.

Gestione degli account utente con l'Exchange Admin API

Creazione degli account utente

Creare account utente con l'Exchange Admin API è semplice. Devi fornire i campi specifici per configurare un nuovo utente. Ecco un elenco rapido dei parametri obbligatori:

• Alias: il nome utente dell'account.

• Name: il nome completo dell'utente.

• FirstName: il nome di battesimo dell'utente.

• LastName: il cognome dell'utente.

• DisplayName: il modo in cui il nome dell'utente appare nella directory.

• MicrosoftOnlineServicesID: l'indirizzo email associato all'account.

• Password: dovrai richiedere questo dato in input.

• ResetPasswordOnNextLogon: è facoltativo, ma può essere impostato su true se vuoi che l'utente modifichi la password al primo accesso.

Ecco un semplice esempio di come potresti creare un account utente con PowerShell:

New-MgUser -AccountEnabled $true -DisplayName "Holly Holt" -MailNickname "hollyh" -UserPrincipalName "hollyh@corp.contoso.com" -PasswordProfile @{ForceChangePasswordNextSignIn=$true; Password="YourSecurePassword"}

Aggiornamento delle informazioni utente

Aggiornare le informazioni utente è altrettanto semplice. Puoi modificare vari attributi di un account utente tramite l'Exchange Admin API. Ecco alcuni attributi comuni che potresti voler aggiornare:

Per aggiornare un utente, puoi usare un comando come questo:

Update-MgUser -UserId "<userId>" -DisplayName "Holly Holt Updated"

Questo comando aggiorna il nome visualizzato dell'utente con l'ID utente specificato.

Eliminazione degli account utente

Quando si tratta di eliminare account utente, devi seguire alcuni passaggi per far sì che tutto proceda senza intoppi. Ecco una guida rapida:

1. Connettiti al tenant di Microsoft 365 tramite PowerShell con le autorizzazioni richieste.

2. Usa il comando Connect-MgGraph -Scopes User.Read.All, User.ReadWrite.All per stabilire la connessione.

3. Recupera l'ID utente filtrando per nome visualizzato con Get-MgUser -Filter "displayName eq '<display name>'".

4. Rimuovi l'account utente con il comando Remove-MgUser -UserId <userId> -Confirm:$false.

Questo processo ti consente di gestire in modo efficiente gli account utente, mantenendo la tua organizzazione sicura e ordinata.

Recupero delle caselle di posta per una gestione efficace

Recuperare le caselle di posta è fondamentale per una gestione efficace degli account utente. Ecco alcune procedure consigliate da tenere a mente:

• Usa sempre POST per tutte le operazioni, inclusi i cmdlet Get-*.

• Includi nell'endpoint solo i parametri supportati dal cmdlet.

• Usa X-AnchorMailbox per tutte le operazioni, così da garantire che le richieste vengano instradate correttamente.

• Usa $select per ridurre le dimensioni del payload di risposta, soprattutto quando lavori con grandi quantità di dati.

• Combina $select con la paginazione per gestire in modo efficiente i dati estesi.

Seguendo queste linee guida, puoi semplificare la gestione delle caselle di posta e assicurarti che gli account utente siano sempre aggiornati.

Procedure consigliate per l'API di amministrazione di Exchange

Gestione degli errori

Quando lavori con l'API di amministrazione di Exchange, potresti riscontrare degli errori. Saperli gestire in modo efficace può farti risparmiare tempo e frustrazione. Ecco una pratica tabella che illustra i codici di errore più comuni, le relative cause e le soluzioni suggerite:

Seguendo queste strategie, puoi ridurre al minimo le interruzioni e mantenere le tue operazioni in funzione senza intoppi.

Considerazioni sulla limitazione della frequenza delle richieste

La limitazione della frequenza (rate limiting) è un altro aspetto importante da considerare quando si usa l'API di amministrazione di Exchange. Aiuta a mantenere le prestazioni dell'API e garantisce un utilizzo equo da parte di tutti gli utenti. Ecco alcuni suggerimenti da tenere a mente:

• Conosci i limiti: familiarizza con i limiti di frequenza imposti dall'API. Queste informazioni ti aiutano a pianificare di conseguenza le richieste.

• Implementa strategie di backoff: se raggiungi un limite di frequenza, implementa una strategia di backoff. Significa attendere un po' prima di riprovare la richiesta. Questo può evitare che tu venga bloccato.

• Monitora l'utilizzo: tieni sotto controllo l'utilizzo dell'API. Gli strumenti di monitoraggio ti aiutano a tenere traccia del numero di richieste e a capire quando ti avvicini ai limiti.

• Raggruppa le richieste: se possibile, raggruppa le richieste. Così riduci il numero di chiamate e rimani più facilmente entro i limiti.

Prestando attenzione alla limitazione della frequenza, puoi fare in modo che le interazioni con l'API di amministrazione di Exchange restino efficienti ed efficaci.

In sintesi, l'API di amministrazione di Exchange è uno strumento potente per gestire in modo efficace gli account utente. Puoi creare, aggiornare ed eliminare account con facilità, facendo funzionare l'organizzazione senza intoppi. Ricorda che proteggere i token di accesso e capire la gestione degli errori sono aspetti fondamentali per un'esperienza fluida.

Per approfondire l'API di amministrazione di Exchange, considera queste risorse:

• Questo articolo ti guida a effettuare la tua prima chiamata riuscita all'API di amministrazione di Exchange Online e spiega i comportamenti e gli schemi chiave applicabili a tutti gli endpoint.

Quindi non esitare! Esplora l'API e scopri come può migliorare i tuoi processi di gestione degli utenti. Buon coding! 🚀

Domande frequenti

Che cos'è l'API di amministrazione di Exchange?

L'API di amministrazione di Exchange ti permette di gestire account utente e caselle di posta in Microsoft Exchange Online. Semplifica attività come la creazione, l'aggiornamento e l'eliminazione degli account utente, rendendo l'amministrazione più efficiente.

Come mi autentico con l'API di amministrazione di Exchange?

Ti autentichi usando OAuth 2.0. Registra la tua app in Microsoft Entra ID, assegna le autorizzazioni e ottieni un token di accesso per interagire con l'API in modo sicuro.

Posso automatizzare la gestione degli account utente?

Sì! Puoi automatizzare la gestione degli account utente usando script con PowerShell o altri linguaggi di programmazione. Così risparmi tempo e riduci gli errori manuali nell'amministrazione degli utenti.

Cosa devo fare se riscontro un errore?

Controlla il codice di errore e consulta la documentazione per i passaggi di risoluzione dei problemi. Tra i problemi più comuni ci sono token non validi o autorizzazioni mancanti. Adatta di conseguenza le richieste.

Come posso monitorare l'utilizzo dell'API?

Puoi monitorare l'utilizzo dell'API implementando la registrazione dei log nella tua applicazione. Tieni traccia del numero di richieste effettuate e fai attenzione agli avvisi di limitazione della frequenza per evitare interruzioni.

Che cos'è l'API di amministrazione di Exchange e che rapporto ha con Exchange Online?

L'API di amministrazione di Exchange è una nuova API amministrativa basata su REST, lanciata da Microsoft per consentire le attività di amministrazione di Exchange per Exchange Online e Office 365 Exchange Online. È un approccio basato su REST pensato per aiutare le organizzazioni a modernizzare l'automazione, con endpoint che eseguono un insieme mirato di cmdlet e parametri di Exchange per scenari di gestione comuni, gestiti in precedenza con EWS o con PowerShell di Exchange Online.

L'API di amministrazione di Exchange sostituisce Exchange Web Services (EWS)?

La nuova API non è una sostituzione diretta uno-a-uno di tutti gli scenari EWS, ma è pensata per aiutare le organizzazioni ad allontanarsi da EWS nel tempo. Microsoft ha annunciato le tempistiche di ritiro e indicazioni come il ritiro di alcuni scenari EWS a ottobre 2026. L'anteprima pubblica dell'API di amministrazione e l'API di amministrazione in anteprima pubblica offrono alternative REST per molti scenari di amministrazione di Exchange e modernizzano l'automazione.

Quali attività amministrative sono supportate dagli endpoint dell'API di amministrazione?

L'API supporta un insieme limitato di attività amministrative di Exchange Online, concentrate sulla gestione di Exchange come la gestione dei domini accettati, delle autorizzazioni delle cartelle della casella di posta, delle assegnazioni di delega e di autorizzazioni, oltre ad altre attività amministrative di Exchange. L'API di amministrazione è una superficie amministrativa basata su REST, pensata per supportare gli scenari comuni di amministrazione di Exchange e per consentire lo scripting e l'automazione basata su REST insieme ai cmdlet di PowerShell e agli script PowerShell.

Che impatto ha questo su Office 365 e sugli amministratori di Office 365 Exchange Online?

Per gli amministratori di Office 365 e Office 365 Exchange Online, l'anteprima di Exchange offre un percorso per modernizzarsi con un'API REST e ridurre la dipendenza dal codice EWS e dai cmdlet di Exchange. Gli amministratori possono usare gli endpoint dell'API di amministrazione oppure continuare a usare PowerShell di Exchange Online, mentre Microsoft amplia le funzionalità disponibili nell'anteprima pubblica dell'API di amministrazione. Questo aiuta le organizzazioni a migrare da EWS e ad adottare un'automazione moderna che si integra con i flussi di lavoro di gestione di Microsoft 365.

Che cosa succede a Exchange Online PowerShell e ai cmdlet PowerShell esistenti: verranno rimossi?

Exchange Online PowerShell e i cmdlet PowerShell restano un'opzione supportata per molte attività. L'admin API vuole integrare i cmdlet e i parametri di Exchange offrendo un'alternativa basata su REST per specifici scenari di amministrazione di Exchange. Microsoft ha rilasciato un'anteprima dell'admin API e indicazioni su come usare sia gli script PowerShell sia l'admin API. Alcuni scenari continueranno a richiedere Exchange Online PowerShell finché gli endpoint dell'admin API non copriranno un insieme più ampio di funzionalità di Exchange.

Quando verrà ritirato EWS e che cosa dovrebbero fare le organizzazioni prima di ottobre 2026?

Microsoft ha annunciato la deprecazione di alcuni utilizzi di EWS a partire da ottobre 2026 e ha invitato le organizzazioni a pianificare l'abbandono di EWS per specifici scenari di amministrazione di Exchange. Gli amministratori dovrebbero fare un inventario del codice EWS, degli utilizzi di EWS per l'amministrazione di Exchange e di qualsiasi altro scenario EWS presente nel proprio ambiente. Dopodiché dovrebbero valutare l'anteprima pubblica dell'admin API, le alternative REST API e Exchange Online PowerShell per modernizzare l'automazione prima della deprecazione di ottobre 2026.

L'admin API può gestire le autorizzazioni delle cassette postali, come mailboxfolderpermission e i delegati?

Sì, in molti scenari l'admin API supporta la gestione di mailboxfolderpermission e delle assegnazioni dei delegati. Mette a disposizione endpoint che consentono agli amministratori di impostare o modificare le impostazioni dei delegati e delle autorizzazioni. Inizialmente l'admin API potrebbe offrire un insieme limitato di funzioni, ma è progettata per aiutare le organizzazioni ad automatizzare queste specifiche attività di amministrazione di Exchange senza dipendere esclusivamente dal codice EWS o dai cmdlet di Exchange.

Come si accede all'admin API in anteprima pubblica e quale autenticazione è richiesta?

L'admin API è disponibile in anteprima pubblica e richiede l'autenticazione moderna tramite la piattaforma di identità Microsoft (Azure AD/Entra). Gli amministratori registrano un'app, concedono gli ambiti appropriati per l'accesso alle API di Exchange Online e richiamano gli endpoint dell'admin API basati su REST per gestire Exchange. Questo approccio consente di integrare l'automazione, gli script e i framework di gestione di Microsoft 365 già in uso.

L'admin API presenta delle limitazioni durante l'anteprima pubblica?

Durante l'anteprima pubblica dell'admin API, le funzionalità disponibili potrebbero essere un sottoinsieme di quelle offerte dai cmdlet di Exchange o da EWS. L'anteprima si concentra su specifiche attività di amministrazione di Exchange e su un sottoinsieme di funzioni del prodotto. Le organizzazioni dovrebbero verificare i propri scenari di amministrazione e modernizzare l'automazione combinando, dove necessario, gli endpoint dell'admin API con Exchange Online PowerShell, finché l'API non supporterà attività di gestione di Exchange più estese.

Come dovrebbero pianificare le organizzazioni la migrazione da EWS alla nuova admin API basata su REST?

Le organizzazioni dovrebbero partire da una panoramica dei carichi di lavoro di Exchange che dipendono da EWS, individuare gli specifici scenari di amministrazione di Exchange e gli scenari EWS che li coprono, e dare priorità alla migrazione dell'automazione con maggiore impatto verso l'admin API o Exchange Online PowerShell. Usa l'anteprima pubblica dell'admin API per testare gli scenari di amministrazione e modernizzare l'automazione, aggiorna gli script PowerShell e il codice EWS dove opportuno, e tieni d'occhio le indicazioni Microsoft sulla deprecazione e sulla disponibilità futura fino a ottobre 2026 e oltre.