Risolvere i problemi della funzionalità di ritorno a capo in Power Apps

Questa guida fornisce soluzioni ai problemi comuni riscontrati quando si usa la funzionalità wrap in Microsoft Power Apps.

Problema 1: Il processo di build Wrap non riesce

Se il wrap build non riesce, prova a eseguire le seguenti azioni:

Verificare i formati di immagine

Tutte le immagini nel progetto di wrapping devono essere in formato PNG. L'uso di altri formati causa l'esito negativo della compilazione. Usare un convertitore di immagini per convertire le immagini in .png.

Importante

La ridenominazione di un'estensione di file in .png non converte l'immagine in formato PNG.

Controllare la configurazione di Azure Key Vault

• Assicurati di creare un principale del servizio di Azure e assegnare il ruolo corretto.
• Per altre informazioni, vedere Creare l'insieme di credenziali delle chiavi di Azure per eseguire il wrapping in Power Apps.

Il tuo archivio delle chiavi deve contenere:

• Per iOS: due tag, un certificato e un segreto.
• Per Android: un tag e un certificato.

---

Problema 2: Il pulsante a capo è disabilitato

È possibile eseguire il wrapping delle app solo se si dispone delle autorizzazioni di modifica. Verificare di avere le autorizzazioni corrette per l'app e riprovare.

---

Problema 3: Impossibile salvare il progetto di wrapping o attivare una compilazione

Eseguire l'aggiornamento alla versione più recente della soluzione di wrapping e riprovare.

---

Problema 4: Impossibile installare l'app per dispositivi mobili incapsulata

Assicura che l'app sia firmata correttamente configurando un archivio delle chiavi durante il processo di compilazione o firmando manualmente l'app.

Per altre informazioni, vedere:

• Configurare l'insieme di credenziali delle chiavi per la firma automatica
• Firmare il codice per iOS
• Firmare il codice per Android

Verificare inoltre che il dispositivo soddisfi i requisiti minimi.

---

Problema 5: Non è possibile accedere o visualizzare i dati nell'app di cui è stato eseguito il wrapping

Se non è possibile accedere o visualizzare i dati nell'app di cui è stato eseguito il wrapping, provare le azioni seguenti:

Verificare le autorizzazioni api e l'accesso

• Verificare che tutte le autorizzazioni API necessarie siano configurate e che siano concesse autorizzazioni di amministratore.

  

• Verificare che lo Add-AdminAllowedThirdPartyApps script venga eseguito correttamente.
  Per altre informazioni, vedere Consentire le app registrate nell'ambiente in uso.

Controllare il tipo di conto e gli URI di reindirizzamento

• Verificare che il tipo di app Microsoft Entra sia impostato su Multitenant e che il tipo di account supportato sia Accounts in any organizational directory (Any Microsoft Entra ID tenant).

• Configurare gli URI di reindirizzamento appropriati per iOS e Android:

  • Per Android, verificare che l'hash sia corretto.
  • Per altre informazioni, vedere Configurare le impostazioni della piattaforma e gli URI di reindirizzamento.

---

Problema 6: Errori del Key Vault di Azure nella funzione di wrapping per Power Apps

È possibile che si verifichino questi codici di errore nella procedura guidata di wrapping:

Codice di errore	Messaggio di errore
1000118	La sottoscrizione predefinita non è stata trovata o le autorizzazioni di accesso sono mancanti.
1000119	La cassaforte delle chiavi non esiste o manca dei privilegi di accesso.
1000120	Nessun tag ID organizzazione trovato nella cassaforte delle chiavi. Assicurarsi che il tag {Bundle ID}.{organization-id} sia presente e utilizzi la corretta distinzione tra maiuscole e minuscole.
1000121	Il keystore Android non è valido. Assicurarsi che il tag {ID bundle}{keystore} sia presente e usi la distinzione tra maiuscole e minuscole corretta.
1000122	Il certificato iOS non è valido. Tag mancante e/o segreto. Assicurarsi che il tag {ID bundle}{cert} sia presente e utilizzi la corretta distinzione tra maiuscole e minuscole.
1000123	Il profilo iOS non è valido. Assicurarsi che il tag {ID bundle}.{profile} sia presente e usi la corretta distinzione tra maiuscole e minuscole.
1000128	Chiave di accesso mancante necessaria per accedere al percorso di Archiviazione BLOB di Azure. Assicurati che il tag {Bundle ID}.{accessKey} sia presente e rispetti il corretto uso delle maiuscole e minuscole.
1000130	Valore predefinito mancante: la variabile di ambiente necessaria per la configurazione di Azure Key Vault nella procedura guidata di wrapping non è impostata.
1000131	Nessun tag o autorizzazione di accesso mancante per l'insieme di credenziali delle chiavi di Azure specificato.
1000132	Variabile di ambiente mancante 'PA_Wrap_KV_ResourceID' per l'ambiente di destinazione.

