Implementatiebronnen configureren voor App Services in Azure Stack Hub

App Service op Azure Stack Hub ondersteunt implementatie op aanvraag van meerdere broncodebeheerproviders. Met deze functie kunnen app-ontwikkelaars rechtstreeks vanuit hun opslagplaatsen voor broncodebeheer implementeren. Als gebruikers App Service willen configureren om verbinding te maken met hun opslagplaatsen, moet een cloudoperator eerst de integratie tussen App Service op Azure Stack Hub en de bronbeheerprovider configureren.

Naast lokale Git worden de volgende broncodebeheerproviders ondersteund:

• GitHub
• BitBucket
• OneDrive
• Dropbox

Implementatiebronnen weergeven in App Service-beheer

1. Meld u als servicebeheerder aan bij de Azure Stack Hub-beheerportal.

2. Blader naar Alle services en selecteer de App Service.

   

3. Selecteer Configuratie van broncodebeheer. U kunt de lijst met alle geconfigureerde implementatiebronnen bekijken.

   

GitHub configureren

U moet een GitHub-account hebben om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

1. Meld u aan bij GitHub, ga naar https://www.github.com/settings/developersen selecteer vervolgens Een nieuwe toepassing registreren.

   

2. Voer een toepassingsnaam in. App Service bijvoorbeeld op Azure Stack Hub.

3. Voer de URL van de startpagina in. De url van de startpagina moet het adres van de Azure Stack Hub-portal zijn. Bijvoorbeeld https://portal.<region>.<FQDN>. Zie Azure Stack Hub DNS-naamruimte voor meer informatie over de Volledig gekwalificeerde domeinnaam (FQDN) van Azure Stack Hub.

4. Voer een beschrijving van de toepassing in.

5. Voer de AUTORISATIE-callback-URL in. In een standaardimplementatie van Azure Stack Hub heeft de URL de vorm https://portal.<region>.<FQDN>/TokenAuthorize.

6. Selecteer Toepassing registreren. Er wordt een pagina weergegeven met de client-id en het clientgeheim voor de app.

   

7. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

8. Ga naar Resourceproviders en selecteer de App Service Resourceprovider Beheer.

9. Selecteer Configuratie van broncodebeheer.

10. Kopieer en plak de client-id en het clientgeheim in de bijbehorende invoervakken voor GitHub.

11. Selecteer Opslaan.

BitBucket configureren

U moet een BitBucket-account hebben om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

1. Meld u aan bij BitBucket en ga naar Integraties onder uw account.

   

2. Selecteer OAuth onder Toegangsbeheer en Consument toevoegen.

   

3. Voer een naam in voor de consument. App Service bijvoorbeeld op Azure Stack Hub.

4. Voer een beschrijving in voor de app.

5. Voer de callback-URL in. In een standaardimplementatie van Azure Stack Hub heeft de callback-URL de vorm https://portal.<region>.<FQDN>/TokenAuthorize. BitBucket-integratie slaagt alleen als de URL het hoofdlettergebruik volgt dat hier wordt vermeld.

6. Voer de URL in. Deze URL moet de URL van de Azure Stack Hub-portal zijn. Bijvoorbeeld https://portal.<region>.<FQDN>.

7. Selecteer de vereiste machtigingen :

   • Opslagplaatsen: Lezen
   • Webhooks: lezen en schrijven

8. Selecteer Opslaan. U ziet nu deze nieuwe app, samen met de sleutel en het geheim, onder OAuth-consumenten.

   

9. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

10. Ga naar Resourceproviders en selecteer de App Service Resourceprovider Beheer.

11. Selecteer Configuratie van broncodebeheer.

12. Kopieer en plak de sleutel in het invoervak Client-id en Geheim in het invoervak Clientgeheim voor BitBucket.

13. Selecteer Opslaan.

OneDrive configureren

U moet een Microsoft-account hebben dat is gekoppeld aan een OneDrive-account om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

Notitie

OneDrive voor Bedrijven-accounts worden momenteel niet ondersteund.

1. Ga naar en meld u aan https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade met uw Microsoft-account.

2. Selecteer onder App-registratiesde optie Nieuwe registratie.

3. Voer een naam in voor de registratie van de nieuwe app: voer bijvoorbeeld App Service in Azure Stack Hub in.

4. Selecteer onder Ondersteunde accounttypende optie Alleen persoonlijke Microsoft-accounts.

