Aggiungere e registrare un'app

L'aggiunta di un riferimento URL a un'app esistente è un metodo efficace per condividere il lavoro con i membri dell'organizzazione e il pubblico (a seconda dei privilegi di condivisione). Oltre all'URL, è possibile condividere altri dettagli, ad esempio il tipo dell'app, il relativo scopo, un riepilogo e una descrizione, nonché un file .zip con il codice utilizzato per crearla. Aggiungendo un'app a ArcGIS Online viene aggiunto solamente un riferimento all'URL dell'app; ArcGIS Online non memorizza i file dell'app.

Gli sviluppatori di app che dispongono di un account dell'organizzazione possono inoltre registrare le app con la piattaforma. Il processo include la registrazione di un'applicazione OAuth in modo che i membri dell'organizzazione e gli utenti esterni possano accedere all'app. Per ulteriori informazioni, consultare la sezione Aggiungere e registrare un'app usando le credenziali di sviluppatore.

Se non è necessario registrare l'app, ad esempio quando si carica un campione di codice, seguire i passaggi riportati nella sezione Aggiungere un'app da un URL seguente.

Suggerimento:

Un altro modo per condividere le app con i membri dell'organizzazione e il pubblico consiste nel creare app con mappe e app galleria con gruppi.

Aggiungi un'app da un URL

Segui questa procedura per aggiungere un elemento che utilizza un URL per l'accesso a un'app sul Web ma che non necessita di essere registrata (ad esempio i campioni di codice):

Nota:

Per aggiungere un'app registrata, seguire i passaggi per aggiungere e registrare un'app usando credenziali sviluppatore.

  1. Verificare di avere effettuato l'accesso e di disporre dei privilegi per creare contenuti.
  2. Dalla scheda I miei contenuti della pagina dei contenuti, fare clic su Nuovo elemento, quindi fare clic su Applicazione.
  3. Scegliere il tipo di app:
    • Mappatura Web - Un'app Web creata con un'API Web, ad esempio JavaScript.
    • Desktop: un app per desktop creata su una piattaforma desktop, ad esempio Java o .NET (Desktop Microsoft Windows).
    • Mobile: un'applicazione scaricabile creata per dispositivi mobili con un SDK, come iOS o Android.
    • Altra applicazione: un'applicazione desktop, script Python o qualunque tipo di app generica per cui non si dispone dei dettagli su API, SDK, indirizzo URL o scopo dell'applicazione.
  4. Per il mapping web, desktop o mobile, digitare l'URL dell'app, per esempio,https://<myServer>/myWebMapApp.
  5. Per le app desktop, fare clic su Sfoglia e scegliere il .zip file che contiene l'app.
  6. Fare clic su Avanti.
  7. Digitare il titolo.
  8. In I miei contenuti scegliere una cartella in cui salvare l'elemento.
  9. Se la propria organizzazione ha configurato categorie di contenuti, fare clic su Assegna categorie e selezionare fino a 20 categorie in modo che le persone possano individuarle facilmente.

    È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.

  10. Opzionalmente, scrivi dei tag che descrivono l'elemento.

    Separare i termini con virgole, ad esempio Parco nazionale è un tag, mentre Parco, nazionale sono due tag.

    Mentre si digita, è possibile selezionare uno qualsiasi dei tag suggeriti che vengono visualizzati; i suggerimenti vengono generati dai tag aggiunti in precedenza.

  11. Opzionalmente, aggiungi un sommario che descriva l'applicazione.
  12. Fare clic su Salva.

Quando l'app viene aggiunta, appare nei tuoi contenuti. Se è necessario registrarla in un secondo momento, è possibile farlo dalla scheda Impostazioni della pagina elemento dell'app. Per ulteriori informazioni, consultare la sezione Aggiungere e registrare un'app utilizzando le credenziali di sviluppatore.

È possibile configurare i dettagli dell'elemento, allegare codice se necessario e condividere l'app se si dispone di privilegi di condivisione.

