Ultima versione disponibile dell'app: 7.8.1
Introduzione
Il presente articolo descrive le procedure necessarie per configurare un'app mobile di marca mediante la sezione Generatore di app mobile personalizzate della piattaforma. Le impostazioni disponibili in questa pagina consentono di personalizzare l'aspetto, le funzionalità e le capacità delle applicazioni personalizzate per Android e iOS.
- È possibile salvare le impostazioni durante il processo e riprenderne la configurazione in un momento successivo.
- Una volta completata la configurazione, è possibile generare le build delle app direttamente dalla medesima pagina.
È consentita la creazione di più app di marca. Per gli utenti di Extended Enterprise, Docebo raccomanda di creare un'app di marca dedicata a ciascun sottodominio.
Prerequisiti: ID app, link degli store e Firebase
Prima di procedere con la configurazione di un'app nella sezione Generatore di app mobile personalizzate, è necessario aver completato i seguenti passaggi:
- Selezionare un ID univoco per l'app mobile di marca, preferibilmente utilizzando la notazione a dominio inverso (ad esempio,
com.docebo.mobile). Tale ID corrisponderà al packageId per Android e al bundleID per iOS. Si raccomanda di mantenere lo stesso ID per entrambe le piattaforme, anche se non è obbligatorio.
Il nome del package non deve contenere parole chiave presenti nell'elenco delle parole chiave Java (si apre in una nuova scheda). - Definire il nome pubblico dell'app mobile, che sarà identico per le versioni Android e iOS. Si raccomanda di verificare che il nome scelto non sia già presente nel Google Play Store o nell'Apple App Store.
-
Per ciascun store, tramite Google Play Console o App Store Connect, è necessario creare l'app (senza caricare alcuna build in questa fase). Durante la procedura, verrà richiesto di inserire l'ID scelto e sarà generato un Store Link simile ai seguenti:
https://play.google.com/store/apps/details?id=com.docebo.mobilehttps://apps.apple.com/us/app/go-learn/id1362542319
Questo passaggio può essere omesso se non si intende distribuire l'app tramite tali store.
La creazione preliminare delle app consente di garantire l'unicità dell'ID scelto.
Suggerimento: Annotare l'ID app e i link degli store, poiché saranno necessari nelle fasi successive della configurazione.
Nota bene: Nel caso in cui si preveda di distribuire l'app di marca tramite Mobile Device Management (MDM) o altri metodi alternativi ai Google Play Store o Apple App Store, è comunque necessario creare il packageID nella Google Play Console e il bundleID in Apple Store Connect. In tale scenario non è necessario creare la scheda dell'app né disporre di un link dello store.
Inoltre, per abilitare funzionalità quali notifiche push, accesso tramite Google o Google Analytics, si consiglia di completare preliminarmente le procedure illustrate nell'articolo Configurazione di Firebase per app mobile di marca.
Token
La creazione di una nuova app mobile di marca richiede un token, acquistabile tramite il proprio Account Manager. I token acquisiti rimangono associati alla piattaforma e possono essere utilizzati per la creazione di più app di marca.
- È necessario un token per ciascuna app di marca; un singolo token copre entrambe le versioni iOS e Android.
- Il token è richiesto esclusivamente al momento della creazione di una nuova app di marca e non per gli aggiornamenti successivi.
- Premendo il pulsante + per creare una nuova app mobile, la finestra di dialogo Nuova app mobile personalizzata indicherà il numero di token disponibili.
- È possibile eliminare app non più necessarie per liberare i relativi token.
Nel caso di pubblicazione di più app, ad esempio per i sottodomini dell'extended enterprise, sarà necessario un token per ciascuna app.
Pagina del generatore di app mobile personalizzate
Per accedere alla pagina del generatore di app di marca, navigare in Menu di navigazione > Personalizzazione (icona a chiave inglese) > Generatore di app mobile personalizzate.
In questa sezione saranno elencate tutte le app mobile esistenti, con la possibilità di visualizzare le ultime build generate per iOS e Android e verificarne la conformità all'ultima versione disponibile.
È possibile selezionare un'app esistente per modificarne o completarne la configurazione (vedere Modificare o eliminare un'app di marca), oppure cliccare sul pulsante + Crea app per avviare la creazione di una nuova app.
Creare una nuova app di marca
Per configurare una nuova app mobile di marca, seguire i passaggi seguenti:
- Accedere a Menu di navigazione > Personalizzazione (icona a chiave inglese) > Generatore di app mobile personalizzate.
-
Quindi, nell'angolo superiore destro della pagina, cliccare sul pulsante + Crea app. Nella finestra di dialogo, verificare la disponibilità del token necessario e procedere cliccando su Crea app.
- Nel pannello Crea una nuova app di marca? che si apre, inserire le seguenti informazioni:
-
URL della piattaforma: Inserire l'indirizzo web completo della piattaforma di apprendimento a cui l'app si collega. Può essere un URL
docebosaasoppure un dominio personalizzato, se configurato. Nel caso di extended enterprise, selezionare l'URL del cliente desiderato o il relativo sottodominio, se applicabile. - Nome app: Indicare il nome pubblico scelto per l'app, che sarà visibile agli utenti e identico per le versioni Android e iOS. Assicurarsi che il nome sia univoco e non presente nel Google Play Store o Apple App Store.
- Sistemi operativi: Selezionare se si desidera creare un'app per iOS, Android o entrambe.
-
URL della piattaforma: Inserire l'indirizzo web completo della piattaforma di apprendimento a cui l'app si collega. Può essere un URL
- Al termine, cliccare su Crea app.
Si aprirà una pagina dedicata alla configurazione completa della nuova app di marca, suddivisa in tre aree principali: Branding, Impostazioni e Sicurezza.
È possibile iniziare la configurazione dell'app consultando i capitoli relativi a Dettagli, Branding, Impostazioni app iOS, Impostazioni app Android, Servizi Firebase, Sicurezza. I progressi possono essere salvati in qualsiasi momento tramite il pulsante Salva le modifiche. Per riprendere o modificare la configurazione, è sufficiente selezionare l'app dalla pagina Generatore di app mobile personalizzate.
Generare le build e caricare negli store
Al termine della configurazione dell'app mobile di marca, cliccare su Salva le modifiche per memorizzare le impostazioni. Successivamente, si può procedere con la generazione delle build.
- Se sono state configurate entrambe le versioni iOS e Android, è possibile scegliere se generare la build per una sola o per entrambe le piattaforme.
- Se sono stati configurati gli Aggiornamenti diretti per le app iOS o Android, sarà possibile generare e caricare la build in un'unica operazione.
Per ulteriori dettagli, consultare l'articolo Configurare gli aggiornamenti diretti per l'app mobile di marca.
Procedura per generare le build:
Nell'angolo superiore destro della pagina di configurazione dell'app di marca, cliccare sul pulsante Genera build.
Nella finestra che si apre, selezionare le versioni dell'app per le quali si desidera generare le build: iOS, Android o entrambe.
Suggerimento: Nel caso in cui sia stata configurata una sola versione dell'app, sarà disponibile un'unica opzione (solo iOS o solo Android).
Il sistema indicherà per ogni build se essa sarà automaticamente rifirmata e inviata allo store (in caso di Aggiornamenti diretti configurati) oppure se sarà necessario firmarla manualmente e caricarla nello store (in assenza di Aggiornamenti diretti).
Quando pronti, cliccare sul pulsante Genera build o Genera e carica le build per avviare il processo.
Il sistema inizierà la generazione del pacchetto o dei pacchetti dell'app, in base alle piattaforme selezionate. Il processo potrebbe richiedere diverse ore (fino a 8 ore).
Nota bene: La generazione della build potrebbe fallire se avviata durante il processo di rilascio settimanale o mensile di Docebo. In tal caso, si consiglia di riprovare al termine del rilascio.
È possibile monitorare l'avanzamento tramite la barra posta nella parte superiore della pagina di configurazione dell'app di marca:
- Al clic sul pulsante Genera build/Genera e carica le build, lo stato cambierà in Preparazione delle build... Build richiesta.
- Al completamento del processo, verrà mostrato il risultato (build generata o build generata e inviata allo store) per ciascuna versione. Si riceverà inoltre una notifica via email.
-
Se una build è stata generata e inviata allo store, il processo si è concluso con successo, con firma e invio automatico. Non sono necessarie ulteriori azioni.
Suggerimento: È comunque possibile scaricare una copia locale della build tramite il pulsante Scarica build, tenendo presente che tale build non sarà rifirmata.
- Nel caso in cui la build sia stata solo generata, sarà necessario scaricare il pacchetto, firmarlo manualmente e caricarlo nello store.
Procedura per la firma manuale e il caricamento nello store:
Ripetere i passaggi seguenti per ciascuna versione dell'app (iOS e Android) non inviata automaticamente.
Una volta disponibile la build, nella barra dei risultati in alto nella pagina di configurazione, cliccare sul link Scarica build per effettuare il download.
Suggerimento: È possibile visualizzare la cronologia delle build precedenti e scaricare l'ultima utilizzando il pulsante Gestisci build.
Successivamente, occorre rifirmare il pacchetto per sostituire la firma digitale temporanea applicata da Docebo e caricare manualmente la build firmata negli store, seguendo le indicazioni presenti in Rifirmare e pubblicare l'app mobile di marca.
Nota bene: Il pacchetto deve essere scaricato entro la data di scadenza indicata; in caso contrario sarà necessario rigenerare la build.
Gestire gli errori durante la build
In caso di errori durante la generazione o il caricamento della build, la barra dei risultati mostrerà un messaggio indicante la fase in cui si è verificato il problema. Tali informazioni saranno riportate anche nell'email di notifica.
- Errore durante la generazione della build: la build non può essere generata. Si consiglia di verificare le impostazioni del generatore personalizzato o contattare il centro assistenza. In questo caso non sarà disponibile alcuna build da scaricare.
- Errore durante il rinnovo della firma della build: la build è stata generata correttamente, ma si è verificato un errore nella rifirma automatica. È comunque possibile scaricare il pacchetto non firmato per procedere con la rifirma e il caricamento manuale.
-
Errore durante il caricamento della build sullo store: la build è stata generata e rifirmata correttamente, ma il caricamento nello store è fallito. Si raccomanda di verificare le impostazioni degli Aggiornamenti diretti e riprovare, oppure scaricare la build per la rifirma e il caricamento manuale.
Nota bene: Il pacchetto scaricato sarà sempre non firmato e richiederà rifirma, anche se la firma automatica è stata completata con successo.
Modificare o eliminare un'app di marca
Nella sezione Generatore di app mobile personalizzate sono elencate tutte le app di marca create. Per modificare o eliminare un'app, selezionare l'icona dei tre puntini posta alla fine della riga corrispondente e scegliere l'opzione desiderata dal menu a discesa.
Ogni modifica richiede la generazione di una nuova build. Al termine del processo, sarà inviata una notifica via email.
Procedura per modificare un'app di marca:
- Cliccare sull'icona dei tre puntini nella riga dell'app e selezionare Modifica.
- Apportare le modifiche necessarie nelle impostazioni di Dettagli app, Branding, Impostazioni app iOS, Impostazioni app Android, Servizi Firebase e Sicurezza.
-
Al termine, cliccare su Salva le modifiche.
Nota bene: Dopo aver aggiornato le impostazioni, è necessario generare una nuova build e procedere con il caricamento agli store per rendere effettive le modifiche.
Procedura per eliminare un'app di marca:
- Cliccare sull'icona dei tre puntini nella riga dell'app e selezionare Elimina.
- Nella finestra di conferma, cliccare nuovamente su Elimina per rimuovere l'app dalla sezione Generatore di app mobile personalizzate. Si ricorda che questa operazione non rimuove l'app dagli store, che dovranno essere gestiti separatamente.
Nota bene: In caso di eliminazione e successiva necessità di riutilizzo dell'app, sarà necessario riconfigurare completamente tutte le impostazioni nella pagina del generatore personalizzato.
Aggiornare l'app di marca
Anche in assenza di modifiche alle impostazioni, è necessario generare e distribuire periodicamente nuove build per incorporare gli ultimi aggiornamenti basati sulla versione più recente del codice sorgente. Le build nel generatore di app mobile personalizzate sono sempre generate utilizzando l'ultima versione disponibile del codice base.
Verificare gli aggiornamenti:
Le nuove versioni di Go.Learn e dell'app mobile di marca vengono comunicate nella pagina degli aggiornamenti prodotto.
È possibile controllare gli aggiornamenti direttamente nella pagina del generatore personalizzato:
- La colonna Ultima versione indica l'ultima versione rilasciata di Go.Learn e dell'app mobile di marca.
- Le colonne Build iOS e Build Android mostrano la versione dell'ultima build generata, con un'icona di avviso in caso di necessità di aggiornamento.
Procedura di aggiornamento:
Quando è disponibile una versione più recente, per fornire l'aggiornamento agli utenti è necessario generare nuove build per le app iOS e Android e caricarle negli store seguendo i passaggi descritti nel capitolo Generare le build e caricarle negli store.
Nota bene:
- L'aggiornamento dell'app di marca non è obbligatorio, ma è fortemente consigliato per garantire l'utilizzo della versione più affidabile e completa, con tutte le funzionalità introdotte nelle ultime release di Go.Learn.
- Docebo fornisce supporto prodotto esclusivamente per l'ultima versione dell'app mobile.
Revisionare i dettagli dell'app
Dopo la creazione dell'app, è possibile rivedere il nome e l'URL della piattaforma inseriti in fase di creazione, oltre a specificare un indirizzo email per ricevere le notifiche di build:
Per effettuare queste operazioni, accedere alla pagina del generatore personalizzato dell'app e selezionare Impostazioni > Dettagli.
Nota bene: La modifica del nome dell'app comporta la creazione di una nuova app separata. Dopo la creazione della scheda nello store e la configurazione dell'app di marca, la modifica del nome richiederà la creazione di una nuova scheda e la riconfigurazione completa.
Personalizzare il branding dell'app
Nell'area Branding della pagina del generatore personalizzato, è possibile personalizzare l'aspetto dell'app di marca.
Per accedervi, selezionare Menu di navigazione > Personalizzazione (icona a chiave inglese) > Generatore di app mobile personalizzate > [nome app].
In questa sezione è possibile configurare l'icona dell'app, la schermata iniziale (Splash screen), il menu Drawer e la pagina Prelogin.
Dimensioni immagini per icona app e icona splash screen:
Le immagini destinate all'icona launcher e all'icona splash screen devono avere dimensioni di 1024x1024 px a 72 DPI.
Il formato richiesto è PNG a 32 bit:
- con canale alfa per Android;
- senza canale alfa per iOS.
La dimensione massima del file non deve superare i 4 MB.
Si raccomanda di centrare l'icona all'interno del quadrato di 1024 px, come illustrato nelle sezioni seguenti.
App icon
L'app icon rappresenta l'immagine visualizzata sulla schermata del dispositivo, tramite cui gli utenti avviano l'app.
Generalmente, su Android si utilizzano icone di forma rotonda, mentre su iOS icone quadrate con angoli arrotondati. Per evitare ritagli, si consiglia di centrare l'icona all'interno di un cerchio di diametro 1024 px, come illustrato di seguito.
Splash screen
La splash screen è l'immagine visualizzata subito dopo l'avvio dell'app, durante il caricamento. Generalmente riporta il branding o il logo aziendale. Per evitare ritagli, il logo dovrebbe essere posizionato all'interno di un cerchio centrato di diametro 832 px, come illustrato di seguito.
Pagina Prelogin
Nel caso di app mobile a dominio aperto, è disponibile la sezione Immagine sfondo pre-login, dove è possibile caricare l'immagine di sfondo della schermata di benvenuto in cui l'utente inserisce l'URL della piattaforma.
Le dimensioni dell'immagine devono essere 720x1280 px (orientamento verticale per dispositivi mobili) a 72 DPI, in formato PNG a 32 bit con canale alfa. La dimensione massima del file è 4 MB.
Impostazioni app iOS
Nella sezione Impostazioni > App iOS della pagina del generatore personalizzato, è possibile abilitare e configurare la versione iOS dell'app di marca.
Se non si è abilitata iOS durante la creazione dell'app, è possibile farlo ora selezionando la casella Abilita app mobile iOS.
Le impostazioni configurabili in questa sezione sono specifiche per l'app iOS:
iOS > Modalità app di lettura
La modalità app di lettura è richiesta dalle linee guida Apple per consentire l'accesso a contenuti acquistati esternamente all'app.
- Questa modalità assicura la conformità alle linee guida Apple per l'e-commerce (contenuti a pagamento) (si apre in una nuova scheda) ed evita il rifiuto dell'app da parte dell'Apple App Store.
Abilitando la modalità app di lettura, gli utenti potranno accedere ai contenuti acquistati precedentemente tramite la versione desktop della piattaforma.
Si segnala che in modalità lettore non è possibile creare account utente direttamente nell'app mobile; pertanto, se è consentita la registrazione autonoma, gli utenti dovranno registrarsi tramite la piattaforma desktop.
iOS > Link store
Inserire l'URL della pagina dell'app di marca nell'Apple App Store.
Esempio:
https://apps.apple.com/us/app/go-learn/id1362542319
Il campo può essere lasciato vuoto se non si intende distribuire l'app tramite gli store.
iOS > Universal link
L'universal link è un URL che consente di aprire l'app di marca su una schermata specifica anziché nel browser.
Per abilitare questa funzionalità, selezionare la casella Abilita universal link e inserire il App ID.
Recuperare l'ID app
L'ID app è reperibile nella Apple Developer's Console (si apre in una nuova scheda), nella sezione Certificates, Identifiers & Profiles.
Il valore dell'App ID è costituito dal team ID o prefisso app ID seguito dal bundle ID, separati da un punto, con formato: teamID.bundleID, ad esempio: ABCD1234.com.apple.wwdc.
Nell'esempio riportato in figura, il valore da inserire nel campo App ID è:
9YR6YH8KLL.com.mycompany.myapp.clientVerificare abilitazione Associated Domains
Nella pagina Certificates, Identifiers & Profiles, nella scheda Capabilities, verificare che la capacità Associated Domains sia abilitata.
Ulteriori informazioni sui domini associati (si apre in una nuova scheda).
iOS > Accesso demo
La funzionalità di accesso demo consente agli utenti di provare l'app senza creare un account. È necessario configurare un account specifico sulla piattaforma con permessi limitati da utilizzare come account demo.
Per abilitare questa funzione, selezionare la casella Abilita accesso demo iOS e inserire le credenziali dell'account demo nei campi Nome utente demo e Password demo.
iOS > Formato pacchetto
Selezionare il formato della build dell'app iOS. Il formato IPA è raccomandato per distribuzione e test, mentre XArchive è indicato per test manuali o flussi di lavoro avanzati con Xcode.
iOS > Aggiornamenti diretti
È possibile configurare opzionalmente l'invio automatico degli aggiornamenti dell'app agli store direttamente dalla pagina Generatore di app mobile personalizzate, evitando la rifirma e il caricamento manuale di ogni nuova build.
Nota bene: Questa configurazione può essere aggiunta anche in un secondo momento.
Una volta configurati, gli aggiornamenti diretti assicurano che ogni build generata venga automaticamente rifirmata e inviata allo store.
Per dettagli, consultare l'articolo Configura aggiornamenti diretti per l'app mobile di marca.
Impostazioni app Android
Nella sezione Impostazioni > App Android della pagina del generatore personalizzato, è possibile abilitare e configurare la versione Android dell'app di marca.
Se non si è abilitata Android durante la creazione dell'app, è possibile farlo ora selezionando la casella Abilita app mobile Android.
Le impostazioni configurabili in questa sezione sono specifiche per l'app Android:
Android > Link dello store
Inserire l'URL della pagina dell'app di marca nel Google Play Store.
Esempio:
https://play.google.com/store/apps/details?id=com.docebo.mobile
Il campo può essere lasciato vuoto se non si intende distribuire l'app tramite gli store.
Android > Nome del package
Inserire il packageID Android, ad esempio com.docebo.mobile.
Android > Link app
Un app link è un URL che consente di aprire l'app di marca su una schermata specifica.
Per abilitare questa funzionalità, selezionare la casella Abilita link app e inserire nel campo Impronta digitale certificato SHA l'impronta SHA256 del certificato di firma.
Per recuperare l'impronta, accedere alla Google Play Console (si apre in una nuova scheda) e navigare nella sezione Integrità app. Nella sezione Digital Asset Links JSON, copiare il valore sotto sha256_cert_fingerprints.
Android > Formato pacchetto
Selezionare AAB (Android App Bundle) per la pubblicazione nel Google Play Store.
Nota importante: Dal mese di agosto 2021, Google Play (si apre in una nuova scheda) richiede che tutte le nuove app e gli aggiornamenti siano pubblicati in formato Android App Bundle (AAB).
È comunque possibile selezionare Android Package (APK) se si prevede di distribuire l'app tramite sistemi Mobile Device Management (MDM) anziché dal Google Play Store pubblico.
Android > Aggiornamenti diretti
È possibile configurare opzionalmente l'invio automatico degli aggiornamenti agli store dalla pagina Generatore di app mobile personalizzate, evitando la rifirma e il caricamento manuale di ogni nuova build.
Nota bene: Questa configurazione può essere aggiunta anche successivamente.
Una volta configurati, gli aggiornamenti diretti assicurano la rifirma automatica e l'invio della build allo store ad ogni generazione.
Per istruzioni dettagliate, consultare l'articolo Configura aggiornamenti diretti per l'app mobile di marca.
Servizi Firebase (notifiche push, accesso Google, Analytics)
Per abilitare funzionalità quali Firebase Messaging (notifiche push o messaggistica in-app), accesso Google o Google Analytics, è necessario configurare la sezione Servizi.
- Le impostazioni specifiche dipenderanno dai servizi che si intendono utilizzare.
- Se tali funzionalità non sono necessarie, è possibile lasciare deselezionata la casella Abilita servizi Firebase.
Prerequisito: Completare i passaggi descritti in Configurazione di Firebase per l'app mobile di marca prima di procedere.
Nella pagina del generatore personalizzato, selezionare Impostazioni > Servizi e attivare la casella Abilita servizi Firebase.
Per tutti i servizi Firebase, è necessario caricare il file di configurazione dei servizi Google ottenuto da Firebase. I file da caricare variano in base alle versioni dell'app:
- Per l'app iOS, caricare il file GoogleService-Info.plist.
- Per l'app Android, caricare il file google-services.json.
Sotto Impostazioni Firebase, selezionare i servizi da abilitare. Almeno un servizio deve essere attivato.
Se non si desiderano utilizzare questi servizi, deselezionare la casella Abilita servizi Firebase.
Abilitazione notifiche push:
Per utilizzare notifiche push o Google Analytics, selezionare questa opzione e inserire l'ID progetto Firebase e caricare il file chiave account di servizio Firebase.
Per dettagli su come ottenerli, consultare l'articolo Configurazione di Firebase per app mobile di marca > Ottenere ID progetto Firebase e file chiave account di servizio.
Abilitazione accesso Google:
Selezionare questa opzione per abilitare l'accesso Google nell'app. Inserire il Web client ID del progetto Firebase e, se si dispone di un'app iOS, anche il client ID iOS.
Per informazioni su come ottenerli, consultare l'articolo Configurazione di Firebase per app mobile di marca > Abilitare accesso Google.
Impostazioni di sicurezza
Nell'area Sicurezza è possibile configurare impostazioni relative alla privacy dei dati, autenticazione e monitoraggio dell'utilizzo.
Sotto Sicurezza > Protezione dati si possono configurare il Certificate pinning e l'uso dell'app in Cina.
Sotto Sicurezza > Tracciamento è possibile configurare il partner di misurazione mobile Adjust (MMP).
Certificate pinning
Il certificate pinning è una tecnica volta a proteggere app web e mobile da certificati malevoli, assicurando che i dati di rete non vengano compromessi anche in presenza di certificati root fraudolenti installati sul dispositivo. Tale tecnica rafforza la sicurezza contro attacchi di phishing e man-in-the-middle.
Implementando il certificate pinning, si integra nell'app l'impronta digitale (digest) del certificato utilizzato dai servizi backend, permettendo di rilevare tempestivamente eventuali attacchi informatici.
Per abilitarlo, selezionare l'opzione Abilita certificate pinning e inserire nel campo Digest il digest del certificato HTTPS in formato SHA-256 Pin.
- Per recuperare il digest, si consiglia di rivolgersi al responsabile della sicurezza aziendale.
- In alternativa, è possibile utilizzare il servizio online gratuito https://www.ssllabs.com/ssltest/ (si apre in una nuova scheda), che analizza la configurazione SSL di qualsiasi server web.
-
Si ricorda che, in caso di rilascio di un nuovo certificato digitale, è necessario aggiornare l'impronta nel campo Digest e rigenerare l'app.
Nota bene: L'abilitazione del certificate pinning implica la responsabilità di gestire il ciclo di vita del certificato. Se il certificato cambia senza aggiornamento del digest e rigenerazione dell'app, quest'ultima non sarà in grado di connettersi alla piattaforma e rimarrà bloccata sulla schermata di caricamento per tutti gli utenti. Si consiglia di annotare le scadenze del certificato e pianificare la rigenerazione dell'app di conseguenza. Per ulteriori dettagli, consultare Rinnovo del certificato SSL senza downtime dell'app.
Recupero del digest tramite SSL Labs
Per ottenere il digest tramite SSL Labs, seguire i passaggi indicati di seguito (Docebo non si assume responsabilità per eventuali modifiche al processo da parte di SSL Labs):
- Inserire l'URL della piattaforma Docebo nel campo Hostname e cliccare su Submit. L'URL deve corrispondere a quello impostato nel campo Domain URL nella pagina Generatore di app mobile personalizzate.
- Attendere il completamento dell'analisi, quindi cliccare sull'indirizzo IP visualizzato nella colonna Server. In caso di più risultati, selezionare il primo.
- Nella pagina del report SSL, individuare il digest del certificato nella sezione Subject della casella Certificate.
- Copiare la stringa Pin SHA256 e incollarla nel campo Digest nella sezione Certificate Pinning sulla piattaforma Docebo, evitando spazi vuoti iniziali o finali.
Rinnovo del certificato SSL senza interruzioni del servizio
Per rinnovare o sostituire il certificato SSL senza interrompere l'accesso all'app, seguire la procedura indicata:
Ottenere il nuovo certificato dal fornitore e caricarlo sulla piattaforma senza rimuovere il certificato esistente in scadenza. Entrambi i certificati devono essere assegnati contemporaneamente al dominio durante il periodo di transizione.
Generare il digest del nuovo certificato utilizzando il comando:
openssl x509 -in certificate.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | openssl enc -base64In alternativa, è possibile recuperare il digest da SSL Labs.
Aggiornare il campo Digest nella sezione Certificate pinning della configurazione dell'app di marca, quindi generare nuove build per iOS e Android e pubblicarle negli store.
Dopo la pubblicazione delle nuove build e l'aggiornamento da parte degli utenti, è possibile rimuovere in sicurezza il vecchio certificato.
Nota bene: La rimozione anticipata del vecchio certificato può causare il blocco dell'app sulla schermata di caricamento per gli utenti che non hanno ancora aggiornato. Si consiglia di prevedere un intervallo temporale tra la pubblicazione della nuova build e la rimozione del certificato per consentire la revisione degli store e l'adozione da parte degli utenti.
Uso dell'app in Cina
Per ottimizzare le prestazioni dell'app in Cina, inclusi gli utenti che vi soggiornano temporaneamente, selezionare l'opzione Abilita uso app in Cina.
Integrazione Adjust MMP
Per misurare e analizzare il ritorno sull'investimento delle campagne promozionali su diverse reti pubblicitarie e social media, è possibile integrare la piattaforma con Mobile Measurement Partners (MMP) come Adjust.
Gli MMP raccolgono e standardizzano i dati delle app mobile per fornire una valutazione uniforme delle performance delle campagne.
Adjust (si apre in una nuova scheda) può essere integrato con il Generatore di app mobile personalizzate di Docebo. Per abilitare Adjust, selezionare Abilita integrazione Adjust e inserire il token app generato nella dashboard di Adjust.
Nota bene: Durante la pubblicazione sull'Apple App Store, verranno richieste informazioni sulla privacy relative ai dati raccolti dall'app. Per compilare correttamente il modulo, consultare la Knowledge Base di Adjust (si apre in una nuova scheda) e il PDF allegato al capitolo Note importanti sul processo di pubblicazione dell'articolo della Knowledge Base relativo alla pubblicazione di un'app di marca.