Snelstart: Een RESTful API-toepassing naar Azure Spring Apps implementeren

• Een Azure-abonnement. Als u geen Azure-abonnement hebt, maakt u een gratis Azure-account voordat u begint.

• Een van de volgende rollen:

  • Globale beheerder of beheerder met bevoorrechte rol, voor het verlenen van toestemming voor apps die een machtiging aanvragen voor elke API.
  • Cloudtoepassingsbeheerder of toepassingsbeheerder, voor het verlenen van toestemming voor apps die toestemming vragen voor elke API, met uitzondering van Microsoft Graph-app-rollen (toepassingsmachtigingen).
  • Een aangepaste maprol die de machtiging bevat voor het verlenen van machtigingen aan toepassingen, voor de machtigingen die vereist zijn voor de toepassing.

  Zie voor meer informatie Beheerderstoestemming voor de hele tenant verlenen aan een toepassing.

• Git.

• Java Development Kit (JDK), versie 17.

• Een Microsoft Entra-tenant. Zie quickstart: Een nieuwe tenant maken in Microsoft Entra-id voor instructies voor het maken van een tenant.

• Als u nog geen Azure-abonnement hebt, maakt u een gratis Azure-account voordat u begint.

• Een van de volgende rollen:

  • Globale beheerder of beheerder met bevoorrechte rol, voor het verlenen van toestemming voor apps die een machtiging aanvragen voor elke API.
  • Cloudtoepassingsbeheerder of toepassingsbeheerder, voor het verlenen van toestemming voor apps die toestemming vragen voor elke API, met uitzondering van Microsoft Graph-app-rollen (toepassingsmachtigingen).
  • Een aangepaste maprol die de machtiging bevat voor het verlenen van machtigingen aan toepassingen, voor de machtigingen die vereist zijn voor de toepassing.

  Zie voor meer informatie Beheerderstoestemming voor de hele tenant verlenen aan een toepassing.

• Git.

• Java Development Kit (JDK), versie 17.

• Een Microsoft Entra-tenant. Zie quickstart: Een nieuwe tenant maken in Microsoft Entra-id voor instructies voor het maken van een tenant.

• Azure CLI versie 2.53.1 of hoger.

3.1. Meld u aan bij het Azure Portal

Ga naar Azure Portal en voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.

3.2. Een Azure Spring Apps-exemplaar maken

Gebruik de volgende stappen om een Azure Spring Apps-service-exemplaar te maken:

1. Selecteer Resource maken in de hoek van de Azure-portal.

2. Klik op Compute>Azure Spring Apps.

3. Vul het formulier Basisbeginselen in met de volgende gegevens:

   Setting	Voorgestelde waarde	Description
   Subscription	De naam van uw abonnement.	Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
   Resourcegroep	myresourcegroup	Een nieuwe naam voor een resourcegroep of een bestaande naam uit uw abonnement.
   Name	myasa	Een unieke naam die uw Azure Spring Apps-service identificeert. De naam moet tussen 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
   Plan	Enterprise	Het prijsplan dat de resource en kosten bepaalt die zijn gekoppeld aan uw instantie.
   Region	De regio die zich het dichtst bij uw gebruikers bevindt.	De locatie die zich het dichtst bij uw gebruikers bevindt.
   Zoneredundant	Unselected	De optie voor het maken van uw Azure Spring Apps-service in een Azure-beschikbaarheidszone. Deze functie wordt momenteel niet ondersteund in alle regio's.
   Software-IP-plan	Pay-as-You-Go	Het prijsplan waarmee u per gebruik kunt betalen met Azure Spring Apps.
   Terms	Selected	Het selectievakje voor overeenkomst dat is gekoppeld aan de Marketplace-aanbieding. U moet dit selectievakje inschakelen.
   Voorbeeldproject implementeren	Unselected	De optie voor het gebruik van de ingebouwde voorbeeldtoepassing.

4. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Create om vervolgens het Azure Spring Apps-exemplaar in te richten.

5. Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee wordt er een tegel voor deze service op uw Azure Portal-dashboard aangemaakt, als snelkoppeling naar de overzichtspagina van de service.

   

6. Selecteer Ga naar de resource om naar de overzichtspagina van Azure Spring Apps te gaan.

3.3. Het PostgreSQL-exemplaar voorbereiden

Gebruik de volgende stappen om een Azure Database for PostgreSQL-server te maken:

1. Ga naar Azure Portal en selecteer Een resource maken.