Aggiungere e registrare un'app utilizzando le credenziali dello sviluppatore

Gli sviluppatori di app che dispongono di un account aziendale possono aggiungere e registrare l'app con la piattaforma per generare un ID app. Utilizzare l'ID app per raccogliere statistiche sull'utilizzo e consentire agli utenti di effettuare l'accesso alla piattaforma con OAuth 2.0, un framework di autorizzazione standardizzato. Con OAuth 2.0, le app guidano l'utente ad accedere alla piattaforma tramite una pagina login ospitata dalla piattaforma. Consente inoltre all'app di utilizzare i contenuti dell'utente associati alla relativa organizzazione, nonché di sfruttare altre ArcGIS Online funzionalità quali la geocodifica, il routing e il GeoEnrichment. Per scoprire di più sull'autenticazione e OAuth 2.0, vedere Esri Developer.

Il tipo di credenziali sviluppatore che possono essere incluse nell'app dipende dai propri privilegi nell'organizzazione. Se si è membri del ruolo amministratore predefinito o del ruolo personalizzato con il privilegio di generare chiavi API, è possibile utilizzare una credenziale OAuth 2.0 o di chiave API nell'app. Altrimenti è possibile utilizzare solo le credenziali sviluppatore OAuth 2.0.

Nota:

Lo schema di implementazione per l'accesso degli utenti varia lievemente a seconda che tu stia sviluppando un'app basata sul web o un'app nativa. La documentazione di Esri Developer include dettagli ed esempi di codice per applicazioni sia basate sul web che native.

Aggiungere e registrare un'app con credenziali OAuth 2.0 incorporate

Quando si utilizzano le credenziali OAuth 2.0 con le app create, il token per accedere è generato in modo dinamico all'accesso dell'app. Il token di accesso è valido per un massimo di 14 giorni.

