Verbind Microsoft Power Apps met Azumuta met apparaat-API-tokens

Bijgewerkt

Opmerking: Dit artikel is technisch; we raden u aan iemand met de juiste technische expertise te betrekken. Als u vragen heeft of hulp nodig hebt bij de installatie, neem contact op met support@azumuta.com.

Dit voorbeeld voegt een Open work instruction-knop toe aan een Microsoft Power Apps canvas-app. De knop roept een Power Automate-flow aan die een session token van Azumuta opvraagt en teruggeeft aan de app. Power Apps opent vervolgens de werkinstructie in de Azumuta App.

De langlopende device API key blijft in een Power Platform-verbinding. De flow retourneert alleen een session token aan de canvas-app. Die kan één keer binnen 60 seconden aanmelden; na aanmelding gebruikt de pagina de normale Azumuta-sessie. Dit voorbeeld opent een werkinstructie voor consultatie via /view/, wat normaal gesproken een consultatie-opname aanmaakt. Als consultatie-opname voor de instructie is uitgeschakeld, opent de pagina in plaats daarvan een zelfstandige preview.

How the connection works

Power Apps calls a Power Automate flow, which uses its stored API key to request a one-use token from Azumuta. The token returns through the flow to Power Apps, which opens an operator page and signs in on a normal device.

  1. Power Apps voert de flow uit wanneer de gebruiker op de knop drukt.
  2. Power Automate roept POST /api/v1/auth/sessionTokens aan met de integration API key in de x-api-key-header en de doel-deviceId en loginIdentifier in de JSON-body.
  3. Azumuta valideert het verzoek en retourneert een eenmalig token. De flow geeft dat token door aan Power Apps.
  4. Power Apps opent /view/WORK_INSTRUCTION_ID?sessionToken=.... De integration API key maakt nooit deel uit van die URL.
  5. De Azumuta-pagina meldt de toegestane operator aan op het normale device, verwijdert het token uit de adresbalk en laadt de werkinstructie en media.

Open other Azumuta App pages

Dit voorbeeld opent een werkinstructie. Dezelfde connector en flow kunnen ook andere pagina's openen, zoals een recording, een product order of een spot. Wijzig de bestemmings-URL in de Power Apps-knop en vraag telkens een nieuw token aan. Zie Open Azumuta App pages from another application voor de beschikbare pagina's en hun opties.

The running example

Het voorbeeld is geverifieerd op 16 November 2026 met de volgende bronnen:

Resource Example
Azumuta environment https://sandbox.azumuta.com
Work instruction Installing the Motor, approved Version 10
Sandbox user Test Operator
Microsoft developer environment Azumuta Power Apps Docs
Canvas app Azumuta sandbox example
Power Automate flow AzumutaOpenInstruction
Custom connector Azumuta Sandbox

Gebruik uw eigen sandbox-toegang en testoperator bij het doorlopen van de stappen. Alle sleutels, login identifiers en document-ID's hieronder zijn tijdelijke voorbeelden; het voorbeeld verspreidt geen geloofsgegevens voor de sandbox.

In het voltooide voorbeeld toont het tabblad Flows van de app AzumutaOpenInstruction. De omgevingsselector staat rechtsboven.

Power Apps shows the Azumuta sandbox example app with AzumutaOpenInstruction linked in its Flows tab and the developer environment selected.

Before you start

U hebt het volgende nodig:

  • Een Azumuta-sandboxworkspace en toestemming om devices te beheren en gebruikers te bekijken.
  • Toegang tot de in-app REST API-documentatie van die workspace.
  • Een actieve sandbox-operator met een login identifier die momenteel op die workspace is geschakeld.
  • Een goedgekeurde werkinstructie die de operator kan raadplegen.
  • Een Microsoft werk- of schoolaccount, een Power Platform development environment en toestemming om in die omgeving een custom connector, cloud flow en canvas-app te maken.

Het Power Apps Developer Plan ondersteunt ontwikkeling en testen met custom connectors. Meld het account aan dat dit voorbeeld zal bouwen en uitvoeren. Alleen het aanmaken van een omgeving wijst niet automatisch een Power Apps-plan toe aan dat account: de app kan in Studio-preview werken terwijl de gepubliceerde player nog om een licentie vraagt. Lidmaatschap van het Microsoft 365 Developer Program is op zichzelf niet voldoende.

Volg Microsoft's current environment provisioning requirements. Vanaf 15 November 2026 maakt Developer Plan-signup geen omgeving meer automatisch aan. Vraag uw beheerder om een managed developer environment, of gebruik een geschikte trial-omgeving. Managed environments vereisen een extra premium-licentie, zelfs wanneer een maker zijn eigen test-app of flow uitvoert; het gratis Developer Plan bevat die gebruiksrechten niet. Productiegebruik vereist eveneens passende Microsoft-licenties.

