Eseguire l'autenticazione con le API REST di Mobile Engagement - installazione manualeAuthenticate with Mobile Engagement REST APIs - manual setup

Importante

Azure Mobile Engagement verrà ritirato il 31/03/2018.Azure Mobile Engagement retires on 3/31/2018. Questa pagina verrà eliminata subito dopo.This page will be deleted shortly after.

Questa documentazione è un'appendice a Eseguire l'autenticazione con le API REST di Mobile Engagement.This documentation is an appendix to Authenticate with Mobile Engagement REST APIs. Assicurarsi di leggere prima questo articolo per capire il contesto.Make sure you read that article first to understand the context. Descrive inoltre un modo alternativo per eseguire la configurazione una tantum dell'autenticazione per le API REST di Mobile Engagement tramite il portale di Azure.It also describes an alternate way to do the one-time authentication setup for the Mobile Engagement REST APIs by using the Azure portal.

Nota

Le istruzioni seguenti si basano su questa guida di Active Directory.The following instructions are based on this Active Directory guide. Sono personalizzate per i requisiti di autenticazione per le API di Mobile Engagement.They are customized for the authentication requirements for Mobile Engagement APIs. Farvi riferimento per comprendere bene la procedura seguente.Refer to them if you want to understand the following steps in detail.

  1. Accedere all'account di Azure tramite il portale di Azure.Sign in to your Azure account through the Azure portal.
  2. Selezionare Active Directory dal riquadro di sinistra.Select Active Directory from the left pane.

    Selezionare Active Directory

  3. Per visualizzare le applicazioni nella directory, selezionare Registrazioni per l'app.To view the applications in your directory, select App registrations.

    Visualizzare le applicazioni

  4. Selezionare Registrazione nuova applicazione.Select New application registration.

    Aggiunta di un'applicazione

  5. Immettere il nome dell'applicazione.Fill in the name of the application. Lasciare il tipo di applicazione App Web/API, quindi selezionare Avanti.Leave the type of application as Web app/API, and then select the Next button. È possibile fornire un URL fittizio come URL di accesso.You can provide any dummy URLs for SIGN-ON URL. Questi valori non vengono usati per questo scenario e gli URL non vengono convalidati.They are not used for this scenario, and the URLs themselves are not validated.

    Al termine, si avrà un'app Azure Active Directory (Azure AD) con il nome specificato.After you finish, you have an Azure Active Directory (Azure AD) app with the name you provided. Verrà usato come AD_APP_NAME, quindi assicurarsi di prenderne nota.It is your AD_APP_NAME, so be sure to make a note of it.

    Nome app

  6. Selezionare il nome dell'app.Select the app name.

  7. Trovare l'ID applicazione e prenderne nota.Find Application ID and make a note of it. Si tratta dell'ID client che verrà usato come CLIENT_ID per le chiamate API.It is the client ID that will be used as CLIENT_ID for your API calls.

    Trovare l'ID applicazione

  8. Individuare la sezione Chiavi a destra.Find the Keys section on the right.

    Sezione Chiavi

  9. Creare una nuova chiave e copiarla immediatamente.Create a new key, and then immediately copy it. Non verrà visualizzata di nuovo.It isn't shown again.

    Riquadro Chiavi con dettagli sulle chiavi

    Importante

    Questa chiave scade alla fine della durata specificata.This key expires at the end of the duration that you specified. Ricordarsi di rinnovarla al momento opportuno, altrimenti l'autenticazione API non funzionerà più.Make sure to renew it when the time comes, otherwise your API authentication won't work anymore. Se si ritiene che sia stata compromessa, è possibile eliminare e ricreare la chiave.If you think that this key has been compromised, you can delete and re-create it.

  10. Selezionare il pulsante Endpoint nella parte superiore della pagina.Select the Endpoints button at the top of the page. Quindi, copiare l'ENDPOINT DI TOKEN OAUTH 2.0.Then copy the OAUTH 2.0 TOKEN ENDPOINT.

    Copiare l'endpoint

  11. L'endpoint è nel formato seguente, in cui il GUID nell'URL è il TENANT_ID: https://login.microsoftonline.com/<GUID>/oauth2/tokenThis endpoint is in the following form, where the GUID in the URL is your TENANT_ID: https://login.microsoftonline.com/<GUID>/oauth2/token

  12. A questo punto si possono configurare le autorizzazioni dell'app.Next, you configure the permissions on this app. Per avviare il processo, accedere al portale di Azure.To start the process, go to the Azure portal.

  13. Selezionare Gruppi di risorse e individuare il gruppo di risorse Mobile Engagement.Select Resource groups, and then find the MobileEngagement resource group.

    Trovare MobileEngagement

  14. Selezionare il gruppo di risorse MobileEngagement e quindi selezionare Tutte le impostazioni.Select the MobileEngagement resource group, and then select All settings.

    Passare alle impostazioni per MobileEngagement

  15. Selezionare Utenti nella sezione Impostazioni.Select Users in the Settings section. Quindi, per aggiungere un utente, selezionare Aggiungi.Then, to add a user, select Add.

    Aggiungere un utente

  16. Fare clic su Selezionare un ruolo.Click Select a role.

    Selezionare un ruolo

  17. Selezionare Proprietario.Select Owner.

    Selezionare il ruolo Proprietario

  18. Cercare il nome dell'applicazione, AD_APP_NAME, nella casella di ricerca.Search for the name of your application, AD_APP_NAME, in the search box. Questo nome non è presente per impostazione predefinita.This name is not here by default. Dopo averlo trovato, selezionarlo.After you find it, select it. Quindi, fare clic su Seleziona nella parte inferiore della sezione.Then click Select at the bottom of the section.

    Selezionare il nome

  19. Nella sezione Aggiungi accesso viene visualizzato come 1 utente, 0 gruppi.In the Add access section, it appears as 1 user, 0 groups. Selezionare OK per confermare la modifica.To confirm the change, select OK.

    Conferma di aggiunta utente

Ora la configurazione di Azure AD necessaria è terminata e tutto è pronto per le chiamate API.You have now completed the required Azure AD configuration and are all set to call the APIs.