Procedere come indicato nei passaggi seguenti se il proprio ruolo non comprende il privilegio per creare chiavi API.

  1. Verificare di avere effettuato l'accesso con un account aziendale che il privilegio per creare contenuti.
  2. Fare clic sulla scheda I miei contenuti della pagina dei contenuti, quindi fare clic su Nuovo elemento.
  3. Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
  4. A seconda dei privilegi posseduti nell'organizzazione la visualizzazione della prima finestra potrà essere differente. Se si è membri di un ruolo che non comprende il privilegio per creare chiavi API, continuare con il passaggio 5. Se il proprio ruolo include i privilegi per creare chiavi API, continuare con il passaggio 4.
  5. Scegliere l'opzione Credenziali OAuth 2.0 e fare clic su Avanti.
  6. In URL di reindirizzamento, inserire l'URL di una pagina Web o endpoint server che verrà utilizzato per reindirizzare gli utenti dopo aver completato l'accesso. Fare clic su Aggiungi per aggiungere altri URL di reindirizzamento se necessario.

    Gli URL di reindirizzamento specificati durante l'autorizzazione devono corrispondere a uno degli URL registrati, altrimenti l'autorizzazione verrà negata.

    Può essere specificato il valore speciale urn:ietf:wg:oauth:2.0:oob per garantire le autorizzazioni. Ciò consente di consegnare il codice di autorizzazione a un URL del portale (/oauth2/approval). Questo valore viene tipicamente utilizzato dalle app che non dispongono di un server Web o uno schema URL personalizzato in cui il codice può essere consegnato.

    Di seguito sono riportati alcuni esempi di formati di URL di reindirizzamento supportati:

    • https://app.foo.com
    • urn:ietf:wg:oauth:2.0:oob

  7. In URL referrer, inserire un'URL o l'indirizzo IP a cui è consentito connettersi. Fare clic su Aggiungi per aggiungere altri URL referrer o indirizzi IP in base alle necessità.
  8. In Ambiente applicazione, scegliere un'ambiente applicazione per l'app: Multiplo, Nativo, Browser o Server.
  9. Nella casella URL, digitare un URL per l'app nel formato https://<myServer>/myWebMapApp.
  10. Fare clic su Avanti.

    Se si è membri di un ruolo con il privilegio di assegnare privilegi ad applicazioni OAuth 2.0, facendo clic su Avanti si passa a una finestra dove è possibile definire ciò che l'app potrà effettuare. Se non si è possesso di questo privilegio continuare con il passaggio 12.

  11. Scegliere quali azioni l'app potrà svolgere in virtù delle credenziali assegnando i privilegi e facendo clic su Avanti.

    L'elenco dei privilegi disponibili varia in funzione del possesso o meno di un abbonamento ad ArcGIS Location Platform e dei privilegi che si possiede nell'organizzazione. Non è possibile garantire privilegi che il proprio account non possiede.

  12. Fare clic su Sfoglia elementi e scegliere a quali elementi le credenziali integrate consentiranno l'accesso e fare clic su Aggiungi elementi.

    In alternativa, è possibile fare clic su Salta. Se si salta il passaggio in cui si specifica a quali elementi possono accedere gli utenti con credenziali OAuth 2.0, le credenziali possono essere utilizzate per accedere a tutti gli elementi di cui si è in possesso.

  13. Digitare il titolo.
  14. In I miei contenuti scegliere una cartella in cui salvare l'elemento.
  15. Se la propria organizzazione ha configurato categorie di contenuti, fare clic su Assegna categorie e selezionare fino a 20 categorie in modo che le persone possano individuarle facilmente.

    È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.

  16. Opzionalmente, scrivi dei tag che descrivono l'elemento.

    Separare i termini con virgole, ad esempio Parco nazionale è un tag, mentre Parco, nazionale sono due tag.

    Mentre si digita, è possibile selezionare uno qualsiasi dei tag suggeriti che vengono visualizzati; i suggerimenti vengono generati dai tag aggiunti in precedenza.

  17. Opzionalmente, aggiungi un sommario che descriva l'applicazione.
  18. Fare clic su Avanti.
  19. Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento. Se le impostazioni delle credenziali sono corrette, fare clic su Crea.

L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge credenziali OAuth 2.0 indicante che le credenziali OAuth 2.0 sono utilizzate con l'app appare sulla pagina dell'elemento e quando l'elemento è visualizzato dalla pagina contenuti o dal riquadro anteprima elemento.

È possibile configurare i dettagli dell'elemento per l'app.

Dalla scheda Impostazioni della pagina elemento dell'app, è possibile visualizzare le informazioni di registrazione, che includono l'ID app (Client ID), un segreto app (Client Secret) e gli ambienti dell'applicazione. È possibile aggiornare l'URL dell'origine dati o gli URL di reindirizzamento, reimpostare il segreto, annullare la registrazione dell'app o copiare o rinnovare il token temporaneo dell'app. È possibile inoltre modificare i privilegi posseduti dall'app e i layer a cui l'app può accedere.

Nota:

La reimpostazione del segreto dell'app renderà nulli tutti i token utente e app esistenti emessi per l'app. Gli utenti dovranno accedere nuovamente all'app e potrebbe essere necessario aggiornare le app configurate con il segreto.

Fare clic su Visualizza utilizzo nella scheda Impostazioni per visualizzare le informazioni riguardanti gli utenti che hanno effettuato l'accesso all'app e il numero di crediti che hanno consumato.

Aggiungere e registrare un'app con credenziali chiave API incorporate

Utilizzare le credenziali chiave API se è necessario incorporare le credenziali nell'app e se la chiave deve essere valida per un periodo superiore ai 14 giorni.