5. Voer de omleidings-URI in. Kies platform - Web en in een standaardimplementatie van Azure Stack Hub heeft de omleidings-URI de vorm - https://portal.<region>.<FQDN>/TokenAuthorize.

6. Selecteer Registreren.

7. In het volgende scherm worden de eigenschappen van uw nieuwe app weergegeven. Sla de toepassings-id (client)-id op een tijdelijke locatie op.

8. Kies onder Certificaten & geheimende optie Clientgeheimen en selecteer Nieuw clientgeheim. Geef een beschrijving op en kies de verlooplengte voor het nieuwe geheim en selecteer Toevoegen.

9. Noteer de waarde van het nieuwe geheim.

10. Selecteer onder API-machtigingende optie Een machtiging toevoegen.

11. Voeg de gedelegeerde machtigingen voor Microsoft Graph-machtigingen - toe.

    • Files.ReadWrite.AppFolder
    • Gebruiker. Lezen

12. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

13. Ga naar Resourceproviders en selecteer de App Service Resourceprovider Beheer.

14. Selecteer Configuratie van broncodebeheer.

15. Kopieer en plak de Toepassings-id (client)id in het invoervak Client-id en Geheim in het invoervak Clientgeheim voor OneDrive.

16. Selecteer Opslaan.

DropBox configureren

Notitie

U moet een DropBox-account hebben om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

1. Ga naar en meld u aan https://www.dropbox.com/developers/apps met uw DropBox-accountreferenties.

2. Selecteer App maken.

   

3. Selecteer DropBox-API.

4. Stel het toegangsniveau in op App-map.

5. Voer een naam in voor uw app.

   

6. Selecteer App maken. U krijgt een pagina te zien met de instellingen voor de app, inclusief app-sleutel en app-geheim.

7. Zorg ervoor dat de naam van de app-map is ingesteld op App Service in Azure Stack Hub.

8. Stel de OAuth 2-omleidings-URI in en selecteer vervolgens Toevoegen. In een standaardimplementatie van Azure Stack Hub heeft de omleidings-URI de vorm https://portal.<region>.<FQDN>/TokenAuthorize.

   

9. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

10. Ga naar Resourceproviders en selecteer de Beheer App Service Resourceprovider.

11. Selecteer Configuratie van broncodebeheer.

12. Kopieer en plak de toepassingssleutel in het invoervak Client-id en App-geheim in het invoervak Clientgeheim voor DropBox.

13. Selecteer Opslaan.

Belangrijk

Als u bestaande toepassingen opnieuw configureert na een upgrade naar Azure App Service op Azure Stack Hub 2022 H1, moet u alle tokens intrekken en moeten uw eindgebruikers opnieuw verifiëren bij de providers in hun toepassingen om synchronisatie van broncodebeheerproviders mogelijk te maken

GitHub configureren

U moet een GitHub-account hebben om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

1. Meld u aan bij GitHub, ga naar https://www.github.com/settings/developersen selecteer vervolgens Een nieuwe toepassing registreren.

   

2. Voer een toepassingsnaam in. App Service bijvoorbeeld op Azure Stack Hub.

3. Voer de URL van de startpagina in. De URL van de startpagina moet het adres van de Azure Stack Hub-portal zijn. Bijvoorbeeld https://portal.<region>.<FQDN>. Zie Azure Stack Hub DNS-naamruimte voor meer informatie over de FQDN (Fully Qualified Domain Name) van Azure Stack Hub.

4. Voer een toepassingsbeschrijving in.

5. Voer de autorisatie-callback-URL in. In een standaardimplementatie van Azure Stack Hub heeft de URL de vorm https://api.appservice.<region>.<FQDN>:44300/auth/github/callback.

6. Selecteer Toepassing registreren. Er wordt een pagina weergegeven met de client-id en het clientgeheim voor de app.

   

7. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

8. Ga naar Resourceproviders en selecteer de Beheer App Service Resourceprovider.

9. Selecteer Configuratie van broncodebeheer.

10. Kopieer en plak de client-id en het clientgeheim in de bijbehorende invoervakken voor GitHub.

11. Selecteer Opslaan.

BitBucket configureren

U moet een BitBucket-account hebben om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

1. Meld u aan bij BitBucket en ga naar Integraties onder uw account.

   

2. Selecteer OAuth onder Toegangsbeheer en Consument toevoegen.

   

3. Voer een naam in voor de consument. App Service bijvoorbeeld op Azure Stack Hub.

