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.
- Verificare di avere effettuato l'accesso e di disporre dei privilegi per creare, aggiornare ed eliminare contenuti.
- Dalla scheda I miei contenuti della pagina dei contenuti, fare clic su Nuovo elemento, quindi fare clic su Applicazione.
- 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.
- Per il mapping web, desktop o mobile, digitare l'URL dell'app, per esempio,https://<myServer>/myWebMapApp.
- Per le app desktop, fare clic su Sfoglia e scegliere il .zip file che contiene l'app.
- Fare clic su Avanti.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- Se la tua organizzazione ha impostato delle categorie di contenuto, fai clic su Assegna categorie e seleziona fino a 20 categorie per aiutare gli utenti a trovare l'elemento. .
È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.
- Opzionalmente, scrivi dei tag che descrivono l'elemento.
Separare i termini con virgole (ad esempio Terra federale è considerato un tag mentre Terra, federale 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.
- Opzionalmente, aggiungi un sommario che descriva l'applicazione.
- 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.
Creare elementi credenziali di sviluppatore
Come sviluppatore con account aziendale, creare un elemento credenziali di sviluppatore 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 sua organizzazione nonché di sfruttare altre funzionalità di ArcGIS Online quali la geocodifica, il routing e GeoEnrichment. Per scoprire di più sull'autenticazione e OAuth 2.0, vedere Esri Developer.
È anche possibile creare credenziali di sviluppatore per l'autenticazione di app e per generare le chiavi API.
Il tipo di credenziali di sviluppatore create dipendono dai privilegi posseduti nell'organizzazione. Un membro del ruolo di amministratore predefinito o un membro di un ruolo personalizzato con privilegio per generare chiavi API può usare credenziali sia OAuth 2.0 che di chiave API. Altri utenti possono utilizzare solo le credenziali di sviluppatore OAuth 2.0.
Una volta create le credenziali di sviluppatore, fare clic su Visualizza utilizzo nella scheda Impostazioni delle pagine dell'elemento dell'app per sapere chi ha eseguito l'accesso all'app e il numero di crediti utilizzati. È inoltre possibile gestire le impostazioni per le credenziali incorporate nell'app.
Nota:
La sezione Visualizza utilizzo non è disponibile quando si accede con un abbonamento ad ArcGIS Location Platform.
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.
Creare le credenziali OAuth 2.0 per l'autenticazione dell'utente
Se l'app richiede che gli utenti accedano a un account ArcGIS Online, completare la procedura seguente.
- Verificare di avere effettuato l'accesso con un account aziendale con privilegio per creare, aggiornare ed eliminare contenuti.
- Fare clic sulla scheda I miei contenuti della pagina dei contenuti, quindi fare clic su Nuovo elemento.
- Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
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.
- Scegliere l'opzione Credenziali OAuth 2.0 - Per autenticazione utenti e fare clic su Avanti.
- 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
- Nella casella URL, digitare un URL per l'app nel formato https://<myServer>/myWebMapApp.
- Fare clic su Avanti.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- Se la tua organizzazione ha impostato delle categorie di contenuto, fai clic su Assegna categorie e seleziona fino a 20 categorie per aiutare gli utenti a trovare l'elemento. .
È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.
- Opzionalmente, scrivi dei tag che descrivono l'elemento.
Separare i termini con virgole (ad esempio Terra federale è considerato un tag mentre Terra, federale 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.
- Opzionalmente, aggiungi un sommario che descriva l'applicazione.
- Fare clic su Avanti.
Viene visualizzato il riepilogo delle credenziali.
- Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento.
- Fare clic su Crea.
L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge 
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. Nella scheda Panoramica della pagina dell'elemento, il badge indica se i privilegi personali sono inclusi o se solo i privilegi standard sono inclusi nelle credenziali.
Creare le credenziali OAuth 2.0 per l'autenticazione dell'app
Completare la procedura seguente se l'app pubblica non richiede che gli utenti accedano e generino i token di accesso lato server.
- Verificare di avere effettuato l'accesso con un account aziendale con privilegio per creare, aggiornare ed eliminare contenuti.
- Fare clic sulla scheda I miei contenuti della pagina dei contenuti, quindi fare clic su Nuovo elemento.
- Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
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.
- Scegliere l'opzione Credenziali OAuth 2.0 - Per autenticazione app e fare clic su Avanti.
- In Dove saranno usate queste credenziali, scegliere una delle opzioni seguenti:
- Applicazione privata con accesso e privilegi selezionati: scegliere questa opzione per concedere l'accesso a qualunque serie di elementi e privilegi. È possibile incorporarla in un'app privata o in un componente lato server usato da un'app pubblica.
- Applicazione privata che impersona l'utente: scegliere questa opzione per concedere tutti i privilegi correnti insieme all'accesso al contenuto, ai membri e alle impostazioni dell'organizzazione.
- Fare clic su Avanti.
- Facoltativamente, se si seleziona Applicazione privata con privilegi e accesso selezionati, scegliere una delle seguenti opzioni:
- Nessun accesso agli elementi: nessun accesso agli elementi è necessario per questa credenziale. Fare clic su Avanti.
- Concedi l'accesso agli elementi tramite privilegi : selezionare i privilegi richiesti per consentire l'accesso agli elementi per questa credenziale. Fare clic su Avanti.
- Concedi l'accesso a elementi specifici: selezionare innanzitutto gli elementi posseduti a cui concedere l'accesso. Fare clic su Avanti.
- Facoltativamente, se si seleziona Applicazione privata con privilegi e accesso selezionati, scegliere le azioni che l'app sarà autorizzata a eseguire con le credenziali assegnando i privilegi. Fare clic su Avanti.
L'elenco dei privilegi disponibili varia a seconda che si disponga di un abbonamento a ArcGIS Location Platform e dei privilegi che si possiede nell'organizzazione. Non è possibile garantire privilegi che il proprio account non possiede.
Per informazioni sui tipi di privilegi, fare riferimento alla guida sulla sicurezza e autenticazione nella guida per sviluppatori di Esri.
- Fare clic su Avanti.
- 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 specificati durante l'autorizzazione devono corrispondere a uno degli URL registrati, altrimenti l'autorizzazione viene negata.
Di seguito sono riportati alcuni esempi di formati di URL referrer supportati:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Fare clic su Avanti.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- Se la tua organizzazione ha impostato delle categorie di contenuto, fai clic su Assegna categorie e seleziona fino a 20 categorie per aiutare gli utenti a trovare l'elemento. .
È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.
- Opzionalmente, scrivi dei tag che descrivono l'elemento.
Separare i termini con virgole (ad esempio Terra federale è considerato un tag mentre Terra, federale 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.
- Opzionalmente, aggiungi un sommario che descriva l'applicazione.
- Fare clic su Avanti.
Viene visualizzato il riepilogo delle credenziali.
- Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento.
- Se è stata selezionata l'opzione Applicazione privata che impersona l'utente, fare clic sulla casella accanto a Riconosco e accetto i requisiti di sicurezza associati ai privilegi selezionati.
- Fare clic su Crea.
L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge indicante le credenziali OAuth 2.0 appare quando l'elemento viene visualizzato dalla pagina dei contenuti o dal riquadro di anteprima dell'elemento. Nella scheda Panoramica della pagina degli elementi, il badge Credenziali OAuth 2.0 - Impersona il proprietario dell'elemento appare se si sceglie Applicazione privata che impersona l'utente in Dove saranno utilizzate queste credenziali.
Creare credenziali di chiave API
Per creare le credenziali di chiave API, procedere nel modo seguente.
- Verificare di avere effettuato l'accesso con un account aziendale e di disporre dei privilegi per creare chiavi API e creare, aggiornare ed eliminare contenuti.
- Fare clic sulla scheda I miei contenuti della pagina dei contenuti, quindi fare clic su Nuovo elemento.
- Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
- Scegliere l'opzione credenziali chiave API e fare clic su Avanti.
- In Dove saranno usate queste credenziali, scegliere una delle opzioni seguenti:
- Applicazione pubblica: scegliere questa opzione per concedere l'accesso a specifici elementi e privilegi di servizio.
- Applicazione privata con accesso e privilegi selezionati: scegliere questa opzione per concedere l'accesso a qualunque serie di elementi e privilegi. È possibile incorporarla in un'app privata o in un componente lato server usato da un'app pubblica.
- Applicazione privata che impersona l'utente - Scegliere questa opzione per concedere tutti i privilegi correnti insieme all'accesso al contenuto, ai membri e alle impostazioni dell'organizzazione.
- Fare clic su Avanti.
- Facoltativamente, se è stata selezionata l'opzione Applicazione pubblica, scegliere una delle seguenti opzioni:
- Nessun accesso agli elementi: nessun accesso agli elementi è necessario per questa credenziale. Fare clic su Avanti.
- Concedi l'accesso a elementi specifici: selezionare innanzitutto gli elementi posseduti, quindi fare clic su Avanti.
- Facoltativamente, se si seleziona Applicazione privata con privilegi e accesso selezionati, scegliere una delle seguenti opzioni:
- Nessun accesso agli elementi: nessun accesso agli elementi è necessario per questa credenziale. Fare clic su Avanti.
- Concedi l'accesso agli elementi tramite privilegi : selezionare i privilegi richiesti per consentire l'accesso agli elementi per questa credenziale. Fare clic su Avanti.
- Concedi l'accesso a elementi specifici: selezionare innanzitutto gli elementi posseduti, quindi fare clic su Avanti.
- Facoltativamente, se è stata selezionata l'opzione Applicazione privata o Applicazione privata con privilegi e accesso selezionati , scegliere le azioni che l'app sarà autorizzata a eseguire con le credenziali assegnando i privilegi. Fare 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.
Per informazioni sui tipi di privilegi, fare riferimento alla guida sulla sicurezza e autenticazione nella guida per sviluppatori di Esri.
- Facoltativamente, se è stata selezionata l'opzione Applicazione privata che impersona l'utente, utilizzare il calendario per specificare una data di scadenza per 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.
- In URL referrer, inserire un URL o l'indirizzo IP a cui è consentito connettersi. Se necessario, fare clic su Aggiungi per aggiungere altri URL referrer o indirizzi IP.
Gli URL specificati durante l'autorizzazione devono corrispondere a uno degli URL registrati, altrimenti l'autorizzazione viene negata.
Di seguito sono riportati alcuni esempi di formati di URL referrer supportati:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Fare clic su Avanti.
- Fornire un titolo.
- In I miei contenuti scegliere una cartella in cui salvare l'elemento.
In alternativa, è possibile scegliere Crea nuova cartella dal menu e digitare un nome di cartella per salvare l'elemento in una nuova cartella.
I nomi delle cartelle non possono contenere caratteri Unicode a 4 byte.
- Se la tua organizzazione ha impostato delle categorie di contenuto, fai clic su Assegna categorie e seleziona fino a 20 categorie per aiutare gli utenti a trovare l'elemento. .
È possibile anche iniziare a digitare un nome di una categoria per restringere l'elenco delle categorie.
- Opzionalmente, scrivi dei tag che descrivono l'elemento.
Separare i termini con virgole (ad esempio Terra federale è considerato un tag mentre Terra, federale 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.
- Opzionalmente, aggiungi un sommario che descriva l'applicazione.
- Fare clic su Avanti.
Viene visualizzato il riepilogo delle credenziali.
- Revisionare il riepilogo delle credenziali. Per modificare le impostazioni, fare clic su Indietro ed effettuare le modifiche prima di creare l'elemento.
- Se è stata selezionata l'opzione Applicazione privata che impersona l'utente, fare clic sulla casella accanto a Riconosco e accetto i requisiti di sicurezza associati ai privilegi selezionati.
- Fare clic su Crea.
L'app viene aggiunta ai contenuti e compare la sua pagina elemento. Un badge 
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. Nella scheda Panoramica della pagina dell'elemento, il badge indica se i privilegi personali sono inclusi o se solo i privilegi standard sono inclusi nelle credenziali.