Delen via

Implementatiebronnen configureren voor App Services in Azure Stack Hub

  • Artikel

App Service in Azure Stack Hub biedt ondersteuning voor implementatie op aanvraag van meerdere bronbeheerproviders. 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 bronbeheerproviders 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.

    App Service-resourceproviderbeheerder

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

    Configuratie van broncodebeheer voor de App Service-resourceprovider

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.

    GitHub - Een nieuwe toepassing registreren

  2. Voer een toepassingsnaam in. Bijvoorbeeld App Service in Azure Stack Hub.

  3. Voer de URL van de startpagina in. De URL van de startpagina moet het azure Stack Hub-portaladres 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 beschrijving van de toepassing in.

  5. Voer de callback-URL voor autorisatie 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.

    GitHub - Voltooide toepassingsregistratie

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

  8. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  9. Selecteer de 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.

    BitBucket-dashboard - Integraties

  2. Selecteer OAuth onder Toegangsbeheer en Consument toevoegen.

    BitBucket OAuth-consument toevoegen

  3. Voer een naam in voor de consument. Bijvoorbeeld App Service in 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. Voor een geslaagde BitBucket-integratie moet de URL het hoofdlettergebruik volgen 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.

    Vermelding van BitBucket-toepassing

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

  10. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  11. Selecteer de 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 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 https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade en meld u aan met uw Microsoft-account.

  2. Selecteer Onder App-registraties de 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 accounttypen alleen Persoonlijke Microsoft-accounts.

  5. Voer de omleidings-URI in. Kies platform - Web en in een standaardimplementatie van Azure Stack Hub, de omleidings-URI heeft 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) op een tijdelijke locatie op.

  8. Kies onder Certificaten en geheimen 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-machtigingen de optie Een machtiging toevoegen.

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

    • Files.ReadWrite.AppFolder
    • Gebruiker. Read

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

  13. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  14. Selecteer de 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 https://www.dropbox.com/developers/apps en meld u aan met de referenties van uw DropBox-account.

  2. Selecteer App maken.

    Dropbox-apps

  3. Selecteer DropBox-API.

  4. Stel het toegangsniveau in op app-map.

  5. Voer een naam in voor uw app.

    Registratie van Dropbox-toepassing

  6. Selecteer Create App. U ziet een pagina met de instellingen voor de app, waaronder 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.

    Configuratie van Dropbox-toepassing

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

  10. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  11. Selecteer de 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 in Azure Stack Hub 2022 H1, moet u alle tokens intrekken en moeten uw eindgebruikers zich opnieuw verifiëren met de providers in hun toepassingen om synchronisatie van bronbeheerproviders 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.

    GitHub - Een nieuwe toepassing registreren

  2. Voer een toepassingsnaam in. Bijvoorbeeld App Service in Azure Stack Hub.

  3. Voer de URL van de startpagina in. De URL van de startpagina moet het azure Stack Hub-portaladres 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 beschrijving van de toepassing in.

  5. Voer de callback-URL voor autorisatie 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.

    GitHub - Voltooide toepassingsregistratie

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

  8. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  9. Selecteer de 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.

    BitBucket-dashboard - Integraties

  2. Selecteer OAuth onder Toegangsbeheer en Consument toevoegen.

    BitBucket OAuth-consument toevoegen

  3. Voer een naam in voor de consument. Bijvoorbeeld App Service in 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. Voor een geslaagde BitBucket-integratie moet de URL het hoofdlettergebruik volgen 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.

    Vermelding van BitBucket-toepassing

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

  10. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  11. Selecteer de 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 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 https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade en meld u aan met uw Microsoft-account.

  2. Selecteer Onder App-registraties de 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 accounttypen alleen Persoonlijke Microsoft-accounts

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

  6. Selecteer Registreren

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

  8. Kies onder Certificaten en geheimen 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-machtigingen de optie Een machtiging toevoegen

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

    • Files.ReadWrite.AppFolder
    • Gebruiker. Read

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

  13. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  14. Selecteer de 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 https://www.dropbox.com/developers/apps en meld u aan met de referenties van uw DropBox-account.

  2. Selecteer App maken.

    Dropbox-apps

  3. Selecteer DropBox-API.

  4. Stel het toegangsniveau in op app-map.

  5. Voer een naam in voor uw app.

    Registratie van Dropbox-toepassing

  6. Selecteer Create App. U ziet een pagina met de instellingen voor de app, waaronder 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.

    Configuratie van Dropbox-toepassing

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

  10. Ga naar Resourceproviders en selecteer de beheerder van de App Service-resourceprovider.

  11. Selecteer de 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.