Avvio rapido: Distribuire un'applicazione API RESTful in Azure Spring Apps

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo descrive come distribuire un'applicazione API RESTful protetta da Microsoft Entra ID in Azure Spring Apps. Il progetto di esempio è una versione semplificata basata sull'applicazione Web Simple Todo , che fornisce solo il servizio back-end e usa l'ID Microsoft Entra per proteggere le API RESTful.

Queste API RESTful sono protette applicando il controllo degli accessi in base al ruolo. Gli utenti anonimi non possono accedere ai dati e non sono autorizzati a controllare l'accesso per utenti diversi. Gli utenti anonimi hanno solo le tre autorizzazioni seguenti:

• Lettura: con questa autorizzazione, un utente può leggere i dati ToDo.
• Scrittura: con questa autorizzazione, un utente può aggiungere o aggiornare i dati ToDo.
• Elimina: con questa autorizzazione, un utente può eliminare i dati ToDo.

Al termine della distribuzione, è possibile visualizzare e testare le API tramite l'interfaccia utente di Swagger.

Il diagramma seguente illustra l'architettura del sistema:

Questo articolo descrive le opzioni seguenti per creare risorse e distribuirle in Azure Spring Apps:

• L'opzione plug-in portale di Azure + Maven offre un modo più convenzionale per creare risorse e distribuire le applicazioni in modo dettagliato. Questa opzione è adatta agli sviluppatori Spring che usano i servizi cloud di Azure per la prima volta.
• L'opzione dell'interfaccia della riga di comando per sviluppatori di Azure è un modo più efficiente per creare automaticamente le risorse e distribuire le applicazioni tramite semplici comandi. L'interfaccia della riga di comando per sviluppatori di Azure usa un modello per effettuare il provisioning delle risorse di Azure necessarie e per distribuire il codice dell'applicazione. Questa opzione è adatta agli sviluppatori Spring che hanno familiarità con i servizi cloud di Azure.

Questo articolo descrive le opzioni seguenti per creare risorse e distribuirle in Azure Spring Apps:

• L'opzione plug-in portale di Azure + Maven offre un modo più convenzionale per creare risorse e distribuire le applicazioni in modo dettagliato. Questa opzione è adatta agli sviluppatori Spring che usano i servizi cloud di Azure per la prima volta.
• L'opzione dell'interfaccia della riga di comando di Azure usa un potente strumento da riga di comando per gestire le risorse di Azure. Questa opzione è adatta agli sviluppatori Spring che hanno familiarità con i servizi cloud di Azure.

1. Prerequisiti

plug-in portale di Azure + Maven

• Una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