4. Voer een beschrijving in voor de app.

5. Voer de callback-URL in. In een standaardimplementatie van Azure Stack Hub heeft de callback-URL de vorm https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback. BitBucket-integratie slaagt alleen als de URL het hoofdlettergebruik volgt dat hier wordt vermeld.

6. Voer de URL in. Deze URL moet de URL van de Azure Stack Hub-portal zijn. Bijvoorbeeld https://portal.<region>.<FQDN>.

7. Selecteer de vereiste machtigingen :

   • Opslagplaatsen: lezen
   • Webhooks: lezen en schrijven

8. Selecteer Opslaan. U ziet nu deze nieuwe app, samen met de sleutel en het geheim, onder OAuth-consumenten.

   

9. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

10. Ga naar Resourceproviders en selecteer de Beheer App Service Resourceprovider.

11. Selecteer Configuratie van broncodebeheer.

12. Kopieer en plak de sleutel in het invoervak Client-id en Geheim in het invoervak Clientgeheim voor BitBucket.

13. Selecteer Opslaan.

OneDrive configureren

U moet een Microsoft-account hebben dat is gekoppeld aan een OneDrive-account om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

Notitie

OneDrive voor Bedrijven-accounts worden momenteel niet ondersteund.

1. Ga naar en meld u aan https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade met uw Microsoft-account.

2. Selecteer onder App-registratiesde optie Nieuwe registratie.

3. Voer een naam in voor de nieuwe app-registratie: voer bijvoorbeeld App Service in Azure Stack Hub in.

4. Selecteer onder Ondersteunde accounttypende optie Alleen persoonlijke Microsoft-accounts

5. Voer de omleidings-URI in. Kies platform - Web en in een standaardimplementatie van Azure Stack Hub heeft de omleidings-URI de vorm - https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback.

6. Selecteer Registreren

7. In het volgende scherm ziet u de eigenschappen van uw nieuwe app. Sla de toepassings-id (client) op een tijdelijke locatie op.

8. Kies onder Certificaten & geheimende optie Clientgeheimen en selecteer Nieuw clientgeheim. Geef een beschrijving op en kies de verlooplengte voor het nieuwe geheim en selecteer Toevoegen.

9. Noteer de waarde van het nieuwe geheim.

10. Selecteer onder API-machtigingende optie Een machtiging toevoegen

11. Voeg de gedelegeerde machtigingen voor Microsoft Graph-machtigingen - toe.

    • Files.ReadWrite.AppFolder
    • Gebruiker. Lezen

12. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

13. Ga naar Resourceproviders en selecteer de Beheer App Service Resourceprovider.

14. Selecteer Configuratie van broncodebeheer.

15. Kopieer en plak de toepassings-id (client) in het invoervak Client-id en Geheim in het invoervak Clientgeheim voor OneDrive.

16. Selecteer Opslaan.

DropBox configureren

Notitie

U moet een DropBox-account hebben om deze taak te voltooien. Mogelijk wilt u een account voor uw organisatie gebruiken in plaats van een persoonlijk account.

1. Ga naar en meld u aan https://www.dropbox.com/developers/apps met de referenties van uw DropBox-account.

2. Selecteer App maken.

   

3. Selecteer DropBox-API.

4. Stel het toegangsniveau in op App-map.

5. Voer een naam in voor uw app.

   

6. Selecteer App maken. U krijgt een pagina te zien met de instellingen voor de app, inclusief app-sleutel en app-geheim.

7. Zorg ervoor dat de naam van de app-map is ingesteld op App Service in Azure Stack Hub.

8. Stel de OAuth 2-omleidings-URI in en selecteer vervolgens Toevoegen. In een standaardimplementatie van Azure Stack Hub heeft de omleidings-URI de vorm https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback.

   

9. Meld u in een nieuw browsertabblad of -venster als servicebeheerder aan bij de Azure Stack Hub-beheerdersportal.

10. Ga naar Resourceproviders en selecteer de Beheer App Service Resourceprovider.

11. Selecteer Configuratie van broncodebeheer.

12. Kopieer en plak de toepassingssleutel in het invoervak Client-id en App-geheim in het invoervak Clientgeheim voor DropBox.

13. Selecteer Opslaan.

Volgende stappen

Gebruikers kunnen nu de implementatiebronnen gebruiken voor zaken als continue implementatie, lokale Git-implementatie en synchronisatie van cloudmappen.