Het geverifieerde voorbeeld draaide in een unmanaged developer environment. Microsoft plant deze omgevingen te schorsen vanaf 15 December 2026 en te verwijderen vanaf 15 January 2027. Behandel de omgeving als een tijdelijke test en regel een gelicentieerde omgeving of verplaats de oplossing vóór schorsing. Zie Microsoft's Developer Plan lifecycle guidance.

Houd de app, flow en connector gedurende deze procedure in dezelfde Power Platform-omgeving.

1. Prepare two Azumuta devices

De integratie en de operatorpagina gebruiken verschillende devices:

Device Example name Configuration Used by
API device Power Apps documentation demo Only sessiontokens:write Power Automate
Normal device Power Apps demo workstation Allows login identifier authentication; no API scopes The operator page

Create the integration API device

  1. In Azumuta on Web, open Management > Devices > API.
  2. Gebruik het gele plusmenu om Add device te selecteren.
  3. Voer Power Apps documentation demo in en kies Api Device als type.
  4. Open Security. Schakel Restrict this API key to a subset of operations in als deze nog niet is ingeschakeld.
  5. Wis de gewone scopes met (select all). Selecteer onder Sensitive scopes Session tokens (sessiontokens:write). Laat alle andere scopes voor dit voorbeeld uitgevinkt.
  6. Klik op Add, en gebruik vervolgens in de rij van het device het rijmenu om Copy API key te kiezen. Houd deze sleutel bij de hand voor de Power Platform-verbinding in stap 2.

Full access en (select all) omvatten niet de gevoelige session-token-scope. U moet die expliciet selecteren. Zie Create and manage API keys voor algemeen sleutelbeheer.

Prepare the operator device and user

  1. In Devices > Overview, voeg een dedicated normal device toe met de naam Power Apps demo workstation. Selecteer Api Device niet.
  2. Laat onder Security Restrict this API key to a subset of operations uitgeschakeld. Schakel Allow authentication using login identifier in. Beperk User groups allowed to authenticate with login identifier tot de groep van de sandbox-operator.
  3. Sla het device op en kopieer de Device ID uit de details. Dit is de doel-deviceId; gebruik niet het ID van het integration API device.
  4. Ga naar Management > Users en controleer de Login identifier en groepslidmaatschap van de testoperator. Een login identifier is niet per se het e-mailadres van de operator of de Microsoft-accountnaam.
  5. Open de goedgekeurde werkinstructie in Azumuta on Web. Open Help (het vraagteken rechtsboven) > API attributes en kopieer de Work instruction ID. De afzonderlijke Tree node ID in dat dialoogvenster, die ook in het /nodes/workinstruction/...-adres wordt gebruikt, werkt niet in /view/. Zie Using your data in the REST API voor het vinden van API-attributes.

De scope-restrictie moet uitstaan op het doeldevice. Als u deze aanlaat maar alle scopes uitvinkt, configureert dat nog steeds een lege scopelijst, die het session-token-endpoint afwijst. De operatorpagina gebruikt dit normale device voor eigen verzoeken na aanmelding, inclusief mediadownloads.

2. Create a custom connector

De connector slaat de device API key op in een verbinding en stuurt deze naar Azumuta als een request header. De canvas-app zal de flow aanroepen en de sleutel niet rechtstreeks ontvangen.

  1. Open Power Automate en selecteer uw development environment.

  2. Open More > Discover all. Onder Data kiest u Custom connectors, daarna New custom connector > Create from blank. Geef de connector de naam Azumuta Sandbox. Als Custom connectors al in de linkernavigatie staat, open het dan direct.

  3. Onder General, configureer:

    Field Value
    Scheme HTTPS
    Host sandbox.azumuta.com
    Base URL /
  4. Onder Security, kies API Key-authenticatie:

    Field Value
    Parameter label Azumuta device API key
    Parameter name x-api-key
    Parameter location Header
  5. Onder Definition, voeg een actie toe met summary Create session token en operation ID CreateSessionToken.

  6. In Request, kies Import from sample. Gebruik verb POST, URL https://sandbox.azumuta.com/api/v1/auth/sessionTokens en deze body, waarbij u beide waarden vervangt door uw sandbox-waarden:

    {
      "deviceId": "NORMAL_DEVICE_ID",
      "loginIdentifier": "SANDBOX_OPERATOR_LOGIN_IDENTIFIER"
    }
    
  7. Maak beide body-eigenschappen verplicht. Stel de request content type in op application/json. Voeg de API key niet toe aan de sample body, URL of actieparameters.

  8. Onder Response, voeg een default response toe met deze voorbeeldstructuur:

    {
      "object": "sessionToken",
      "token": "EXAMPLE_ONLY_NOT_A_VALID_TOKEN",
      "expiresAt": 1794826860000
    }
    
  9. Sla de connector op en los eventuele validatiefouten in de definitie op.

  10. Onder Test, selecteer New connection en voer de integration device's API key in. Voer alleen de sleutel in, zonder Bearer-prefix. Maak de verbinding.