• Uno dei ruoli seguenti:

  • Amministratore globale o Amministratore ruolo con privilegi, per concedere il consenso per le app che richiedono qualsiasi autorizzazione, per qualsiasi API.
  • Amministratore dell'applicazione cloud o amministratore applicazione per concedere il consenso per le app che richiedono qualsiasi autorizzazione per qualsiasi API, ad eccezione dei ruoli dell'app Microsoft Graph (autorizzazioni dell'applicazione).
  • Ruolo della directory personalizzato che include l'autorizzazione per concedere le autorizzazioni alle applicazioni, per le autorizzazioni richieste dall'applicazione.

  Per altre informazioni, vedere Concedere il consenso amministratore a livello di tenant a un'applicazione.

• Se viene distribuita un'istanza del piano Enterprise di Azure Spring Apps per la prima volta nella sottoscrizione di destinazione, vedere la sezione Requisiti del Piano Enterprise in Azure Marketplace.

• Git.

• Java Development Kit (JDK) versione 17.

• Un tenant di Microsoft Entra. Per istruzioni sulla creazione di un tenant, vedere Avvio rapido: Creare un nuovo tenant in Microsoft Entra ID.

Interfaccia della riga di comando di Azure

• Una sottoscrizione di Azure, se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

• Uno dei ruoli seguenti:

  • Amministratore globale o Amministratore ruolo con privilegi, per concedere il consenso per le app che richiedono qualsiasi autorizzazione, per qualsiasi API.
  • Amministratore dell'applicazione cloud o amministratore applicazione per concedere il consenso per le app che richiedono qualsiasi autorizzazione per qualsiasi API, ad eccezione dei ruoli dell'app Microsoft Graph (autorizzazioni dell'applicazione).
  • Ruolo della directory personalizzato che include l'autorizzazione per concedere le autorizzazioni alle applicazioni, per le autorizzazioni richieste dall'applicazione.

  Per altre informazioni, vedere Concedere il consenso amministratore a livello di tenant a un'applicazione.

• Se viene distribuita un'istanza del piano Enterprise di Azure Spring Apps per la prima volta nella sottoscrizione di destinazione, vedere la sezione Requisiti del Piano Enterprise in Azure Marketplace.

• Git.

• Java Development Kit (JDK) versione 17.

• Un tenant di Microsoft Entra. Per istruzioni sulla creazione di un tenant, vedere Avvio rapido: Creare un nuovo tenant in Microsoft Entra ID.

• Interfaccia della riga di comando di Azure versione 2.53.1 o successiva.

plug-in portale di Azure + Maven

• Una sottoscrizione di Azure, se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

• Uno dei ruoli seguenti:

  • Amministratore globale o Amministratore ruolo con privilegi, per concedere il consenso per le app che richiedono qualsiasi autorizzazione, per qualsiasi API.
  • Amministratore dell'applicazione cloud o amministratore applicazione per concedere il consenso per le app che richiedono qualsiasi autorizzazione per qualsiasi API, ad eccezione dei ruoli dell'app Microsoft Graph (autorizzazioni dell'applicazione).
  • Ruolo della directory personalizzato che include l'autorizzazione per concedere le autorizzazioni alle applicazioni, per le autorizzazioni richieste dall'applicazione.

  Per altre informazioni, vedere Concedere il consenso amministratore a livello di tenant a un'applicazione.

• Git.

• Java Development Kit (JDK) versione 17.

• Un tenant di Microsoft Entra. Per istruzioni sulla creazione di un tenant, vedere Avvio rapido: Creare un nuovo tenant in Microsoft Entra ID.

Azure Developer CLI

• Una sottoscrizione di Azure, se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

• Uno dei ruoli seguenti:

  • Amministratore globale o Amministratore ruolo con privilegi, per concedere il consenso per le app che richiedono qualsiasi autorizzazione, per qualsiasi API.
  • Amministratore dell'applicazione cloud o amministratore applicazione per concedere il consenso per le app che richiedono qualsiasi autorizzazione per qualsiasi API, ad eccezione dei ruoli dell'app Microsoft Graph (autorizzazioni dell'applicazione).
  • Ruolo della directory personalizzato che include l'autorizzazione per concedere le autorizzazioni alle applicazioni, per le autorizzazioni richieste dall'applicazione.

  Per altre informazioni, vedere Concedere il consenso amministratore.

• Git.

• Java Development Kit (JDK) versione 17.

• Un tenant di Microsoft Entra. Per istruzioni sulla creazione di un tenant, vedere Avvio rapido: Creare un nuovo tenant in Microsoft Entra ID.

• Interfaccia della riga di comando per sviluppatori di Azure (AZD), versione 1.0.2 o successiva.

2. Preparare il progetto Spring

Per distribuire l'app per le API RESTful, il primo passaggio consiste nel preparare il progetto Spring per l'esecuzione in locale.

Usare la procedura seguente per clonare ed eseguire l'app in locale:

1. Usare il comando seguente per clonare il progetto di esempio da GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
   

2. Se si vuole eseguire l'app in locale, completare i passaggi nelle sezioni Esporre LE API RESTful e Aggiornare prima di tutto la configurazione dell'applicazione e quindi usare il comando seguente per eseguire l'applicazione di esempio con Maven:

   cd ASA-Samples-Restful-Application
   ./mvnw spring-boot:run
   

3. Preparare l'ambiente cloud

Le risorse principali necessarie per eseguire questa app di esempio sono un'istanza di Azure Spring Apps e un'istanza di Database di Azure per PostgreSQL. Le sezioni seguenti descrivono come creare queste risorse.

plug-in portale di Azure + Maven

3.1. Accedere al portale di Azure

Passare al portale di Azure e immettere le credenziali per accedere al portale. La visualizzazione predefinita è il dashboard del servizio.

3.2. Creare un'istanza di Azure Spring Apps

Usare la procedura seguente per creare un'istanza del servizio Azure Spring Apps:

1. Selezionare Crea una risorsa nell'angolo del portale di Azure.

2. Selezionare Calcolo di>Azure Spring Apps.

3. Compilare il modulo Informazioni di base con le informazioni seguenti:

   Impostazione	Valore suggerito	Descrizione
   Abbonamento	Nome della sottoscrizione.	Sottoscrizione di Azure da usare per il server. Se si hanno più sottoscrizioni, scegliere quella in cui si desidera che venga fatturata la risorsa.
   Gruppo di risorse	myresourcegroup	Nuovo nome di gruppo di risorse o uno esistente nella sottoscrizione.
   Nome	myasa	Nome univoco che identifica il servizio Azure Spring Apps. Il nome deve essere composto da 4-32 caratteri e può contenere solo lettere in minuscolo, numeri e trattini. Il primo carattere del nome del servizio deve essere una lettera e l'ultimo deve essere una lettera o un numero.
   Piano	Funzionalità per le aziende	Piano tariffario che determina la risorsa e il costo associati all'istanza.
   Area	Area più vicina agli utenti.	Località più vicina agli utenti.
   Ridondanza della zona	opzione non selezionata	Opzione per creare il servizio Azure Spring Apps in una zona di disponibilità di Azure. Questa funzionalità non è attualmente supportata in tutte le aree.
   Piano IP software	Pagamento in base al consumo	Piano tariffario che consente di pagare man mano che si usa Azure Spring Apps.
   Terms	Selected	Casella di controllo del contratto associata all'offerta marketplace. È necessario selezionare questa casella di controllo.
   Distribuire un progetto di esempio	opzione non selezionata	Opzione per usare l'applicazione di esempio predefinita.

4. Selezionare Rivedi e crea per rivedere le selezioni. Selezionare quindi Crea per effettuare il provisioning dell'istanza di Azure Spring Apps.

5. Sulla barra degli strumenti selezionare l'icona Notifiche a forma di campana per monitorare il processo di distribuzione. Al termine della distribuzione, è possibile selezionare Aggiungi al dashboard, che crea un riquadro per questo servizio nel dashboard portale di Azure come collegamento alla pagina Panoramica del servizio.

   

6. Selezionare Vai alla risorsa per passare alla pagina Panoramica di Azure Spring Apps.

3.3. Preparare l'istanza di PostgreSQL

Usare la procedura seguente per creare un server Database di Azure per PostgreSQL:

1. Passare al portale di Azure e selezionare Crea una risorsa.

2. Selezionare Database>Database di Azure per PostgreSQL.

3. Selezionare l'opzione di distribuzione Server flessibile.

   

4. Compilare la scheda Informazioni di base con le informazioni seguenti:

   • Nome server: my-demo-pgsql
   • Area: Stati Uniti orientali
   • Versione di PostgreSQL: 14
   • Tipo di carico di lavoro: Sviluppo
   • Abilitare la disponibilità elevata: deselezionata
   • Metodo di autenticazione: solo autenticazione PostgreSQL
   • Nome utente amministratore: myadmin
   • Password e Conferma password: immettere una password.

5. Usare le informazioni seguenti per configurare la scheda Rete :

   • Metodo di connettività: accesso pubblico (indirizzi IP consentiti)
   • Consenti l'accesso pubblico da qualsiasi servizio di Azure in Azure a questo server: selezionato

6. Selezionare Rivedi e crea per esaminare le selezioni e selezionare Crea per effettuare il provisioning del server. L'operazione potrebbe richiedere alcuni minuti.

7. Andare al Server PostgreSQL nel portale di Azure. Nella pagina Panoramica cercare il valore Nome server e quindi registrarlo per usarlo in un secondo momento. È necessario configurare le variabili di ambiente per l'app in Azure Spring Apps.

8. Selezionare Database dal menu di spostamento per creare un database, ad esempio todo.

   

3.4. Connettere l'istanza dell'app all'istanza di PostgreSQL

Usare la procedura seguente per connettere le istanze del servizio:

1. Passare all'istanza di Azure Spring Apps nel portale di Azure.

2. Dal menu di spostamento aprire App e quindi selezionare Crea app.

3. Nella pagina Crea app compilare il nome dell'app simple-todo-api e quindi selezionare Artefatti Java come tipo di distribuzione.

4. Selezionare Crea per completare la creazione dell'app e quindi selezionare l'app per visualizzare i dettagli.

5. Passare all'app creata nel portale di Azure. Nella pagina Panoramica selezionare Assegna endpoint per esporre l'endpoint pubblico per l'app. Salvare l'URL per l'accesso all'app dopo la distribuzione.

6. Selezionare Service Connector nel riquadro di spostamento, quindi selezionare Crea per creare una nuova connessione al servizio.

   

7. Compilare la scheda Informazioni di base con le informazioni seguenti:

   • Tipo di servizio: server flessibile db per PostgreSQL
   • Nome connessione: viene popolato un nome generato automaticamente, che può anche essere modificato.
   • Sottoscrizione: selezionare la propria sottoscrizione.
   • Server flessibile PostgreSQL: my-demo-pgsql
   • Database PostgreSQL: selezionare il database creato.
   • Tipo di client: SpringBoot

   

8. Configurare la scheda Avanti: Autenticazione con le informazioni seguenti:

   • Selezionare il tipo di autenticazione che si vuole usare tra il servizio di calcolo e il servizio di destinazione. Selezionare Stringa di connessione.
   • Continuare con...: Selezionare Credenziali database
   • Nome utente: myadmin
   • Password: immettere la password.

   

9. Selezionare Avanti: Rete. Usare l'opzione predefinita Configura regole del firewall per abilitare l'accesso al servizio di destinazione.

10. Selezionare Avanti: Rivedi e crea per esaminare le selezioni, quindi selezionare Crea per creare la connessione.

3.5. Esporre le API RESTful

Seguire questa procedura per esporre le API RESTful in Microsoft Entra ID:

1. Accedere al portale di Azure.

2. Se si ha accesso a più tenant, usare il filtro Directory + sottoscrizione ( ) per selezionare il tenant in cui si vuole registrare un'applicazione.

3. Cercare e selezionare Microsoft Entra ID.

4. In Gestisci selezionare Registrazioni app>Nuova registrazione.

5. Immettere un nome per l'applicazione nel campo Nome, ad esempio Todo. Tale nome, che potrebbe essere visualizzato dagli utenti dell'app, può essere modificato in un secondo momento.

6. Per Tipi di account supportati selezionare Account in qualsiasi directory organizzativa (Qualsiasi directory Microsoft Entra - Multi-tenant) e account Microsoft personali.

7. Selezionare Registra per creare l'applicazione.

8. Nella pagina Panoramica dell'app cercare il valore del campo ID applicazione (client) e prenderne nota per un uso futuro. È necessario configurare il file di configurazione YAML per questo progetto.

9. In Gestisci selezionare Esporre un'API, trovare l'URI ID applicazione all'inizio della pagina e quindi selezionare Aggiungi.

10. Nella pagina Modifica URI ID applicazione accettare l'URI ID applicazione proposto (api://{client ID}) o usare un nome significativo anziché l'ID client, ad esempio api://simple-todoe quindi selezionare Salva.

11. In Gestisci selezionare Esporre un'API>Aggiungi un ambito e quindi immettere le informazioni seguenti:

    • In Nome ambito immettere ToDo.Read.
    • Per Chi può fornire il consenso, selezionare Solo amministratori.
    • Per Nome visualizzato del consenso amministratore immettere Leggi i dati ToDo.
    • Per Descrizione del consenso amministratore immettere Consente agli utenti autenticati di leggere i dati ToDo.
    • Per Stato mantenere abilitato.
    • Seleziona Aggiungi ambito.

12. Ripetere i passaggi precedenti per aggiungere gli altri due ambiti: ToDo.Write e ToDo.Delete.

    

3.6. Aggiornare la configurazione dell'applicazione

Seguire questa procedura per aggiornare il file YAML per usare le informazioni dell'applicazione registrata di Microsoft Entra per stabilire una relazione con l'applicazione API RESTful:

1. Individuare il file src/main/resources/application.yml per l'app simple-todo-api . Aggiornare la configurazione nella spring.cloud.azure.active-directory sezione in modo che corrisponda all'esempio seguente. Assicurarsi di sostituire i segnaposto con i valori creati in precedenza.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Nota

   Nei token v1.0, la configurazione richiede l'ID client dell'API, mentre nei token v2.0 è possibile usare l'ID client o l'URI ID applicazione nella richiesta. È possibile configurare entrambi per completare correttamente la convalida del gruppo di destinatari.

   I valori consentiti per tenant-id sono: common, organizations, consumerso l'ID tenant. Per altre informazioni su questi valori, vedere la sezione Usato l'endpoint errato (account personali e dell'organizzazione) di Errore AADSTS50020 - L'account utente del provider di identità non esiste nel tenant. Per informazioni sulla conversione dell'app a tenant singolo, vedere Convertire l'app a tenant singolo in multi-tenant in Microsoft Entra ID.

2. Usare il comando seguente per ricompilare il progetto di esempio:

   ./mvnw clean package
   

Interfaccia della riga di comando di Azure

3.1. Specificare i nomi per ogni risorsa

Creare variabili per contenere i nomi delle risorse usando i comandi seguenti. Assicurarsi di sostituire i segnaposto con i propri valori.

export RESOURCE_GROUP=myresourcegroup
export LOCATION=<location>
export POSTGRESQL_SERVER=my-demo-pgsql
export POSTGRESQL_DB=Todo
export POSTGRESQL_ADMIN_USERNAME=<admin-username>
export POSTGRESQL_ADMIN_PASSWORD=<admin-password>
export AZURE_SPRING_APPS_NAME=myasa
export APP_NAME=simple-todo-api
export TODO_APP_NAME=Todo
export TODO_APP_URL=api://simple-todo
export TODOWEB_APP_NAME=TodoWeb
export TODOWEB_APP_URL=api://simple-todoweb
export NEW_MEMBER_USERNAME=<new-member-username>
export NEW_MEMBER_PASSWORD=<new-member-password>
export USER_PRINCIPAL_NAME=<user-principal-name>

3.2. Creare un nuovo gruppo di risorse

Usare la procedura seguente per creare un nuovo gruppo di risorse:

1. Usare il comando seguente per accedere all'interfaccia della riga di comando di Azure:

   az login
   

2. Usare il comando seguente per impostare il percorso predefinito:

   az configure --defaults location=${LOCATION}
   

3. Usare il comando seguente per elencare tutte le sottoscrizioni disponibili per determinare l'ID sottoscrizione da usare:

   az account list --output table
   

4. Usare il comando seguente per impostare la sottoscrizione predefinita:

   az account set --subscription <subscription-ID>
   

5. Usare il comando seguente per creare un gruppo di risorse:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Usare il comando seguente per impostare il gruppo di risorse appena creato come gruppo di risorse predefinito:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Installare l'estensione e registrare lo spazio dei nomi

Usare i comandi seguenti per installare l'estensione Azure Spring Apps per l'interfaccia della riga di comando di Azure e registrare lo Microsoft.SaaS spazio dei nomi:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Creare un'istanza di Azure Spring Apps

Usare la procedura seguente per creare un'istanza del servizio e un'applicazione nell'istanza di :

1. Usare il comando seguente per accettare le condizioni legali e le informative sulla privacy per il piano Enterprise:

   Nota

   Questo passaggio è necessario solo se la sottoscrizione non è mai stata usata per creare un'istanza del piano Enterprise di Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. Usare il comando seguente per creare un'istanza del servizio Azure Spring Apps:

   az spring create --name ${AZURE_SPRING_APPS_NAME} --sku enterprise
   

3. Usare il comando seguente per creare un'applicazione nell'istanza di Azure Spring Apps:

   az spring app create \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --assign-endpoint true
   

3.5. Preparare l'istanza di PostgreSQL

L'app Web Spring usa H2 per il database in localhost e Database di Azure per PostgreSQL per il database in Azure.

Usare il comando seguente per creare un'istanza di PostgreSQL:

az postgres flexible-server create \
    --name ${POSTGRESQL_SERVER} \
    --database-name ${POSTGRESQL_DB} \
    --admin-user ${POSTGRESQL_ADMIN_USERNAME} \
    --admin-password ${POSTGRESQL_ADMIN_PASSWORD} \
    --public-access 0.0.0.0

Specificando 0.0.0.0 consente l'accesso pubblico da qualsiasi risorsa distribuita in Azure per accedere al server.

3.6. Connettere l'istanza dell'app all'istanza di PostgreSQL

Dopo aver creato l'istanza dell'applicazione e l'istanza di PostgreSQL, l'istanza dell'applicazione non può accedere direttamente all'istanza di PostgreSQL. Usare la procedura seguente per consentire all'app di connettersi all'istanza di PostgreSQL:

1. Usare il comando seguente per ottenere il nome di dominio completo dell'istanza di PostgreSQL:

   export PSQL_FQDN=$(az postgres flexible-server show \
       --name ${POSTGRESQL_SERVER} \
       --query fullyQualifiedDomainName \
       --output tsv)
   

2. Usare il comando seguente per fornire le spring.datasource. proprietà all'app tramite variabili di ambiente:

   az spring app update \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
             SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
             SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"
   

3.7. Esporre le API RESTful

Usare la procedura seguente per esporre le API RESTful:

1. Usare il comando seguente per creare un'applicazione Microsoft Entra ID:

   az ad app create \
       --display-name ${TODO_APP_NAME} \
       --sign-in-audience AzureADandPersonalMicrosoftAccount \
       --identifier-uris ${TODO_APP_URL}
   

2. Usare il comando seguente per creare un'entità servizio per l'applicazione:

   az ad sp create --id ${TODO_APP_URL}
   

3. Usare il comando seguente per generare ID autorizzazione:

   permissionid1=$(uuidgen);permissionid2=$(uuidgen);permissionid3=$(uuidgen)
   

4. Aggiungere gli ambiti seguenti come JSON:

   api=$(echo '{
    "oauth2PermissionScopes": [
        {
            "adminConsentDescription": "Allows authenticated users to delete the ToDo data",
            "adminConsentDisplayName": "Delete the ToDo data",
            "id": "'$permissionid1'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Delete"
        },
   
        {
            "adminConsentDescription": "Allows authenticated users to write the ToDo data",
            "adminConsentDisplayName": "Write the ToDo data",
            "id": "'$permissionid2'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Write"
        },
        {
            "adminConsentDescription": "Allows authenticated users to read the ToDo data",
            "adminConsentDisplayName": "Read the ToDo data",
            "id": "'$permissionid3'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Read"
        }
    ]}')
   

5. Usare il comando seguente per aggiungere ambiti:

   az ad app update \
       --id ${TODO_APP_URL} \
       --set api="$api"
   

6. Usare il comando seguente per ottenere l'ID tenant da usare nel passaggio successivo:

   az account show --query "tenantId" --output tsv
   

7. Usare il comando seguente per ottenere l'ID applicazione da usare nei passaggi successivi:

   appid=$(az ad app show \
       --id ${TODO_APP_URL} \
       --query appId \
       --output tsv);
   echo $appid
   

3.8. Aggiornare la configurazione dell'applicazione

Seguire questa procedura per aggiornare il file YAML per usare le informazioni dell'applicazione registrata di Microsoft Entra per stabilire una relazione con l'applicazione API RESTful:

1. Individuare il file src/main/resources/application.yml per l'app simple-todo-api . Aggiornare la configurazione nella spring.cloud.azure.active-directory sezione in modo che corrisponda all'esempio seguente. Assicurarsi di sostituire i segnaposto con i valori creati in precedenza.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Nota

   Nei token v1.0, la configurazione richiede l'ID client dell'API, mentre nei token v2.0 è possibile usare l'ID client o l'URI ID applicazione nella richiesta. È possibile configurare entrambi per completare correttamente la convalida del gruppo di destinatari.

   I valori consentiti per tenant-id sono: common, organizations, consumerso l'ID tenant. Per altre informazioni su questi valori, vedere la sezione Usato l'endpoint errato (account personali e dell'organizzazione) di Errore AADSTS50020 - L'account utente del provider di identità non esiste nel tenant. Per informazioni sulla conversione dell'app a tenant singolo, vedere Convertire l'app a tenant singolo in multi-tenant in Microsoft Entra ID.

2. Usare il comando seguente per ricompilare il progetto di esempio:

   ./mvnw clean package
   

4. Distribuire l'app in Azure Spring Apps

plug-in portale di Azure + Maven

È ora possibile distribuire l'app in App Spring di Azure.

Usare la procedura seguente per distribuire usando il plug-in Maven per Azure Spring Apps:

1. Passare alla directory completa e quindi eseguire il comando seguente per configurare l'app in Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   L'elenco seguente descrive le interazioni con i comandi:

   • Accesso OAuth2: è necessario autorizzare l'accesso ad Azure in base al protocollo OAuth2.
   • Selezionare la sottoscrizione: selezionare il numero di elenco di sottoscrizioni dell'istanza di Azure Spring Apps creata, che per impostazione predefinita corrisponde alla prima sottoscrizione nell'elenco. Se si usa il numero predefinito, premere INVIO direttamente.
   • Usare le app Spring di Azure esistenti in Azure: premere y per usare l'istanza di Azure Spring Apps esistente.
   • Selezionare App Spring di Azure per la distribuzione: selezionare il numero dell'istanza di Azure Spring Apps creata. Se si usa il numero predefinito, premere INVIO direttamente.
   • Usare l'app esistente in Azure Spring Apps <nome-istanza>: premere y per usare l'app creata.
   • Confermare di salvare tutte le configurazioni precedenti: premere y. Se si preme n, la configurazione non viene salvata nei file POM.

2. Usare il comando seguente per distribuire l'app:

   ./mvnw azure-spring-apps:deploy
   

   L'elenco seguente descrive l'interazione con il comando:

   • Accesso OAuth2: è necessario autorizzare l'accesso ad Azure in base al protocollo OAuth2.

   Dopo l'esecuzione del comando, è possibile visualizzare i messaggi di log seguenti che la distribuzione ha avuto esito positivo:

[INFO] Deployment Status: Running
[INFO]   InstanceName:simple-todo-api-default-15-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A       
[INFO] Getting public url of app(simple-todo-api)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-api.azuremicroservices.io

Interfaccia della riga di comando di Azure

Usare il comando seguente per distribuire l'app in base al codice sorgente:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_NAME} \
    --name ${APP_NAME} \
    --build-env BP_JVM_VERSION=17 \
    --source-path .

5. Convalidare l'app

plug-in portale di Azure + Maven

È ora possibile accedere all'API RESTful per verificare se funziona.

5.1. Richiedere un token di accesso

Le API RESTful fungono da server di risorse, protetto dall'ID Microsoft Entra. Prima di acquisire un token di accesso, è necessario registrare un'altra applicazione in Microsoft Entra ID e concedere le autorizzazioni all'applicazione client, denominata ToDoWeb.

Registrare l'applicazione client

Seguire questa procedura per registrare un'applicazione in Microsoft Entra ID, che viene usata per aggiungere le autorizzazioni per l'app ToDo :

1. Accedere al portale di Azure.

2. Se si ha accesso a più tenant, usare il filtro Directory + sottoscrizione ( ) per selezionare il tenant in cui si vuole registrare un'applicazione.

3. Cercare e selezionare Microsoft Entra ID.

4. In Gestisci selezionare Registrazioni app>Nuova registrazione.

5. Immettere un nome per l'applicazione nel campo Nome, ad esempio ToDoWeb. Tale nome, che potrebbe essere visualizzato dagli utenti dell'app, può essere modificato in un secondo momento.

6. Per Tipi di account supportati, usare solo il valore predefinito Account in questa directory organizzativa.

7. Selezionare Registra per creare l'applicazione.

8. Nella pagina Panoramica dell'app cercare il valore del campo ID applicazione (client) e prenderne nota per un uso futuro. È necessario per acquisire un token di accesso.

9. Selezionare Autorizzazioni API>Aggiungi un'autorizzazione>Le mie API. Selezionare l'applicazione ToDo registrata in precedenza e quindi selezionare le autorizzazioni ToDo.Read, ToDo.Write e ToDo.Delete . Selezionare Aggiungi autorizzazioni.

10. Selezionare Concedi consenso amministratore per <your-tenant-name> per concedere il consenso amministratore per le autorizzazioni aggiunte.

    

Aggiungere un utente per accedere alle API RESTful

Usare la procedura seguente per creare un utente membro nel tenant di Microsoft Entra. L'utente può quindi gestire i dati dell'applicazione ToDo tramite le API RESTful.

1. In Gestisci selezionare Utenti>Nuovo utente>Crea nuovo utente.

2. Nella pagina Crea nuovo utente immettere le informazioni seguenti:

   • Nome entità utente: immettere un nome per l'utente.
   • Nome visualizzato: immettere un nome visualizzato per l'utente.
   • Password: copiare la password generata automaticamente nella casella Password .

   Nota

   I nuovi utenti devono completare la prima autenticazione di accesso e aggiornare le password. In caso contrario, viene visualizzato un AADSTS50055: The password is expired errore quando si ottiene il token di accesso.

   Quando un nuovo utente accede, riceve una richiesta di azione richiesta . Possono scegliere Chiedi in un secondo momento per ignorare la convalida.

3. Selezionare Revisione e creazione per rivedere le selezioni effettuate. Selezionare Crea per creare l'utente.

Aggiornare la configurazione di OAuth2 per l'autorizzazione dell'interfaccia utente di Swagger

Seguire questa procedura per aggiornare la configurazione di OAuth2 per l'autorizzazione dell'interfaccia utente di Swagger. È quindi possibile autorizzare gli utenti ad acquisire i token di accesso tramite l'app ToDoWeb .

1. Aprire il tenant di Microsoft Entra ID nella portale di Azure e passare all'app registrataToDoWeb.

2. In Gestisci selezionare Autenticazione, selezionare Aggiungi una piattaforma e quindi selezionare Applicazione a pagina singola.

3. Usare il formato <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html come URL di reindirizzamento OAuth2 nel campo URI di reindirizzamento e quindi selezionare Configura.

   

Interfaccia della riga di comando di Azure

È ora possibile accedere all'API RESTful per verificare se funziona.

5.1. Richiedere un token di accesso

Le API RESTful fungono da server di risorse, protetto dall'ID Microsoft Entra. Prima di acquisire un token di accesso, è necessario registrare un'altra applicazione in Microsoft Entra ID e concedere le autorizzazioni all'applicazione client, denominata ToDoWeb.

Registrare l'applicazione client

Usare la procedura seguente per registrare l'applicazione client:

1. Usare il comando seguente per creare un'applicazione Microsoft Entra ID, usata per aggiungere le autorizzazioni per l'app ToDo :

   az ad app create \
       --display-name ${TODOWEB_APP_NAME} \
       --sign-in-audience AzureADMyOrg \
       --identifier-uris ${TODOWEB_APP_URL}
   

2. Usare il comando seguente per aggiungere autorizzazioni:

   az ad app permission add \
       --id api://simple-todowebtest2 \
       --api $appid \
       --api-permissions $permissionid1=Scope $permissionid2=Scope $permissionid3=Scope
   

3. Usare il comando seguente per concedere il consenso amministratore per le autorizzazioni aggiunte:

   az ad app permission admin-consent --id ${TODOWEB_APP_URL}
   

4. Usare il comando seguente per ottenere l'ID client dell'app ToDoWeb usata nel passaggio Ottenere il token di accesso:

   az ad app show \
       --id ${TODOWEB_APP_URL} \
       --query appId \
       --output tsv
   

Aggiungere un utente per accedere alle API RESTful

Usare il comando seguente per creare un utente membro nel tenant di Microsoft Entra. L'utente può quindi gestire i dati dell'applicazione ToDo tramite le API RESTful:

az ad user create \
    --display-name ${NEW_MEMBER_USERNAME} \
    --password ${NEW_MEMBER_PASSWORD} \
    --user-principal-name ${USER_PRINCIPAL_NAME}

Aggiornare la configurazione di OAuth2 per l'autorizzazione dell'interfaccia utente di Swagger

Per aggiornare la configurazione di OAuth2, seguire questa procedura:

1. Usare il comando seguente per ottenere l'ID oggetto dell'app ToDoWeb :

   az ad app show --id ${TODOWEB_APP_URL} --query id
   

2. Usare il comando seguente per ottenere l'URL dell'app simple-todo-api :

   az spring app show \
       --name ${APP_NAME} \
       --service ${AZURE_SPRING_APPS_NAME} \
       --query properties.url
   

3. Usare il comando seguente per aggiornare la configurazione di OAuth2 per l'autorizzazione dell'interfaccia utente di Swagger, sostituendo i <object-id> segnaposto e <URL> con i valori dei parametri ottenuti. È quindi possibile autorizzare gli utenti ad acquisire i token di accesso tramite l'app ToDoWeb .

   az rest \
       --method PATCH \
       --uri "https://graph.microsoft.com/v1.0/applications/<object-id>" \
       --headers 'Content-Type=application/json' \
       --body '{"spa":{"redirectUris":["<URL>/swagger-ui/oauth2-redirect.html"]}}'
   

2. Preparare il progetto Spring

Per distribuire l'app per le API RESTful, il primo passaggio consiste nel preparare il progetto Spring per l'esecuzione in locale.

plug-in portale di Azure + Maven

Usare la procedura seguente per clonare ed eseguire l'app in locale:

1. Usare il comando seguente per clonare il progetto di esempio da GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
   

2. Se si vuole eseguire l'app in locale, completare i passaggi nelle sezioni Esporre LE API RESTful e Aggiornare prima di tutto la configurazione dell'applicazione e quindi usare il comando seguente per eseguire l'applicazione di esempio con Maven:

   cd ASA-Samples-Restful-Application
   ./mvnw spring-boot:run
   

Azure Developer CLI

Usare la procedura seguente per inizializzare l'applicazione Web dai modelli dell'interfaccia della riga di comando per sviluppatori di Azure:

1. Aprire un terminale, creare una nuova cartella vuota e quindi modificarla.

2. Eseguire il comando seguente per inizializzare il progetto:

   azd init --template Azure-Samples/ASA-Samples-Restful-Application
   

   L'elenco seguente descrive le interazioni con i comandi:

   • Accesso OAuth2: è necessario autorizzare l'accesso ad Azure in base al protocollo OAuth2.
   • Immettere un nuovo nome di ambiente: specificare un nome di ambiente. Questo nome viene usato come suffisso per il gruppo di risorse creato per contenere tutte le risorse di Azure. Questo nome deve essere univoco all'interno della sottoscrizione di Azure.

   La console restituisce messaggi simili all'esempio seguente:

   Initializing a new project (azd init)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. Preparare l'ambiente cloud

Le risorse principali necessarie per eseguire questa app di esempio sono un'istanza di Azure Spring Apps e un'istanza di Database di Azure per PostgreSQL. Le sezioni seguenti descrivono come creare queste risorse.

plug-in portale di Azure + Maven

3.1. Accedere al portale di Azure

Passare al portale di Azure e immettere le credenziali per accedere al portale. La visualizzazione predefinita è il dashboard del servizio.

3.2. Creare un'istanza di Azure Spring Apps

Per creare un'istanza del servizio, seguire questa procedura:

1. Selezionare Crea una risorsa nell'angolo del portale.

2. Selezionare Calcolo di>Azure Spring Apps.

3. Compilare il modulo Informazioni di base. Usare la tabella seguente come guida per completare il modulo. Il valore del piano consigliato è Consumo standard e dedicato (anteprima).The recommended Plan value is Standard consumption & dedicated (preview).

   Impostazione	Valore suggerito	Descrizione
   Abbonamento	Nome della sottoscrizione.	Sottoscrizione di Azure da usare per il server. Se si hanno più sottoscrizioni, scegliere quella in cui si desidera che venga fatturata la risorsa.
   Gruppo di risorse	myresourcegroup	Nuovo nome di gruppo di risorse o uno esistente nella sottoscrizione.
   Nome	myasa	Nome univoco che identifica il servizio Azure Spring Apps. Il nome deve essere composto da 4-32 caratteri e può contenere solo lettere in minuscolo, numeri e trattini. Il primo carattere del nome del servizio deve essere una lettera e l'ultimo deve essere una lettera o un numero.
   Piano	Consumo standard e dedicato (anteprima)	Il piano tariffario determina le risorse e i costi associati all'istanza.
   Area	Area più vicina agli utenti.	Località più vicina agli utenti.
   Ambiente app contenitore	myenvironment	Opzione per selezionare l'istanza dell'ambiente app contenitore in cui condividere la stessa rete virtuale con altri servizi e risorse.

   Usare la tabella seguente come guida per la creazione dell'ambiente app contenitore:

   Impostazione	Valore suggerito	Descrizione
   Nome ambiente	myenvironment	Nome univoco che identifica il servizio Azure Container Apps Environment.
   Piano	Consumo	Il piano tariffario determina le risorse e i costi associati all'istanza.
   Ridondanza della zona	Disabilitata	Opzione per creare il servizio Ambiente app contenitore in una zona di disponibilità di Azure.

4. Selezionare Rivedi e crea per rivedere le selezioni. Selezionare quindi Crea per effettuare il provisioning dell'istanza di Azure Spring Apps.

5. Sulla barra degli strumenti selezionare l'icona Notifiche a forma di campana per monitorare il processo di distribuzione. Al termine della distribuzione, è possibile selezionare Aggiungi al dashboard, che crea un riquadro per questo servizio nel dashboard portale di Azure come collegamento alla pagina Panoramica del servizio.

6. Selezionare Vai alla risorsa per aprire la pagina Panoramica del servizio.

   

Importante

Il profilo del carico di lavoro Consumo ha un modello di fatturazione con pagamento in base al consumo, senza costi di partenza. Viene addebitato il profilo del carico di lavoro dedicato in base alle risorse di cui è stato effettuato il provisioning. Per altre informazioni, vedere Profili del carico di lavoro in App Azure Container e Prezzi di Azure Spring Apps.

3.3. Preparare l'istanza di PostgreSQL

Usare la procedura seguente per creare un server Database di Azure per PostgreSQL:

1. Passare al portale di Azure e selezionare Crea una risorsa.

2. Selezionare Database>Database di Azure per PostgreSQL.

3. Selezionare l'opzione di distribuzione Server flessibile.

   

4. Compilare la scheda Informazioni di base con le informazioni seguenti:

   • Nome server: my-demo-pgsql
   • Area: Stati Uniti orientali
   • Versione di PostgreSQL: 14
   • Tipo di carico di lavoro: Sviluppo
   • Abilitare la disponibilità elevata: deselezionata
   • Metodo di autenticazione: solo autenticazione PostgreSQL
   • Nome utente amministratore: myadmin
   • Password e Conferma password: immettere una password.

5. Usare le informazioni seguenti per configurare la scheda Rete :

   • Metodo di connettività: accesso pubblico (indirizzi IP consentiti)
   • Consenti l'accesso pubblico da qualsiasi servizio di Azure in Azure a questo server: selezionato

6. Selezionare Rivedi e crea per esaminare le selezioni e selezionare Crea per effettuare il provisioning del server. L'operazione potrebbe richiedere alcuni minuti.

7. Andare al Server PostgreSQL nel portale di Azure. Nella pagina Panoramica cercare il valore Nome server e quindi registrarlo per usarlo in un secondo momento. È necessario configurare le variabili di ambiente per l'app in Azure Spring Apps.

8. Selezionare Database dal menu di spostamento per creare un database, ad esempio todo.

   

3.4. Connettere l'istanza dell'app all'istanza di PostgreSQL

Usare la procedura seguente per connettere le istanze del servizio:

1. Passare all'istanza di Azure Spring Apps nel portale di Azure.

2. Dal menu di spostamento aprire App e quindi selezionare Crea app.

3. Nella pagina Crea app compilare il nome dell'app simple-todo-api e selezionare Artefatti Java come tipo di distribuzione.

4. Selezionare Crea per completare la creazione dell'app e selezionare l'app per visualizzare i dettagli.

5. Passare all'app creata nel portale di Azure. Nella pagina Panoramica selezionare Assegna endpoint per esporre l'endpoint pubblico per l'app. Salvare l'URL per l'accesso all'app dopo la distribuzione.

6. Passare all'app creata, espandere Impostazioni e selezionare Configurazione dal menu di spostamento e quindi selezionare Variabili di ambiente per impostare le variabili di ambiente.

7. Aggiungere le variabili di ambiente seguenti per la connessione PostgreSQL e quindi selezionare Salva per completare l'aggiornamento della configurazione dell'app. Assicurarsi di sostituire i segnaposto con i propri valori creati in precedenza.

   Variabile di ambiente	Valore
   SPRING_DATASOURCE_URL	jdbc:postgresql://<your-PostgreSQL-server-name>:5432/<your-PostgreSQL-database-name>
   SPRING_DATASOURCE_USERNAME	<your-PostgreSQL-admin-user>
   SPRING_DATASOURCE_PASSWORD	<your-PostgreSQL-admin-password>

   

3.5. Esporre le API RESTful

Seguire questa procedura per esporre le API RESTful in Microsoft Entra ID:

1. Accedere al portale di Azure.

2. Se si ha accesso a più tenant, usare il filtro Directory + sottoscrizione ( ) per selezionare il tenant in cui si vuole registrare un'applicazione.

3. Cercare e selezionare Microsoft Entra ID.

4. In Gestisci selezionare Registrazioni app>Nuova registrazione.

5. Immettere un nome per l'applicazione nel campo Nome, ad esempio Todo. Tale nome, che potrebbe essere visualizzato dagli utenti dell'app, può essere modificato in un secondo momento.

6. Per Tipi di account supportati selezionare Account in qualsiasi directory organizzativa (Qualsiasi directory Microsoft Entra - Multi-tenant) e account Microsoft personali.

7. Selezionare Registra per creare l'applicazione.

8. Nella pagina Panoramica dell'app cercare il valore del campo ID applicazione (client) e prenderne nota per un uso futuro. È necessario configurare il file di configurazione YAML per questo progetto.

9. In Gestisci selezionare Esporre un'API, trovare l'URI ID applicazione all'inizio della pagina e quindi selezionare Aggiungi.

10. Nella pagina Modifica URI ID applicazione accettare l'URI ID applicazione proposto (api://{client ID}) o usare un nome significativo anziché l'ID client, ad esempio api://simple-todoe quindi selezionare Salva.

11. In Gestisci selezionare Esporre un'API>Aggiungi un ambito e quindi immettere le informazioni seguenti:

    • In Nome ambito immettere ToDo.Read.
    • Per Chi può fornire il consenso, selezionare Solo amministratori.
    • Per Nome visualizzato del consenso amministratore immettere Leggi i dati ToDo.
    • Per Descrizione del consenso amministratore immettere Consente agli utenti autenticati di leggere i dati ToDo.
    • Per Stato mantenere abilitato.
    • Seleziona Aggiungi ambito.

12. Ripetere i passaggi precedenti per aggiungere gli altri due ambiti: ToDo.Write e ToDo.Delete.

    

3.6. Aggiornare la configurazione dell'applicazione

Seguire questa procedura per aggiornare il file YAML per usare le informazioni dell'applicazione registrata di Microsoft Entra per stabilire una relazione con l'applicazione API RESTful:

1. Individuare il file src/main/resources/application.yml per l'app simple-todo-api . Aggiornare la configurazione nella spring.cloud.azure.active-directory sezione in modo che corrisponda all'esempio seguente. Assicurarsi di sostituire i segnaposto con i valori creati in precedenza.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Nota

   Nei token v1.0, la configurazione richiede l'ID client dell'API, mentre nei token v2.0 è possibile usare l'ID client o l'URI ID applicazione nella richiesta. È possibile configurare entrambi per completare correttamente la convalida del gruppo di destinatari.

   I valori consentiti per tenant-id sono: common, organizations, consumerso l'ID tenant. Per altre informazioni su questi valori, vedere la sezione Usato l'endpoint errato (account personali e dell'organizzazione) di Errore AADSTS50020 - L'account utente del provider di identità non esiste nel tenant. Per informazioni sulla conversione dell'app a tenant singolo, vedere Convertire l'app a tenant singolo in multi-tenant in Microsoft Entra ID.

2. Usare il comando seguente per ricompilare il progetto di esempio:

   ./mvnw clean package
   

Azure Developer CLI

3.1. Preparare le risorse di Azure

Per effettuare il provisioning delle risorse di Azure necessarie, seguire questa procedura:

1. Eseguire il comando seguente per accedere ad Azure con OAuth2. Ignorare questo passaggio se è già stato eseguito l'accesso.

   azd auth login
   

2. Eseguire il comando seguente per abilitare la funzionalità Azure Spring Apps:

   azd config set alpha.springapp on
   

3. Eseguire il comando seguente per creare un pacchetto di una copia distribuibile dell'applicazione, effettuare il provisioning dell'infrastruttura del modello in Azure e distribuire il codice dell'applicazione in tali risorse di cui è stato appena effettuato il provisioning:

   azd provision
   

   L'elenco seguente descrive le interazioni con i comandi:

   • Selezionare una sottoscrizione di Azure da usare: usare le frecce per spostare, digitare per filtrare e quindi premere INVIO.
   • Selezionare un percorso di Azure da usare: usare le frecce per spostare, digitare per filtrare e quindi premere INVIO.

   La console restituisce messaggi simili all'esempio seguente:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/overview
   

   Nota

   Il completamento di questo comando potrebbe richiedere alcuni minuti. Viene visualizzato un indicatore di stato durante il provisioning delle risorse di Azure.

3.2. Esporre le API RESTful

Seguire questa procedura per esporre le API RESTful in Microsoft Entra ID:

1. Accedere al portale di Azure.

2. Se si ha accesso a più tenant, usare il filtro Directory + sottoscrizione ( ) per selezionare il tenant in cui si vuole registrare un'applicazione.

3. Cercare e selezionare Microsoft Entra ID.

4. In Gestisci selezionare Registrazioni app>Nuova registrazione.

5. Immettere un nome per l'applicazione nel campo Nome, ad esempio Todo. Tale nome, che potrebbe essere visualizzato dagli utenti dell'app, può essere modificato in un secondo momento.

6. Per Tipi di account supportati selezionare Account in qualsiasi directory organizzativa (Qualsiasi directory Microsoft Entra - Multi-tenant) e account Microsoft personali.

7. Selezionare Registra per creare l'applicazione.

8. Nella pagina Panoramica dell'app cercare il valore del campo ID applicazione (client) e prenderne nota per un uso futuro. È necessario configurare il file di configurazione YAML per questo progetto.

9. In Gestisci selezionare Esporre un'API, trovare l'URI ID applicazione all'inizio della pagina e quindi selezionare Aggiungi.

10. Nella pagina Modifica URI ID applicazione accettare l'URI ID applicazione proposto (api://{client ID}) o usare un nome significativo anziché l'ID client, ad esempio api://simple-todoe quindi selezionare Salva.

11. In Gestisci selezionare Esporre un'API>Aggiungi un ambito e quindi immettere le informazioni seguenti:

    • In Nome ambito immettere ToDo.Read.
    • Per Chi può fornire il consenso, selezionare Solo amministratori.
    • Per Nome visualizzato del consenso amministratore immettere Leggi i dati ToDo.
    • Per Descrizione del consenso amministratore immettere Consente agli utenti autenticati di leggere i dati ToDo.
    • Per Stato mantenere abilitato.
    • Seleziona Aggiungi ambito.

12. Ripetere i passaggi precedenti per aggiungere gli altri due ambiti: ToDo.Write e ToDo.Delete.

    

3.3. Aggiornare la configurazione dell'applicazione

Seguire questa procedura per aggiornare il file YAML per usare le informazioni dell'applicazione registrata di Microsoft Entra per stabilire una relazione con l'applicazione API RESTful:

1. Individuare il file src/main/resources/application.yml per l'app simple-todo-api . Aggiornare la configurazione nella spring.cloud.azure.active-directory sezione in modo che corrisponda all'esempio seguente. Assicurarsi di sostituire i segnaposto con i valori creati in precedenza.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   Nota

   Nei token v1.0, la configurazione richiede l'ID client dell'API, mentre nei token v2.0 è possibile usare l'ID client o l'URI ID applicazione nella richiesta. È possibile configurare entrambi per completare correttamente la convalida del gruppo di destinatari.

   I valori consentiti per tenant-id sono: common, organizations, consumerso l'ID tenant. Per altre informazioni su questi valori, vedere la sezione Usato l'endpoint errato (account personali e dell'organizzazione) di Errore AADSTS50020 - L'account utente del provider di identità non esiste nel tenant. Per informazioni sulla conversione dell'app a tenant singolo, vedere Convertire l'app a tenant singolo in multi-tenant in Microsoft Entra ID.

2. Usare il comando seguente per ricompilare il progetto di esempio:

   ./mvnw clean package
   

4. Distribuire l'app in Azure Spring Apps

È ora possibile distribuire l'app in App Spring di Azure.

plug-in portale di Azure + Maven

Usare la procedura seguente per distribuire usando il plug-in Maven per Azure Spring Apps:

1. Passare alla directory completa e quindi eseguire il comando seguente per configurare l'app in Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   L'elenco seguente descrive le interazioni con i comandi:

   • Accesso OAuth2: è necessario autorizzare l'accesso ad Azure in base al protocollo OAuth2.
   • Selezionare la sottoscrizione: selezionare il numero di elenco di sottoscrizioni dell'istanza di Azure Spring Apps creata, che per impostazione predefinita corrisponde alla prima sottoscrizione nell'elenco. Se si usa il numero predefinito, premere INVIO direttamente.
   • Usare le app Spring di Azure esistenti in Azure: premere y per usare l'istanza di Azure Spring Apps esistente.
   • Selezionare App Spring di Azure per la distribuzione: selezionare il numero dell'istanza di Azure Spring Apps creata. Se si usa il numero predefinito, premere INVIO direttamente.
   • Usare l'app esistente in Azure Spring Apps <nome-istanza>: premere y per usare l'app creata.
   • Confermare di salvare tutte le configurazioni precedenti: premere y. Se si preme n, la configurazione non viene salvata nei file POM.

2. Usare il comando seguente per distribuire l'app:

   ./mvnw azure-spring-apps:deploy
   

   L'elenco seguente descrive l'interazione con il comando:

   • Accesso OAuth2: è necessario autorizzare l'accesso ad Azure in base al protocollo OAuth2.

   Dopo l'esecuzione del comando, è possibile visualizzare i messaggi di log seguenti che la distribuzione ha avuto esito positivo:

[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io

Azure Developer CLI

Usare la procedura seguente per creare un pacchetto dell'app, effettuare il provisioning delle risorse di Azure richieste dall'applicazione Web e quindi eseguire la distribuzione in Azure Spring Apps.

1. Eseguire il comando seguente per creare un pacchetto di una copia distribuibile dell'applicazione:

   azd package
   

2. Eseguire il comando seguente per distribuire il codice dell'applicazione alle risorse di cui è stato appena effettuato il provisioning:

   azd deploy
   

   La console restituisce messaggi simili all'esempio seguente:

   Deploying services (azd deploy)
   
   WARNING: Feature 'springapp' is in alpha stage.
   To learn more about alpha features and their support, visit https://aka.ms/azd-feature-stages.
   
   ...
   
   Deploying service simple-todo-api (Fetching endpoints for spring app service)
   - Endpoint: https://simple-todo-api.xxxxxxxx-xxxxxxxx.xxxxxx.azurecontainerapps.io
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   L'endpoint di output è l'endpoint di base per accedere all'applicazione API ToDo.

Nota

È anche possibile usare azd up per combinare i tre comandi precedenti: azd provision (effettua il provisioning delle risorse di Azure), azd package (crea un pacchetto di una copia distribuibile dell'applicazione) e azd deploy (distribuisce il codice dell'applicazione). Per altre informazioni, vedere Azure-Samples/ASA-Samples-Restful-Application.

5. Convalidare l'app

È ora possibile accedere all'API RESTful per verificare se funziona.

5.1. Richiedere un token di accesso

Le API RESTful fungono da server di risorse, protetto dall'ID Microsoft Entra. Prima di acquisire un token di accesso, è necessario registrare un'altra applicazione in Microsoft Entra ID e concedere le autorizzazioni all'applicazione client, denominata ToDoWeb.

Registrare l'applicazione client

Seguire questa procedura per registrare un'applicazione in Microsoft Entra ID, che viene usata per aggiungere le autorizzazioni per l'app ToDo :

1. Accedere al portale di Azure.

2. Se si ha accesso a più tenant, usare il filtro Directory + sottoscrizione ( ) per selezionare il tenant in cui si vuole registrare un'applicazione.

3. Cercare e selezionare Microsoft Entra ID.

4. In Gestisci selezionare Registrazioni app>Nuova registrazione.

5. Immettere un nome per l'applicazione nel campo Nome, ad esempio ToDoWeb. Tale nome, che potrebbe essere visualizzato dagli utenti dell'app, può essere modificato in un secondo momento.

6. Per Tipi di account supportati, usare solo il valore predefinito Account in questa directory organizzativa.

7. Selezionare Registra per creare l'applicazione.

8. Nella pagina Panoramica dell'app cercare il valore del campo ID applicazione (client) e prenderne nota per un uso futuro. È necessario per acquisire un token di accesso.

9. Selezionare Autorizzazioni API>Aggiungi un'autorizzazione>Le mie API. Selezionare l'applicazione ToDo registrata in precedenza e quindi selezionare le autorizzazioni ToDo.Read, ToDo.Write e ToDo.Delete . Selezionare Aggiungi autorizzazioni.

10. Selezionare Concedi consenso amministratore per <your-tenant-name> per concedere il consenso amministratore per le autorizzazioni aggiunte.

    

Aggiungere un utente per accedere alle API RESTful

Usare la procedura seguente per creare un utente membro nel tenant di Microsoft Entra. L'utente può quindi gestire i dati dell'applicazione ToDo tramite le API RESTful.

1. In Gestisci selezionare Utenti>Nuovo utente>Crea nuovo utente.

2. Nella pagina Crea nuovo utente immettere le informazioni seguenti:

   • Nome entità utente: immettere un nome per l'utente.
   • Nome visualizzato: immettere un nome visualizzato per l'utente.
   • Password: copiare la password generata automaticamente nella casella Password .

   Nota

   I nuovi utenti devono completare la prima autenticazione di accesso e aggiornare le password. In caso contrario, viene visualizzato un AADSTS50055: The password is expired errore quando si ottiene il token di accesso.

   Quando un nuovo utente accede, riceve una richiesta di azione richiesta . Possono scegliere Chiedi in un secondo momento per ignorare la convalida.

3. Selezionare Revisione e creazione per rivedere le selezioni effettuate. Selezionare Crea per creare l'utente.

Aggiornare la configurazione di OAuth2 per l'autorizzazione dell'interfaccia utente di Swagger

Seguire questa procedura per aggiornare la configurazione di OAuth2 per l'autorizzazione dell'interfaccia utente di Swagger. È quindi possibile autorizzare gli utenti ad acquisire i token di accesso tramite l'app ToDoWeb .

1. Aprire il tenant di Microsoft Entra ID nella portale di Azure e passare all'app registrataToDoWeb.

2. In Gestisci selezionare Autenticazione, selezionare Aggiungi una piattaforma e quindi selezionare Applicazione a pagina singola.

3. Usare il formato <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html come URL di reindirizzamento OAuth2 nel campo URI di reindirizzamento e quindi selezionare Configura.

   

Ottenere il token di accesso

Usare la procedura seguente per usare il metodo del flusso del codice di autorizzazione OAuth 2.0 per ottenere un token di accesso con Microsoft Entra ID, quindi accedere alle API RESTful dell'app ToDo :

1. Aprire l'URL esposto dall'app e quindi selezionare Autorizza per preparare l'autenticazione OAuth2.

2. Nella finestra Autorizzazioni disponibili immettere l'ID client dell'app ToDoWeb nel campo client_id, selezionare tutti gli ambiti per Ambiti campo, ignorare il campo client_secret e quindi selezionare Autorizza per reindirizzare alla pagina di accesso di Microsoft Entra.

Dopo aver completato l'accesso con l'utente precedente, si torna alla finestra Autorizzazioni disponibili.

5.2. Accedere alle API RESTful

Usare la procedura seguente per accedere alle API RESTful dell'app ToDo nell'interfaccia utente di Swagger:

1. Selezionare l'API POST /api/simple-todo/lists e quindi selezionare Prova. Immettere il corpo della richiesta seguente e quindi selezionare Esegui per creare un elenco ToDo.

   {
     "name": "My List"
   }
   

   Al termine dell'esecuzione, viene visualizzato il corpo della risposta seguente:

   {
     "id": "<ID-of-the-ToDo-list>",
     "name": "My List",
     "description": null
   }
   

2. Selezionare l'API POST /api/simple-todo/lists/{listId}/items e quindi selezionare Prova. Per listId immettere l'ID elenco ToDo creato in precedenza, immettere il corpo della richiesta seguente e quindi selezionare Esegui per creare un elemento ToDo.

   {
     "name": "My first ToDo item", 
     "listId": "<ID-of-the-ToDo-list>",
     "state": "todo"
   }
   

   Questa azione restituisce l'elemento ToDo seguente:

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": null,
     "state": "todo",
     "dueDate": "2023-07-11T13:59:24.9033069+08:00",
     "completedDate": null
   }
   

3. Selezionare l'API GET /api/simple-todo/lists e quindi selezionare Esegui per eseguire query negli elenchi ToDo. Questa azione restituisce gli elenchi ToDo seguenti:

   [
     {
       "id": "<ID-of-the-ToDo-list>",
       "name": "My List",
       "description": null
     }
   ]
   

4. Selezionare l'API GET /api/simple-todo/lists/{listId}/items e quindi selezionare Prova. Per listId immettere l'ID elenco ToDo creato in precedenza e quindi selezionare Esegui per eseguire una query sugli elementi ToDo. Questa azione restituisce l'elemento ToDo seguente:

   [
     {
       "id": "<ID-of-the-ToDo-item>",
       "listId": "<ID-of-the-ToDo-list>",
       "name": "My first ToDo item",
       "description": null,
       "state": "todo",
       "dueDate": "2023-07-11T13:59:24.903307+08:00",
       "completedDate": null
     }
   ]
   

5. Selezionare l'API PUT /api/simple-todo/lists/{listId}/items/{itemId} e quindi selezionare Prova. Per listId immettere l'ID elenco ToDo. Per itemId immettere l'ID elemento ToDo, immettere il corpo della richiesta seguente e quindi selezionare Esegui per aggiornare l'elemento ToDo.

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": "Updated description.",
     "dueDate": "2023-07-11T13:59:24.903307+08:00",
     "state": "inprogress"
   }
   

   Questa azione restituisce l'elemento ToDo aggiornato seguente:

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": "Updated description.",
     "state": "inprogress",
     "dueDate": "2023-07-11T05:59:24.903307Z",
     "completedDate": null
   }
   

6. Selezionare l'API DELETE /api/simple-todo/lists/{listId}/items/{itemId} e quindi selezionare Prova. Per listId immettere l'ID elenco ToDo. Per itemId immettere l'ID elemento ToDo e quindi selezionare Esegui per eliminare l'elemento ToDo. Si noterà che il codice di risposta del server è 204.

6. Pulire le risorse

È possibile eliminare il gruppo di risorse di Azure, che include tutte le risorse del gruppo.

plug-in portale di Azure + Maven

Per eliminare l'intero gruppo di risorse, incluso il server appena creato, seguire questa procedura:

1. Individuare il gruppo di risorse nel portale di Azure.

2. Nel menu di spostamento selezionare Gruppi di risorse. Selezionare quindi il nome del gruppo di risorse, ad esempio myresourcegroup.

3. Nella pagina del gruppo di risorse selezionare Elimina. Nella casella di testo immettere il nome del gruppo di risorse, in questo esempio myresourcegroup, per confermare l'eliminazione. Quindi, selezionare Elimina.

Interfaccia della riga di comando di Azure

Usare il comando seguente per eliminare l'intero gruppo di risorse, incluso il servizio appena creato:

az group delete --name ${RESOURCE_GROUP}

plug-in portale di Azure + Maven

Per eliminare l'intero gruppo di risorse, incluso il server appena creato, seguire questa procedura:

1. Individuare il gruppo di risorse nel portale di Azure.

2. Nel menu di spostamento selezionare Gruppi di risorse. Selezionare quindi il nome del gruppo di risorse, ad esempio myresourcegroup.

3. Nella pagina del gruppo di risorse selezionare Elimina. Nella casella di testo immettere il nome del gruppo di risorse, in questo esempio myresourcegroup, per confermare l'eliminazione. Quindi, selezionare Elimina.

Azure Developer CLI

Usare il comando seguente per eliminare tutte le risorse di Azure usate in questa applicazione di esempio:

azd down

L'elenco seguente descrive l'interazione con il comando:

• Totale risorse da eliminare: [your-resources-total], continuare?: premere y.

La console restituisce messaggi simili all'esempio seguente:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

7. Passaggi successivi

Guida introduttiva: Distribuire un'applicazione guidata dagli eventi in Azure Spring Apps

Guida introduttiva: Distribuire applicazioni di microservizi in App Azure Spring

Log applicazioni strutturato per Azure Spring Apps

Eseguire il mapping di un dominio personalizzato esistente ad Azure Spring Apps

Usare CI/CD di Azure Spring Apps con GitHub Actions

Automatizzare le distribuzioni di applicazioni in Azure Spring Apps

Per altre informazioni, vedere gli articoli seguenti:

• Esempi di App Spring di Azure.
• Spring in Azure
• Spring Cloud Azure