2. Selecteer Databases>Azure Database for PostgreSQL.

3. Selecteer de optie Flexibele serverimplementatie.

   

4. Vul het tabblad Basisbeginselen in met de volgende informatie:

   • Servernaam: my-demo-pgsql
   • Regio: VS - oost
   • PostgreSQL-versie: 14
   • Workloadtype: Ontwikkeling
   • Hoge beschikbaarheid inschakelen: niet geselecteerd
   • Verificatiemethode: alleen PostgreSQL-verificatie
   • Gebruikersnaam van beheerder: myadmin
   • Wachtwoord en wachtwoord bevestigen: voer een wachtwoord in.

5. Gebruik de volgende informatie om het tabblad Netwerken te configureren:

   • Connectiviteitsmethode: Openbare toegang (toegestane IP-adressen)
   • Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd

6. Selecteer Beoordelen en maken om uw selecties te controleren en selecteer Maken om de server in te richten. Deze bewerking kan enkele minuten duren.

7. Ga in het Azure Portal naar uw PostgreSQL-server. Zoek op de pagina Overzicht naar de servernaamwaarde en noteer deze voor later gebruik. U hebt deze nodig om de omgevingsvariabelen voor de app in Azure Spring Apps te configureren.

8. Selecteer Databases in het navigatiemenu om een database te maken, bijvoorbeeld taken.

   

3.4. App-exemplaar verbinden met PostgreSQL-exemplaar

Gebruik de volgende stappen om verbinding te maken met uw service-instanties:

1. Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.

2. Open Apps in het navigatiemenu en selecteer App maken.

3. Vul op de pagina App maken de naam simple-todo-api van de app in en selecteer vervolgens Java-artefacten als het implementatietype.

4. Selecteer Maken om het maken van de app te voltooien en selecteer vervolgens de app om de details weer te geven.

5. Ga naar de app die u hebt gemaakt in Azure Portal. Selecteer op de pagina Overzichthet eindpunt toewijzen om het openbare eindpunt voor de app beschikbaar te maken. Sla de URL op voor toegang tot de app na de implementatie.

6. Selecteer Serviceconnector in het navigatiedeelvenster en selecteer vervolgens Maken om een nieuwe serviceverbinding te maken.

   

7. Vul het tabblad Basisbeginselen in met de volgende informatie:

   • Servicetype: flexibele DB for PostgreSQL-server
   • Verbindingsnaam: er wordt een automatisch gegenereerde naam ingevuld, die ook kan worden gewijzigd.
   • Abonnement: selecteer uw abonnement.
   • Flexibele PostgreSQL-server: my-demo-pgsql
   • PostgreSQL-database: selecteer de database die u hebt gemaakt.
   • Clienttype: SpringBoot

   

8. Configureer het tabblad Volgende: Verificatie met de volgende informatie:

   Note

   Microsoft raadt aan de veiligste verificatiestroom te gebruiken die beschikbaar is. De verificatiestroom die in deze procedure wordt beschreven, zoals voor databases, caches, berichten of AI-services, vereist een zeer hoge mate van vertrouwen in de toepassing en brengt risico's met zich mee die niet aanwezig zijn in andere stromen. Gebruik deze stroom alleen wanneer veiligere opties, zoals beheerde identiteiten voor wachtwoordloze of sleutelloze verbindingen, niet haalbaar zijn. Voor bewerkingen van lokale machines geeft u de voorkeur aan gebruikersidentiteiten voor verbindingen zonder wachtwoord of sleutelloze verbindingen.

   • Selecteer het verificatietype dat u wilt gebruiken tussen uw rekenservice en doelservice.: Selecteer verbindingsreeks.
   • Doorgaan met...: Databasereferenties selecteren
   • Gebruikersnaam: myadmin
   • Wachtwoord: voer uw wachtwoord in.

   

9. Selecteer Volgende: Netwerkverbinding. Gebruik de standaardoptie Firewallregels configureren om toegang tot de doelservice in te schakelen.

10. Selecteer Volgende: Controleren en Maken om uw selecties te controleren en selecteer vervolgens Maken om de verbinding te maken.

3.5. RESTful-API's beschikbaar maken

Gebruik de volgende stappen om uw RESTful-API's beschikbaar te maken in Microsoft Entra-id:

1. Meld u aan bij het Azure-portaal.

2. Als u toegang hebt tot meerdere tenants, gebruikt u het filter Directory + abonnement ( ) om de tenant te selecteren waarin u een toepassing wilt registreren.