Codice di errore 1000118

Messaggio Erroe: sottoscrizione predefinita non trovata o autorizzazioni di accesso mancanti.

Procedura per la risoluzione

1. Verificare che il Key Vault di Azure sia nella sottoscrizione predefinita del tenant.

2. Come amministratore di Microsoft Entra ID (in precedenza Azure AD), aggiungere l'entità servizio per l'AppID "4e1f8dc5-5a42-45ce-a096-700fa485ba20" eseguendo i comandi seguenti in PowerShell:

   Connect-AzureAD -TenantId <your tenant ID>
   New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"
   

3. Nel portale di Azure, in Controllo di accesso (IAM), assegnare il ruolo Lettore all'entità servizio:

   1. Passare a Controllo di accesso (IAM) e quindi selezionare Aggiungi assegnazione di ruolo.

      

   2. Scegliere Lettore in Ruoli funzionali del lavoro e vai alla scheda Membri.

      

   3. Cerca il nome dell'app.

      

   4. Assegnare il ruolo Lettore .

      

Codice di errore 1000119

Messaggio di errore: Key Vault non esiste oppure manca dei privilegi di accesso.

Procedura per la risoluzione

1. Verifica che il Key Vault di Azure sia nella sottoscrizione predefinita del tenant.

2. Durante la creazione dell'insieme di credenziali, selezionare Criteri di accesso all'insieme di credenziali.

   

3. Come amministratore di Microsoft Entra ID (in precedenza Azure AD), aggiungere l'entità servizio per l'AppID "4e1f8dc5-5a42-45ce-a096-700fa485ba20" eseguendo i comandi seguenti in PowerShell:

   Connect-AzureAD -TenantId <your tenant ID>
   New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"
   

4. Nel portale di Azure assegnare il ruolo Lettore come illustrato nella sezione precedente del codice di errore.

5. Aggiungere criteri di accesso all'insieme di credenziali chiave.

   

   

Codice di errore 1000120

Messaggio di errore: Nessun tag ID organizzazione trovato nel key vault. Assicurarsi che il tag {Bundle ID}.{organization-id} sia presente e utilizzi la corretta distinzione tra maiuscole e minuscole.

Procedura per la risoluzione

1. Nel Power Platform Centro di amministrazione, seleziona il tuo ambiente.

   

2. Copiare l'ID organizzazione.

   

3. Nel tuo vault delle chiavi, vai su Tags e crea un tag denominato organization-id con l'ID della tua organizzazione come valore.

   

Codice di errore 1000121

Messaggio di errore: l'archivio chiavi Android non è valido. Assicurati che il tag {ID bundle}.{keystore} sia presente e utilizzi la distinzione tra maiuscole e minuscole corretta.

Procedura per la risoluzione

1. Importare il certificato Android.

   

   

2. Aggiungere un tag per il certificato:

   • Nome tag: usare lo stesso ID bundle del progetto di wrapping , ad esempio com.testApp.wrap.
   • Valore tag: usare il nome del certificato assegnato durante il caricamento (ad esempio, AndroidCertificate).

   

Codice di errore 1000122

Messaggio di errore: il certificato iOS non è valido. Tag mancante e/o segreto. Assicurarsi che il tag {Bundle ID}.{cert} sia presente e utilizzi la distinzione corretta tra maiuscole e minuscole.

Procedura per la risoluzione

1. Importare il certificato iOS.

   

   

2. Aggiungere un tag per il certificato:

   • Nome tag: usare l'ID bundle del progetto di wrapping.
   • Valore tag: usare il nome del certificato assegnato durante il caricamento (ad esempio, iOSCertificate).

   

Codice di errore 1000123

Messaggio di errore: il profilo iOS non è valido. Assicurarsi che il tag {ID bundle}.{profile} sia presente e usi la distinzione tra maiuscole e minuscole corretta.

Procedura per la risoluzione

1. Importare il profilo di provisioning come segreto.

2. Aggiungi un tag per il profilo di provisioning:

   • Nome tag: usare l'ID bundle del progetto di wrapping.
   • Valore tag: usare il nome assegnato al segreto durante il caricamento (ad esempio, iOSProvisioningProfile).

   