The Azumuta Sandbox custom connector's Security page uses API Key authentication, parameter name x-api-key, and Header as the parameter location.

Voor de volledige connectorwizard, zie Microsoft's Create a custom connector from scratch.

Een succesvol verzoek retourneert HTTP 200 met object, token en expiresAt. De expiry is een timestamp in milliseconds since the Unix epoch. Een token dat in het connector-testpaneel is gegenereerd, is gescheiden van het token dat de app later zal aanvragen; sla het niet op voor hergebruik.

3. Build the Power Automate flow

Voor dit private voorbeeld legt u de operator en het device vast in de flow. De Power Apps-trigger heeft geen invoer nodig. Houd de flow beperkt tot de persoon die deze test uitvoert: elke succesvolle aanroep staat aanmelding toe als die sandbox-operator.

  1. Maak in Power Automate een Instant cloud flow genaamd AzumutaOpenInstruction met trigger When Power Apps calls a flow (V2).

  2. Voeg de Create session token-actie van Azumuta Sandbox toe, gebruikmakend van de verbinding die u zojuist heeft gemaakt. Als de designer om een verbinding vraagt, voer dan een verbindingsnaam en dezelfde dedicated sandbox API key in.

  3. Hernoem de actie in CreateSessionToken. Stel deviceId en loginIdentifier in op de vaste sandboxwaarden uit stap 1.

  4. Open de Settings van de actie en schakel Secure inputs en Secure outputs in voordat u deze uitvoert.

  5. Voeg Respond to a Power App or flow toe. Voeg een Text-output toe met de naam sessionToken en selecteer body/token van CreateSessionToken in de dynamic content picker. In de expressie-editor is het equivalent:

    body('CreateSessionToken')?['token']
    
  6. Schakel Secure inputs in op de response-actie; in de instellingen wordt uitgelegd dat dit ook de outputs beveiligt. Laat Asynchronous response uitgeschakeld en de run-after-conditie ingesteld op de succesvolle voltooiing van CreateSessionToken.

  7. Sla de flow op. Voeg de API key niet toe aan de response.

The Power Automate designer shows When Power Apps calls a flow (V2), CreateSessionToken, and Respond to a Power App or flow in sequence.

Secure inputs en outputs verbergen gevoelige waarden in de run-historie. Ze voorkomen niet dat een flow-eigenaar de flow kan bewerken. Microsoft's guidance on securing cloud-flow data verklaart deze instellingen.

4. Add the Power Apps button

  1. In Power Apps, selecteer dezelfde development environment. Kies Start with design > Create from blank > Tablet. Sla de canvas-app op als Azumuta sandbox example.

  2. Open in Power Apps Studio het Power Automate-paneel en voeg de bestaande AzumutaOpenInstruction-flow toe.

  3. Voeg een knop in met de tekst Open work instruction.

  4. Stel de OnSelect-eigenschap van de knop in op de volgende formule. Vervang WORK_INSTRUCTION_ID door de ID van uw goedgekeurde werkinstructie:

    IfError(
        With(
            { result: AzumutaOpenInstruction.Run() },
            If(
                IsBlank(result.sessiontoken),
                Notify("Azumuta did not return a session token", NotificationType.Error),
                Launch(
                    "https://sandbox.azumuta.com/view/WORK_INSTRUCTION_ID",
                    { sessionToken: result.sessiontoken },
                    LaunchTarget.New
                )
            )
        ),
        Notify("Could not open the Azumuta work instruction", NotificationType.Error)
    )
    
  5. Controleer de naam van het responseveld die Power Apps autocomplete aanbiedt. Gebruik de gegenereerde naam als de hoofdlettergebruiking afwijkt van sessiontoken. Als de flow is gewijzigd nadat u deze aan de app hebt toegevoegd, vernieuw of verwijder en voeg de flow opnieuw toe.

  6. Sla de app en bekijk een preview. In locales die puntkomma's als Power Fx-argumentscheiders gebruiken, pas de formule-separators aan op basis van de editorlocale.

Bewaar en publiceer de app-versie als u die via de weblink wilt heropenen. Het publiceren van een versie en het verlenen van toegang aan anderen zijn afzonderlijke stappen; houd dit voorbeeld met vaste identiteit privé.

Bij de eerste start kan Power Apps vragen of de app toestemming krijgt om Azumuta Sandbox via de Power Automate-flow te gebruiken. Controleer dat de vermelde actie Create session token is en sta de verbinding toe voor uw testapp.