Procedere come indicato nei passaggi che seguono per aggiungere un'app e creare una chiave API incorporata in essa da usare per scopi di autenticazione.

  1. Verificare di avere effettuato l'accesso con un account aziendale e di disporre dei privilegi per creare contenuti e chiavi API.
  2. Fare clic sulla scheda I miei contenuti della pagina dei contenuti, quindi fare clic su Nuovo elemento.
  3. Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
  4. Scegliere l'opzione credenziali chiave API e fare clic su Avanti.
  5. Utilizzare il calendario per indicare la data in cui scadranno le credenziali.

    Le credenziali possono scadere l'indomani (minimo) o dopo 365 giorni (massimo). Scadono alle 23:59 della data del giorno scelto per la scadenza. L'ora è salvata in base all'ora del browser quando aggiungi l'app e generi le credenziali.

  6. In URL referrer, inserire un'URL o l'indirizzo IP a cui è consentito connettersi. Fare clic su Aggiungi per aggiungere altre URL referrer o indirizzi IP:

    Gli URL di reindirizzamento specificati durante l'autorizzazione devono corrispondere a uno degli URL registrati, altrimenti l'autorizzazione verrà negata.

  7. Fare clic su Avanti.
  8. Scegliere quali azioni l'app potrà svolgere in virtù delle credenziali assegnando i privilegi e facendo clic su Avanti.

    L'elenco dei privilegi disponibili varia in funzione del possesso o meno di un abbonamento ad ArcGIS Location Platform e dei privilegi che si possiede nell'organizzazione. Non è possibile garantire privilegi che il proprio account non possiede.

  9. Fare clic su Sfoglia elementi, scegliere a quali elementi le credenziali integrate consentiranno l'accesso e fare clic su Aggiungi elementi.

    In alternativa, è possibile fare clic su Salta. Se si salta il passaggio in cui si specifica a quali elementi possono accedere gli utenti con credenziali chiave API, le credenziali possono essere utilizzate per accedere a tutti gli elementi di cui si è in possesso.

  10. Digitare il titolo.
  11. In I miei contenuti scegliere una cartella in cui salvare l'elemento.
  12. Se la propria organizzazione ha configurato categorie di contenuti, fare clic su Assegna categorie e selezionare fino a 20 categorie in modo che le persone possano individuarle facilmente.

    È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.

  13. Opzionalmente, scrivi dei tag che descrivono l'elemento.

    Separare i termini con virgole, ad esempio Parco nazionale è un tag, mentre Parco, nazionale sono due tag.

    Mentre si digita, è possibile selezionare uno qualsiasi dei tag suggeriti che vengono visualizzati; i suggerimenti vengono generati dai tag aggiunti in precedenza.

  14. Opzionalmente, aggiungi un sommario che descriva l'applicazione.
  15. Fare clic su Avanti.
  16. Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento. Se le impostazioni delle credenziali sono corrette, fare clic su Crea.

L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge credenziali chiave API indicante che una chiave API è incorporata nell'app appare sulla pagina dell'elemento e quando l'elemento è visualizzato dalla pagina contenuti o dal riquadro anteprima elemento.

È possibile configurare i dettagli dell'elemento per l'app.

Dalla scheda Impostazioni della pagina elemento dell'app, è possibile visualizzare le informazioni di registrazione, che includono l'ID app (Client ID), un segreto app (Client Secret) e gli ambienti dell'applicazione. È possibile aggiornare gli URL, reimpostare il segreto, annullare la registrazione dell'app o copiare o rinnovare il token temporaneo dell'app. È possibile inoltre modificare i privilegi posseduti dall'app e i layer a cui l'app può accedere.

Nota:

La reimpostazione del segreto del client renderà nulli tutti i token utente e app esistenti emessi per l'app. Gli utenti dovranno accedere nuovamente all'app e potrebbe essere necessario aggiornare le app configurate con il segreto.

Fare clic su Visualizza utilizzo nella scheda Impostazioni per visualizzare le informazioni riguardanti gli utenti che hanno effettuato l'accesso all'app e il numero di crediti che hanno consumato.

Argomenti correlati