3. Zoek en selecteer Microsoft Entra-id.

4. Selecteer onder Beherende optie App-registraties>Nieuwe registratie.

5. Voer een naam in voor uw toepassing in het veld Naam , bijvoorbeeld Todo. Gebruikers van uw app zien deze naam mogelijk en u kunt deze later wijzigen.

6. Voor ondersteunde accounttypen selecteert u Accounts in een organisatiemap (Elke Microsoft Entra-directory - Multitenant) en persoonlijke Microsoft-accounts.

7. Selecteer Registreren om de toepassing te maken.

8. Zoek de waarde Toepassings-id (client) op de app-pagina Overzicht en noteer deze voor gebruik later. U hebt het nodig om het YAML-configuratiebestand voor dit project te configureren.

9. Onder Beheer selecteer Een API beschikbaar maken, zoek de Toepassings-ID URI aan het begin van de pagina en selecteer vervolgens Toevoegen.

10. Op de pagina Bewerken toepassings-ID URI, accepteer de voorgestelde URI voor de toepassings-ID (api://{client ID}) of gebruik een betekenisvolle naam in plaats van de client-ID, zoals api://simple-todo, en selecteer vervolgens Opslaan.

11. Selecteer onder Behereneen API blootstellen>een scope toevoegen en voer vervolgens de volgende gegevens in:

    • Voer ToDo.Read in als bereiknaam.
    • Voor wie kan toestemmen, selecteert u alleen beheerders.
    • Voer voor beheerderstoestemming-weergavenaamLees de ToDo-gegevens in.
    • Voer voor de beschrijving van beheerderstoestemmingin: staat geverifieerde gebruikers toe om de ToDo-gegevens te lezen.
    • Houd deze ingeschakeld voor State.
    • Selecteer Voeg bereik toe.

12. Herhaal de vorige stappen om de andere twee bereiken toe te voegen: ToDo.Write en ToDo.Delete.

    

3.6. De toepassingsconfiguratie bijwerken

Gebruik de volgende stappen om het YAML-bestand bij te werken om uw geregistreerde Microsoft Entra-toepassingsgegevens te gebruiken om een relatie tot stand te brengen met de RESTful API-toepassing:

1. Zoek het bestand src/main/resources/application.yml voor de simple-todo-api app. Werk de configuratie in de spring.cloud.azure.active-directory sectie bij zodat deze overeenkomt met het volgende voorbeeld. Vervang de tijdelijke aanduidingen door de waarden die u eerder hebt gemaakt.

   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>
   

   Note

   In v1.0-tokens is voor de configuratie de client-id van de API vereist, terwijl u in v2.0-tokens de client-id of de URI van de toepassings-id in de aanvraag kunt gebruiken. U kunt beide configureren om de validatie van de doelgroep correct te voltooien.

   De waarden die zijn toegestaan voor tenant-id zijn: common, organizations, consumersof de tenant-id. Zie voor meer informatie over deze waarden de sectie Verkeerd eindpunt gebruikt (persoonlijke en organisatieaccounts) van Fout AADSTS50020 - Gebruikersaccount van identiteitsprovider bestaat niet in tenant. Zie App met één tenant converteren naar multitenant op Microsoft Entra IDvoor meer informatie over het converteren van uw app met één tenant.

2. Gebruik de volgende opdracht om het voorbeeldproject opnieuw te bouwen:

   ./mvnw clean package
   

3.1. Namen opgeven voor elke resource

Maak variabelen voor het opslaan van de resourcenamen met behulp van de volgende opdrachten. Vervang de tijdelijke aanduidingen door uw eigen waarden.

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. Een nieuwe resourcegroep maken

Gebruik de volgende stappen om een nieuwe resourcegroep te maken:

1. Gebruik de volgende opdracht om u aan te melden bij de Azure CLI:

   az login
   

2. Gebruik de volgende opdracht om de standaardlocatie in te stellen:

   az configure --defaults location=${LOCATION}
   

3. Gebruik de volgende opdracht om alle beschikbare abonnementen weer te geven om de abonnements-id te bepalen die u wilt gebruiken:

   az account list --output table
   

4. Gebruik de volgende opdracht om het standaardabonnement in te stellen:

   az account set --subscription <subscription-ID>
   

5. Gebruik de volgende opdracht om een resourcegroep te maken:

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

6. Gebruik de volgende opdracht om de zojuist gemaakte resourcegroep in te stellen als de standaardresourcegroep:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Extensie installeren en naamruimte registreren

Gebruik de volgende opdrachten om de Azure Spring Apps-extensie voor de Azure CLI te installeren en de Microsoft.SaaS naamruimte te registreren:

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

3.4. Een Azure Spring Apps-exemplaar maken

Gebruik de volgende stappen om een service-exemplaar en een toepassing in het exemplaar te maken:

1. Gebruik de volgende opdracht om de juridische voorwaarden en privacyverklaringen voor het Enterprise-abonnement te accepteren:

   Note

   Deze stap is alleen nodig als uw abonnement nog nooit is gebruikt om een Enterprise-planinstance van Azure Spring Apps aan te maken.

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

2. Gebruik de volgende opdracht om een Azure Spring Apps-service-exemplaar te maken:

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

3. Gebruik de volgende opdracht om een toepassing te maken in het Azure Spring Apps-exemplaar:

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

3.5. Het PostgreSQL-exemplaar voorbereiden

De Spring-web-app maakt gebruik van H2 voor de database in localhost en Azure Database for PostgreSQL voor de database in Azure.

Gebruik de volgende opdracht om een PostgreSQL-exemplaar te maken:

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

0.0.0.0 Als u opgeeft, hebt u openbare toegang vanaf alle resources die in Azure zijn geïmplementeerd om toegang te krijgen tot uw server.

3.6. App-exemplaar verbinden met PostgreSQL-exemplaar

Nadat het toepassingsexemplaren en het PostgreSQL-exemplaar zijn gemaakt, heeft het toepassingsexemplaren geen rechtstreeks toegang tot het PostgreSQL-exemplaar. Gebruik de volgende stappen om de app in staat te stellen verbinding te maken met het PostgreSQL-exemplaar:

1. Gebruik de volgende opdracht om de fully qualified domain name van het PostgreSQL-exemplaar op te halen:

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

2. Gebruik de volgende opdracht om de spring.datasource. eigenschappen voor de app op te geven via omgevingsvariabelen:

   Note

   Microsoft raadt aan de veiligste verificatiestroom te gebruiken die beschikbaar is. De verificatiestroom die in deze procedure wordt beschreven, zoals voor databases, caches, berichten of AI-services, vereist een zeer hoge mate van vertrouwen in de toepassing en brengt risico's met zich mee die niet aanwezig zijn in andere stromen. Gebruik deze stroom alleen wanneer veiligere opties, zoals beheerde identiteiten voor wachtwoordloze of sleutelloze verbindingen, niet haalbaar zijn. Voor bewerkingen van lokale machines geeft u de voorkeur aan gebruikersidentiteiten voor verbindingen zonder wachtwoord of sleutelloze verbindingen.

   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. RESTful-API's beschikbaar maken

Gebruik de volgende stappen om de RESTful-API's beschikbaar te maken:

1. Gebruik de volgende opdracht om een Microsoft Entra ID-toepassing te maken:

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

2. Gebruik de volgende opdracht om een service-principal te maken voor de toepassing:

   az ad sp create --id ${TODO_APP_URL}
   

3. Gebruik de volgende opdracht om machtigings-id's te genereren:

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

4. Voeg de volgende bereiken toe als 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. Gebruik het volgende commando om scopes toe te voegen:

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

6. Gebruik de volgende opdracht om de tenant-id op te halen die u in de volgende stap wilt gebruiken:

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

7. Gebruik de volgende opdracht om de toepassings-id op te halen die u in de volgende stappen wilt gebruiken:

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

3.8. De toepassingsconfiguratie bijwerken

Gebruik de volgende stappen om het YAML-bestand bij te werken om uw geregistreerde Microsoft Entra-toepassingsgegevens te gebruiken om een relatie tot stand te brengen met de RESTful API-toepassing:

1. Zoek het bestand src/main/resources/application.yml voor de simple-todo-api app. Werk de configuratie in de spring.cloud.azure.active-directory sectie bij zodat deze overeenkomt met het volgende voorbeeld. Vervang de tijdelijke aanduidingen door de waarden die u eerder hebt gemaakt.

   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>
   

   Note

   In v1.0-tokens is voor de configuratie de client-id van de API vereist, terwijl u in v2.0-tokens de client-id of de URI van de toepassings-id in de aanvraag kunt gebruiken. U kunt beide configureren om de validatie van de doelgroep correct te voltooien.

   De waarden die zijn toegestaan voor tenant-id zijn: common, organizations, consumersof de tenant-id. Zie voor meer informatie over deze waarden de sectie Verkeerd eindpunt gebruikt (persoonlijke en organisatieaccounts) van Fout AADSTS50020 - Gebruikersaccount van identiteitsprovider bestaat niet in tenant. Zie App met één tenant converteren naar multitenant op Microsoft Entra IDvoor meer informatie over het converteren van uw app met één tenant.

2. Gebruik de volgende opdracht om het voorbeeldproject opnieuw te bouwen:

   ./mvnw clean package
   

U kunt de app nu implementeren in Azure Spring Apps.

Gebruik de volgende stappen om te implementeren met behulp van de Maven-invoegtoepassing voor Azure Spring Apps:

1. Navigeer naar de volledige map en voer vervolgens de volgende opdracht uit om de app te configureren in Azure Spring Apps:

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

   In de volgende lijst worden de opdrachteninteracties beschreven:

   • OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
   • Abonnement selecteren: selecteer het abonnementslijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Dit is standaard het eerste abonnement in de lijst. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
   • Gebruik bestaande Azure Spring Apps in Azure: Druk op y om het bestaande Azure Spring Apps-exemplaar te gebruiken.
   • Selecteer Azure Spring Apps voor implementatie: selecteer het aantal Azure Spring Apps-exemplaren dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
   • Gebruik de bestaande app in Azure Spring Apps <uw exemplaarnaam>: Druk op y om de gemaakte app te gebruiken.
   • Bevestig dat u alle bovenstaande configuraties wilt opslaan: Druk op y. Als u op n drukt, wordt de configuratie niet opgeslagen in de POM-bestanden.

2. Gebruik de volgende opdracht om de app te implementeren:

   ./mvnw azure-spring-apps:deploy
   

   In de volgende lijst wordt de interactie met de opdracht beschreven:

   • OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.

   Nadat de opdracht is uitgevoerd, ziet u in de volgende logboekberichten dat de implementatie is geslaagd:

[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

Gebruik de volgende opdracht om de app te implementeren op basis van broncode:

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

U hebt nu toegang tot de RESTful-API om te zien of deze werkt.

5.1. Een toegangstoken aanvragen

De RESTful-API's fungeren als een resourceserver, die wordt beveiligd door Microsoft Entra-id. Voordat u een toegangstoken verkrijgt, moet u een andere toepassing registreren in De Microsoft Entra-id en machtigingen verlenen aan de clienttoepassing, die de naam ToDoWebheeft.

De clienttoepassing registreren

Gebruik de volgende stappen om een toepassing te registreren in Microsoft Entra ID, die wordt gebruikt om de machtigingen voor de ToDo app toe te voegen:

1. Meld u aan bij het Azure-portaal.

2. Als u toegang hebt tot meerdere tenants, gebruikt u het filter Directory + abonnement ( ) om de tenant te selecteren waarin u een toepassing wilt registreren.

3. Zoek en selecteer Microsoft Entra-id.

4. Selecteer onder Beherende optie App-registraties>Nieuwe registratie.

5. Voer een naam in voor uw toepassing in het veld Naam , bijvoorbeeld ToDoWeb. Gebruikers van uw app zien deze naam mogelijk en u kunt deze later wijzigen.

6. Gebruik voor ondersteunde accounttypenalleen de standaardwaardeAccounts in deze organisatiemap.

7. Selecteer Registreren om de toepassing te maken.

8. Zoek de waarde Toepassings-id (client) op de app-pagina Overzicht en noteer deze voor gebruik later. U hebt het nodig om een toegangstoken te verkrijgen.

9. Selecteer API-machtigingen>Toevoegen een machtiging>Mijn API's. Selecteer de ToDo toepassing die u eerder hebt geregistreerd en selecteer vervolgens de machtigingen ToDo.Read, ToDo.Write en ToDo.Delete . Selecteer Machtigingen toevoegen.

10. Selecteer Beheerderstoestemming verlenen voor <de naam> van uw tenant om beheerderstoestemming te verlenen voor de machtigingen die u hebt toegevoegd.

    

Gebruiker toevoegen voor toegang tot de RESTful-API's

Gebruik de volgende stappen om een lidgebruiker te maken in uw Microsoft Entra-tenant. Vervolgens kan de gebruiker de gegevens van de ToDo toepassing beheren via RESTful-API's.

1. Onder Beheren, selecteer Gebruikers>Nieuwe gebruiker>Nieuwe gebruiker maken.

2. Voer op de pagina Nieuwe gebruiker maken de volgende gegevens in:

   • User principal name: Voer een naam in voor de gebruiker.
   • Weergavenaam: Voer een weergavenaam in voor de gebruiker.
   • Wachtwoord: Kopieer het automatisch gegenereerde wachtwoord in het vak Wachtwoord .

   Note

   Nieuwe gebruikers moeten de eerste aanmeldingsverificatie voltooien en hun wachtwoorden bijwerken, anders krijgt u een AADSTS50055: The password is expired foutmelding wanneer u het toegangstoken krijgt.

   Wanneer een nieuwe gebruiker zich aanmeldt, ontvangt deze een actie vereist prompt. Ze kunnen Vragen later kiezen om de validatie over te slaan.

3. Selecteer Beoordelen en maken om uw selecties te controleren. Selecteer Maken om de gebruiker te maken.

De OAuth2-configuratie voor Swagger UI-autorisatie bijwerken

Gebruik de volgende stappen om de OAuth2-configuratie voor Swagger UI-autorisatie bij te werken. Vervolgens kunt u gebruikers machtigen om toegangstokens te verkrijgen via de ToDoWeb app.

1. Open uw Microsoft Entra ID-tenant in Azure Portal en ga naar de geregistreerde ToDoWeb app.

2. Selecteer verificatie onder Beheren, selecteer Een platform toevoegen en selecteer vervolgens toepassing met één pagina.

3. Gebruik de indeling <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html als de OAuth2-omleidings-URL in het veld Omleidings-URI's en selecteer vervolgens Configureren.

   

U hebt nu toegang tot de RESTful-API om te zien of deze werkt.

5.1. Een toegangstoken aanvragen

De RESTful-API's fungeren als een resourceserver, die wordt beveiligd door Microsoft Entra-id. Voordat u een toegangstoken verkrijgt, moet u een andere toepassing registreren in De Microsoft Entra-id en machtigingen verlenen aan de clienttoepassing, die de naam ToDoWebheeft.

De clienttoepassing registreren

Gebruik de volgende stappen om de clienttoepassing te registreren:

1. Gebruik de volgende opdracht om een Microsoft Entra ID-toepassing te maken, die wordt gebruikt om de machtigingen voor de ToDo app toe te voegen:

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

2. Gebruik de volgende opdracht om machtigingen toe te voegen:

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

3. Gebruik de volgende opdracht om beheerderstoestemming te verlenen voor de machtigingen die u hebt toegevoegd:

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

4. Gebruik de volgende opdracht om de client-id op te halen van de ToDoWeb app die wordt gebruikt in de stap Het toegangstoken ophalen :

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

Gebruiker toevoegen voor toegang tot de RESTful-API's

Gebruik de volgende opdracht om een lidgebruiker te maken in uw Microsoft Entra-tenant. Vervolgens kan de gebruiker de gegevens van de ToDo toepassing beheren via RESTful-API's:

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

De OAuth2-configuratie voor Swagger UI-autorisatie bijwerken

Gebruik de volgende stappen om de OAuth2-configuratie bij te werken:

1. Gebruik de volgende opdracht om de object-id van de ToDoWeb app op te halen:

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

2. Gebruik de volgende opdracht om de URL van uw simple-todo-api app op te halen:

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

3. Gebruik het volgende commando om de OAuth2-configuratie voor Swagger UI-autorisatie te updaten, waarbij u de tijdelijke aanduidingen <object-id> en <URL> vervangt door de parameterwaarden die u hebt verkregen. Vervolgens kunt u gebruikers machtigen om toegangstokens te verkrijgen via de ToDoWeb app.

   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"]}}'
   

Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief de zojuist gemaakte service:

1. Vind je resourcegroep in de Azure portal.

2. Selecteer Resourcegroepen in het navigatiemenu. Selecteer vervolgens de naam van uw resourcegroep, bijvoorbeeld myresourcegroup.

3. Op de pagina van uw resourcegroep selecteert u Verwijderen. Voer de naam van uw resourcegroep in het tekstvak in om het verwijderen te bevestigen, bijvoorbeeld myresourcegroup. Selecteer vervolgens Verwijderen.

Gebruik de volgende opdracht om de hele resourcegroep te verwijderen, inclusief de zojuist gemaakte service:

az group delete --name ${RESOURCE_GROUP}