The published Azumuta sandbox example canvas app has an Open work instruction button.

De flow wordt bij elke knopdruk uitgevoerd, direct vóór de navigatie. Genereer geen tokens tijdens het opstarten van de app en bewaar geen token om de pagina later opnieuw te openen.

5. Verify the complete example

  1. Klik in de app-preview op Open work instruction en sta het nieuwe browsertabblad toe als de browser daarom vraagt.
  2. Bevestig dat de werkinstructie opent als de bedoelde sandbox-operator op Power Apps demo workstation. Controleer zowel tekst als media.
  3. Controleer de adresbalk: Azumuta verwijdert sessionToken na het uitlezen. De launch-URL mag geen apiKey, deviceId of loginIdentifier bevatten.
  4. Inspecteer de flow-run. Deze moet slagen, met de token-bevattende actie-inputs en -outputs verborgen.
  5. Klik nogmaals op de Power Apps-knop. De flow moet een nieuw token aanvragen en de pagina opnieuw openen.
  6. Voor een aparte replay-test opent u het Test-tabblad van de custom connector. Voer het deviceId van het normale device en de loginIdentifier van de testoperator in en selecteer Test operation. Gebruik het teruggegeven token om https://sandbox.azumuta.com/view/WORK_INSTRUCTION_ID?sessionToken=DISPOSABLE_TOKEN samen te stellen, vervang uw instructie-ID en dit wegwerp-token. Open exact die URL twee keer in nieuwe tabs. Alleen de eerste aanmelding moet slagen. Een herlaad van het reeds aangemelde tabblad kan die sessie hervatten; dat is geen replay-test.
  7. Gebruik Test operation opnieuw om een ander wegwerp-token te genereren, laat het langer dan 60 seconden ongebruikt en open de URL in een nieuw tabblad. Aanmelden moet mislukken. Klik op de Power Apps-knop om een nieuw token aan te vragen. Houd de secure inputs en outputs van de flow gedurende deze tests ingeschakeld.

Leg tokenwaarden niet vast in screenshots, artikelvoorbeelden of gedeelde testnotities.

In het geverifieerde voorbeeld opende de canvas-knop Installing the Motor, Version 10, en laadden de afbeeldingen, zowel in Studio-preview als vanuit de gepubliceerde app-player. De flow slaagde met beide token-bevattende acties waarvan inputs en outputs verborgen waren. Het opnieuw gebruiken van het verbruikte token gaf 403 Access denied; het openen van een ongebruikt token na verlopen tijd gaf 403 Expired.

Troubleshooting

Symptom Check
HTTP 401 De API key van de verbinding en de sandbox-host komen overeen; de sleutel wordt in de x-api-key-header verzonden
HTTP 403 mentioning sessiontokens:write Het API device heeft expliciete scopes en Session tokens geselecteerd; full access is onvoldoende
HTTP 400 about the target device deviceId verwijst naar een normal device zonder API-scopes en met login identifier-authenticatie ingeschakeld
HTTP 400 about the user De operator is actief en momenteel op dezelfde workspace ingeschakeld
HTTP 403 about user groups De operator behoort tot een groep die is toegestaan op het doeldevice
HTTP 404 Het normale device en de operator login identifier bestaan in de workspace van de API key
Page sign-in fails Vraag een nieuw token aan en navigeer direct; verlopen of gebruikte tokens kunnen niet opnieuw worden gebruikt
Work instruction or media does not load Controleer de goedgekeurde instructie, operatorrechten en deviceconfiguratie; houd API-scopes uitsluitend op het integration device
Flow or custom action does not appear Controleer dat alle resources in dezelfde Power Platform-omgeving staan; laat connectorwijzigingen doorwerken en vernieuw
Published app asks to start a Power Apps trial Controleer de Power Apps-rechten van het aangemelde account; alleen een developer environment en een succesvolle Studio-preview zijn niet voldoende

Adapt the example

Voor een productieapp vervangt u de vaste testidentiteit door een servergevalideerde mapping van de geauthenticeerde Microsoft-aanroeper naar de toegestane Azumuta-operator. Accepteer geen onbeperkte loginIdentifier of doel-deviceId vanuit een canvastekstveld: de device key machtigt de integratie, niet de persoon die de app uitvoert. Beperk wie de flow mag uitvoeren en bewerken en zorg voor de vereiste Microsoft-licenties voordat u de oplossing deelt.

Voor een andere REST-operatie voegt u die actie toe aan de connector en geeft u alleen de gedocumenteerde API-scopes. Blijf de sleutel in de header verzenden. Gebruik de workspace's REST API documentation voor aanvraag- en antwoorddetails.

Wanneer het voorbeeld niet langer nodig is, schakel dan de flow uit en intrek de sandbox-credential via het beheer van API-devices in uw workspace.