Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Richiedere il consenso dell'utente con l'autenticazione ID Entra
Importante
Nel mese di giugno 2022, abbiamo introdotto l'autenticazione a più fattori come requisito per Bing Ads. Potrebbe comunque essere necessario apportare una modifica al codice per essere conformi a questo requisito. Microsoft Advertising eseguirà i controlli tecnici di applicazione all'inizio di ottobre.
Questo post del blog descrive i passaggi da eseguire per garantire la conformità.
Per altre informazioni, vedi la guida ai requisiti dell'autenticazione a più fattori .
Dopo aver registrato un'applicazione, è necessario ottenere il consenso dell'utente per poter gestire l'account Microsoft Advertising.
Consiglio
Per informazioni sulla risoluzione dei problemi, vedere la Guida agli errori OAuth comuni .
Importante
A ogni utente deve essere richiesto e fornire almeno una volta il consenso tramite il controllo di un Web browser affinché l'applicazione possa gestire i propri account Microsoft Advertising. Si tratta di un flusso OAuth 2.0 standard ed è definito in dettaglio nella sezione Authorization Code Grant della specifica OAuth 2.0.
Il flusso del codice di autorizzazione inizia con il client che indirizza l'utente all'endpoint /authorize . In questa richiesta, il client indica le autorizzazioni che deve acquisire dall'utente:
Nota
Sostituire your_client_id seguente con l'ID applicazione (client) assegnato all'app dal portale portale di Azure Registrazioni app.
// Line breaks for legibility only
https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize?
client_id=your_client_id
&response_type=code
&redirect_uri=http%3A%2F%2Flocalhost%2Fmyapp%2F
&response_mode=query
&scope=openid%20offline_access%20https%3A%2F%2Fads.microsoft.com%2Fmsads.manage
&state=12345
- Copiare l'URL seguente e incollarlo nel browser per eseguire questa richiesta di consenso utente di esempio.
Nota
Sostituire your_client_id nell'URL seguente con l'ID applicazione (client) assegnato dall'portale di Azure - Registrazioni app portale.
<https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=your_client_id&response_type=code&redirect_uri=http%3A%2F%2Flocalhost%2Fmyapp%2F&response_mode=query&scope=openid%20offline_access%20https%3A%2F%2Fads.microsoft.com%2Fmsads.manage&state=12345>
- Accedi con le credenziali del tuo account Microsoft e concedi all'app il consenso per gestire i tuoi account Microsoft Advertising.
- Dopo l'accesso, il browser dovrebbe essere reindirizzato a
https://localhost/myapp/con unacodenella barra degli indirizzi. È possibile ignorare il messaggio di errore nella pagina. - Successivamente, si userà il codice per ottenere i token di accesso e di aggiornamento.
L'endpoint di Microsoft Identity Platform verifica inoltre che l'utente abbia accettato le autorizzazioni indicate nel parametro di scope query. Se l'utente non ha acconsentito ad alcuna di queste autorizzazioni, gli chiederà di fornire le autorizzazioni necessarie. Sebbene questa guida si concentri principalmente sulla gestione degli account Microsoft Advertising tramite scope=https://ads.microsoft.com/msads.manage, qui sono disponibili ulteriori dettagli sulle autorizzazioni e sul consenso in Microsoft Identity Platform.
Una volta che l'utente esegue l'autenticazione e concede il consenso, l'endpoint di Microsoft Identity Platform restituirà una risposta all'app all'indirizzo indicatoredirect_uri, usando il metodo specificato nel response_mode parametro. Ad esempio, l'URI di callback include un codice di autorizzazione come indicato di seguito se l'utente ha concesso le autorizzazioni per l'applicazione per gestire i propri account Microsoft Advertising: http://localhost/myapp/?code=CodeGoesHere& stato=12345.
Se l'utente ha concesso all'applicazione le autorizzazioni per gestire i propri account Microsoft Advertising, è necessario utilizzare il codice immediatamente nel passaggio successivo. La breve durata del codice di autorizzazione, circa 5 minuti, è soggetta a modifiche. Se l'utente ha negato all'applicazione le autorizzazioni per gestire i propri account Microsoft Advertising, l'URI di callback include un campo di descrizione dell'errore come indicato di seguito: http://localhost/myapp/?error=access_denied& error_description=ERROR_DESCRIPTION&state=ClientStateGoesHere. Per altre informazioni sugli errori OAuth, vedere Errori OAuth comuni e Codici di errore di autenticazione e autorizzazione.
La tabella seguente include parametri che i client dell'API Bing Ads possono includere nella richiesta di consenso. Per ulteriori dettagli sui parametri facoltativi, vedere la documentazione sul flusso del codice di autorizzazione OAuth 2.0 di Microsoft Identity Platform.
| Parametro | Obbligatorio/Facoltativo | Descrizione |
|---|---|---|
client_id |
Dati obbligatori | ID applicazione (client) assegnato all'app dal portale di Azure - Registrazioni app portale. |
code_challenge |
Articoli consigliati | Usato per proteggere le concessioni di codici di autorizzazione tramite PKCE (Proof Key for Code Exchange). Obbligatorio se code_challenge_method è incluso. Per ulteriori informazioni, vedere la RFC PKCE. Questa opzione è consigliata per tutti i tipi di applicazione: app native, SPA e client riservati come le app Web. |
code_challenge_method |
Articoli consigliati | Metodo utilizzato per codificare il code_verifier per il code_challenge parametro. Può essere uno dei valori seguenti:- plain - S256Se escluso, viene considerato testo non crittografato code_challenge se code_challenge è incluso. Microsoft Identity Platform supporta sia e plainS256. Per ulteriori informazioni, vedere la RFC PKCE. |
prompt |
Facoltativo | Indica il tipo di interazione utente richiesta dall'applicazione. I valori supportati includono quanto segue: - prompt=login forzerà l'utente a immettere le credenziali per la richiesta, negando l'accesso singolo.- prompt=none è l'opposto di "login", ovvero assicurerà che all'utente non venga presentato alcun prompt interattivo. Se la richiesta non può essere completata automaticamente tramite Single Sign-On, l'endpoint Microsoft Identity Platform restituirà un errore interaction_required.- prompt=consent attiverà la finestra di dialogo di consenso OAuth dopo che l'utente ha eseguito l'accesso, chiedendo all'utente di concedere le autorizzazioni all'app.- prompt=select_account interromperà l'accesso Single Sign-On e fornirà l'esperienza di selezione dell'account, elencando tutti gli account nella sessione o qualsiasi account memorizzato o un'opzione per scegliere di utilizzare un account completamente diverso. |
redirect_uri |
Dati obbligatori | Il redirect_uri dell'app, in cui le risposte di autenticazione possono essere inviate e ricevute dall'app. Deve corrispondere esattamente a uno dei redirect_uris registrati nel portale, ad eccezione del fatto che deve essere codificato nell'URL. Per le app native & per dispositivi mobili, è consigliabile usare il valore predefinito di https://login.microsoftonline.com/common/oauth2/nativeclient. |
response_mode |
Articoli consigliati | Specifica il metodo da usare per inviare il token risultante all'app. Le possibili impostazioni sono: - query- fragment- form_postquery fornisce il codice come parametro della stringa di query nell'URI di reindirizzamento. Se si richiede un token ID usando il flusso implicito, non è possibile usarlo query come specificato nella specifica OpenID. Se stai richiedendo solo il codice, puoi usare query, fragment, oppure form_post.
form_post esegue un POST contenente il codice all'URI di reindirizzamento. Per altre informazioni, vedi Protocollo OpenID Connect. |
response_type |
Dati obbligatori | Deve essere incluso code per il flusso del codice di autorizzazione. |
scope |
Dati obbligatori | Elenco delimitato da spazi di ambiti per i quali si desidera che l'utente fornisca il consenso. Assicurarsi di includere https://ads.microsoft.com/msads.manage per richiedere all'utente l'accesso a Microsoft Advertising. Includere offline_access per assicurarsi che nella risposta sia incluso un token di aggiornamento. |
state |
Articoli consigliati | Un valore incluso nella richiesta che verrà restituito anche nella risposta del token. Può essere una stringa di qualsiasi contenuto desiderato. Un valore univoco generato casualmente viene in genere usato per impedire attacchi di contraffazione delle richieste tra siti. Il valore può anche codificare informazioni sullo stato dell'utente nell'app prima che si verificasse la richiesta di autenticazione, ad esempio la pagina o la visualizzazione in cui si trovava. |
tenant |
Dati obbligatori | Il {tenant} valore nel percorso della richiesta può essere usato per controllare chi può accedere all'applicazione. Per assicurarsi che l'applicazione supporti sia gli account personali MSA che gli account aziendali o dell'istituto di istruzione di Azure AD, è consigliabile usare common come tenant l'autenticazione API di Bing Ads.Nel caso in cui l'applicazione richieda un altro tenant, vedere endpoint di Microsoft Identity Platform per altre informazioni. |
Passaggi successivi (ID Entra)
Richiedere il consenso dell'utente con Google OAuth
Dopo aver registrato l'applicazione in Google OAuth, è necessario richiedere il consenso dell'utente per consentire all'applicazione di autenticare l'utente e chiamare le API di Microsoft Advertising per suo conto. Questo processo utilizza il flusso di codice di autorizzazione OAuth 2.0 standard fornito da Google.
Ogni utente deve completare il flusso di consenso almeno una volta in un Web browser prima che l'applicazione possa accedere ai suoi account Microsoft Advertising.
Consulta una panoramica del processo di consenso e autorizzazione OAuth di Google.
Richiesta di autorizzazione
Per richiedere il consenso dell'utente, reindirizzare il browser dell'utente all'endpoint di autorizzazione OAuth 2.0 di Google con i parametri di query necessari:
https://accounts.google.com/o/oauth2/v2/auth?
client_id={GOOGLE_CLIENT_ID}
&response_type=code
&redirect_uri={REGISTERED_REDIRECT_URI}
&scope=profile email
&access_type=offline
&prompt=consent
&state={STATE}
Parametri della richiesta di autorizzazione
| Parametro | Descrizione |
|---|---|
client_id |
ID client OAuth di Google ottenuto da Google Cloud Console. |
response_type |
Deve essere impostato per code ricevere un codice di autorizzazione. |
redirect_uri |
Deve corrispondere esattamente a uno degli URI di reindirizzamento registrati per il client OAuth di Google. |
scope |
Ambiti OAuth richiesti a Google (ad esempio, profile email). |
access_type=offline |
Richiede un token di aggiornamento in modo che l'applicazione possa ottenere nuovi token di accesso senza l'interazione dell'utente. |
prompt=consent |
Forza la visualizzazione della schermata di consenso per assicurarsi che venga rilasciato un token di aggiornamento. |
state |
Un valore consigliato usato per mantenere lo stato della richiesta e proteggersi dagli attacchi CSRF. |
Per un elenco completo dei parametri supportati, vedere:
https://developers.google.com/identity/protocols/oauth2/web-server
Flusso di consenso utente
- L'utente viene reindirizzato all'endpoint di autorizzazione di Google.
- L'utente accede con il proprio account Google, se non ha già effettuato l'accesso.
- Google visualizza una schermata di consenso che descrive le autorizzazioni richieste dall'applicazione.
- Se l'utente concede il consenso, Google reindirizza il browser verso di te
redirect_uricon un codice di autorizzazione:
https://yourapp.com/oauth/callback?code=AUTH_CODE&state={STATE}
Se l'utente nega il consenso, il reindirizzamento include un parametro di errore anziché un codice di autorizzazione.
Passaggi successivi (Google OAuth)
Dopo aver ricevuto il codice di autorizzazione, l'applicazione deve scambiarlo con un token di accesso e aggiornare il token utilizzando l'endpoint token di Google. Il token di accesso viene quindi usato per effettuare chiamate all'API Microsoft Advertising.
Nota
L'uso di Google OAuth influisce solo sul modo in cui l'utente esegue l'autenticazione.
Le intestazioni di richiesta dell'API di Microsoft Advertising, i requisiti del token per gli sviluppatori e i controlli delle autorizzazioni rimangono invariati.