Codice di errore 1000128

Messaggio di errore: chiave di accesso mancante necessaria per accedere al percorso di Archiviazione BLOB di Azure. Assicurarsi che il tag {ID bundle}.{accessKey} sia presente e usi la corretta distinzione tra maiuscole e minuscole.

Procedura per la risoluzione

Aggiungere la chiave di accesso dall'account di archiviazione Azure Blob all'Azure Key Vault.

Per altre informazioni, vedere Passaggio 2: Piattaforma di destinazione.

Codice di errore 1000130

Messaggio di errore: valore predefinito mancante: la variabile di ambiente necessaria per la configurazione di Azure Key Vault nella procedura guidata di wrapping non è impostata.

Procedura per la risoluzione

1. Assegna l'ID risorsa dell'Azure Key Vault che intendi usare con la tua applicazione wrap alla variabile.

2. Verificare che l'ID della risorsa specificato includa tutti i tag obbligatori associati al Bundle ID definito nella procedura guidata di wrapping.

Per altre informazioni, vedere Passaggio 2: Piattaforma di destinazione.

Codice di errore 1000131

Messaggio di errore: tag mancanti o autorizzazione di accesso assente per lo specifico Azure Key Vault.

Procedura per la risoluzione

1. Assegna l'ID risorsa del Key Vault di Azure che intendi usare con la tua applicazione di wrap alla variabile.

2. Verificare che l'ID risorsa specificato includa tutti i tag obbligatori associati all'ID bundle definito nella procedura guidata di wrapping.

3. Assicurati di avere l'autorizzazione per accedere al key vault:

   1. Come amministratore di Microsoft Entra ID (in precedenza Azure AD), aggiungere l'entità servizio per l'AppID "4e1f8dc5-5a42-45ce-a096-700fa485ba20" eseguendo i comandi seguenti in PowerShell:

      Connect-AzureAD -TenantId <your tenant ID>
      New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"
      

   2. Nel portale di Azure, in Controllo di accesso (IAM), assegnare il ruolo Lettore all'entità servizio:

      1. Passare a Controllo di accesso (IAM) e quindi selezionare Aggiungi assegnazione di ruolo.

         

      2. Scegliere Lettore in Ruoli funzionali del lavoro e vai alla scheda Membri.

         

      3. Cerca il nome dell'app.

         

      4. Assegnare il ruolo Lettore .

         

Per altre informazioni, vedere Passaggio 2: Piattaforma di destinazione.

---

Codice di errore 1000132

Messaggio di errore: variabile di ambiente mancante 'PA_Wrap_KV_ResourceID' per l'ambiente di destinazione.

Procedura per la risoluzione

1. Controllare se la variabile PA_Wrap_KV_ResourceID di ambiente esiste nell'ambiente di destinazione. Se non c'è, crealo.

2. Assicurarsi che il nome segua la convenzione di denominazione corretta senza errori di digitazione o formattazione.

Per altre informazioni, vedere Passaggio 2: Piattaforma di destinazione.

---

Problema 7: Non è possibile accedere all'app di cui è stato eseguito il wrapping

1. Assicurarsi che l'utente abbia accesso all'app. Per ulteriori informazioni, vedere Condividere un'app canvas con l'organizzazione.

2. Se l'utente ha accesso all'app ma non riesce ancora ad accedere, controllare i criteri di accesso condizionale nell'interfaccia di amministrazione di Microsoft Entra.

3. Usare l'ID di correlazione dalla schermata di accesso non riuscita per altre operazioni di risoluzione dei problemi.

---

Problema 8: messaggio di errore: "Si è verificato un problema. [5objp]"

Questo problema può verificarsi a causa di una mancata corrispondenza della chiave hash della firma o di una mancata corrispondenza dell'URI di reindirizzamento durante il processo di autenticazione dell'app.

Cause radice comuni

Causa 1: Mancata corrispondenza della chiave hash della firma

L'APK è firmato con una chiave diversa da quella registrata nell'applicazione Microsoft Entra ID. Questo problema può verificarsi se:

• Durante il processo di compilazione viene usato un archivio chiavi diverso.

• La chiave hash registrata viene generata o copiata in modo non corretto, ad esempio include spazi aggiuntivi o caratteri non validi.

Causa 2: Mancata corrispondenza dell'URI di reindirizzamento

L'URI di reindirizzamento usato dall'app non corrisponde a quello registrato nel portale:

• Gli URI di reindirizzamento fanno distinzione tra maiuscole e minuscole. Le mancate corrispondenze possono verificarsi se l'ID bundle o l'URI viene immesso con maiuscole e minuscole non corrette.

• I caratteri speciali nell'URI (ad esempio %2F, %3D) devono essere codificati correttamente e corrispondere esattamente a quanto registrato in Microsoft Entra ID.

Come risolvere il problema

Verificare la chiave hash della firma

1. Generare la chiave hash corretta dall'archivio chiavi usato per firmare l'app.

2. Nell'interfaccia di amministrazione di Microsoft Entra passare a Registrazioni app e selezionare l'app.

3. Nel riquadro di spostamento dell'app selezionare Autenticazione.

4. Nella sezione Configurazioni della piattaforma individuare la piattaforma Android .

5. Verifica che la chiave hash della firma dell'app sia elencata e corrisponda alla chiave hash generata dal keystore.

6. Se la chiave hash è mancante o errata, aggiungerla o aggiornarla in base alle esigenze e quindi salvare le modifiche.

Controllare l'URI di reindirizzamento

1. Installare Android Studio e configurare un emulatore.

2. Avvia l'emulatore e trascina il file APK su di esso per installare l'app.

3. Aprire l'app nell'emulatore, tentare di accedere e prendere nota del messaggio di errore.

4. Nella schermata di errore individuare l'URI di reindirizzamento usato.

5. Se la chiave hash nell'URI contiene caratteri codificati (ad esempio, %2F), decodificarli (%2F diventa /) per ottenere la chiave hash della firma.

6. Copiare la chiave hash della firma decodificata.

7. Nell'interfaccia di amministrazione di Microsoft Entra passare a Registrazioni app e selezionare l'app.

8. In Autenticazione esaminare gli URI di reindirizzamento configurati.

9. Se l'URI di reindirizzamento non è presente, aggiungerlo con l'ID bundle corretto e la chiave hash della firma e quindi salvare le modifiche.

10. Confrontare l'URI di reindirizzamento esistente carattere per carattere (inclusa la distinzione tra maiuscole e minuscole e la codifica) con quello registrato in Microsoft Entra ID.

11. Se si immette manualmente l'ID bundle nel portale, verificare la coerenza del caso.

Procedure consigliate

Per evitare questo errore in futuro:

• Copiare sempre l'ID bundle e la chiave hash direttamente dal progetto o dall'output di compilazione.
• Usare i log di registrazione o dell'emulatore per esaminare l'URI di reindirizzamento esatto in fase di esecuzione.
• Evitare di digitare o modificare manualmente chiavi hash o URI di reindirizzamento.
• Usare Android Studio per verificare la configurazione dell'app.

---

Problema 9: messaggio di errore "Si è verificato un errore [2002]" e il codice di errore 9n155

L'errore può verificarsi quando la registrazione dell'app non è configurata per supportare gli account multi-tenant.

Cause radice comuni

Questo errore si verifica in genere quando viene creata la registrazione dell'app usando la procedura guidata di wrapping, che per impostazione predefinita imposta l'app sulla modalità a tenant singolo. Se l'utente non aggiorna manualmente questa impostazione o seleziona accidentalmente un singolo tenant durante la registrazione manuale dell'app, l'app wrap non è in grado di eseguire l'autenticazione, risultando nel codice di errore 9n155.

Risoluzione

1. Nell'interfaccia di amministrazione di Microsoft Entra passare a Registrazioni app e selezionare l'app.

2. Nella sezione Informazioni di base individuare Tipi di account supportati. Deve essere impostato su Più organizzazioni. In caso contrario, impostalo su Account in qualsiasi directory organizzativa (qualsiasi directory Microsoft Entra - Multitenant).

3. Salvare le modifiche.

---

Altri problemi

Se il problema non è trattato qui o se i passaggi precedenti non risolvono il problema, vedere Passaggi successivi per segnalare il problema. Prepararsi a fornire passaggi dettagliati per riprodurre il problema.

Raccolta di informazioni di diagnostica

Per la risoluzione dei problemi di accesso, è possibile raccogliere i dettagli della sessione:

• Per la procedura guidata di wrapping: nella schermata di accesso toccare l'icona a forma di ingranaggio nell'angolo in alto a destra e selezionare Dettagli della sessione.
• Per i dispositivi mobili: dopo aver aperto l'app, tenere premuto lo schermo e quindi selezionare Dettagli sessione.

Passaggi successivi

Se il problema persiste, cercare altre risorse di supporto o contattare il supporto tecnico Microsoft.