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
Per aggiungere un elemento che utilizza un URL per accedere a un'app sul Web ma che non deve essere registrato (ad esempio, esempi di codice), completa i passaggi seguenti:
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 Il mio contenuto della pagina del contenuto, fai clic su Nuovo elemento e fai clic su Applicazione.
- Scegli il tipo di app tra le seguenti opzioni:
- 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- App scaricabile sviluppata per dispositivi mobili con un kit di sviluppo software (SDK), ad esempio 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 un'app Web mapping, desktop o mobile, fornisci l'URL dell'app, ad esempio,https://<myServer>/myWebMapApp.
- Per le app desktop, fai clic su Sfoglia, e scegli il file .zip 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 ulteriori informazioni sull'autenticazione e OAuth 2.0, consulta la documentazione di 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 agli utenti di accedere con un account ArcGIS Online, completa i passaggi seguenti:
- Verificare di avere effettuato l'accesso con un account aziendale con privilegio per creare, aggiornare ed eliminare contenuti.
- Fai clic sulla scheda Il mio contenuto della pagina del contenuto e fai 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.
- Scegli l'opzione Credenziali OAuth 2.0 - Per l'autenticazione utente e fai 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.
Per le concessioni di autorizzazione può essere specificato anche un valore speciale di urn:ietf:wg:oauth:2.0:oob. 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 di testo URL, fornisci 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 al tuo contenuto e viene visualizzata la relativa 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
Se l'app pubblica non richiede agli utenti di accedere e generare token di accesso lato server, completa i passaggi seguenti:
- Verificare di avere effettuato l'accesso con un account aziendale con privilegio per creare, aggiornare ed eliminare contenuti.
- Fai clic sulla scheda Il mio contenuto della pagina del contenuto e fai 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.
- Scegli l'opzione Credenziali OAuth 2.0 - Per l'autenticazione dell'app e fai 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 - Devi prima selezionare gli elementi di tua proprietà a cui concedere l'accesso. Fare clic su Avanti.
- Facoltativamente, se hai selezionato Applicazione privata con i privilegi e l'accesso selezionati, scegli quali azioni le credenziali consentiranno all'app di eseguire assegnando i privilegi, quindi fai 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, consulta la guida Sicurezza e autenticazione nella documentazione per sviluppatori di Esri.
- Fare clic su Avanti.
- In URL referrer, fornisci l'URL o l'indirizzo IP autorizzato a connettersi all'app. Fai clic su Aggiungi per aggiungere altri URL referrer o indirizzi IP, secondo necessità.
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 hai selezionato Applicazione privata che impersona l'utente, seleziona la casella di controllo Accetto e riconosco i requisiti di sicurezza associati ai privilegi selezionati.
- Fare clic su Crea.
L'app viene aggiunta al tuo contenuto e viene visualizzata la relativa pagina elemento. Un badge che indica le credenziali OAuth 2.0 viene visualizzato quando si visualizza l'elemento dalla pagina dei contenuti o dai riquadri di anteprima degli elementi. Nella scheda Panoramica della pagina dell'elemento viene visualizzato il badge Credenziali OAuth 2.0 - Impersona il proprietario dell'elemento se hai scelto Applicazione privata che impersona l'utente in Dove utilizzerai queste credenziali.
Creare credenziali di chiave API
Per creare credenziali della chiave API, completa i passaggi seguenti:
- Verifica di aver effettuato l'accesso con un account aziendale che dispone dei privilegi necessari per creare chiavi API e creare, aggiornare ed eliminare contenuto.
- Fai clic sulla scheda Il mio contenuto della pagina del contenuto e fai clic su Nuovo elemento.
- Nella finestra Nuovo elemento, cliccare su Credenziali sviluppatore.
- Scegli l'opzione Credenziali della chiave API e fai 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 - Devi prima selezionare gli elementi di tua proprietà, quindi fai 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 - Devi prima selezionare gli elementi di tua proprietà, quindi fai clic su Avanti.
- Facoltativamente, se hai selezionato Applicazione pubblica oppure Applicazione privata con i privilegi e l'accesso selezionati, scegli quali azioni le credenziali consentiranno all'app di eseguire assegnando i privilegi, quindi fai 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, consulta la guida Sicurezza e autenticazione nella documentazione 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 il giorno successivo (minimo) oppure 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 hai selezionato Applicazione privata che impersona l'utente, seleziona la casella di controllo Accetto e riconosco i requisiti di sicurezza associati ai privilegi selezionati.
- Fare clic su Crea.
L'app viene aggiunta al tuo contenuto e viene visualizzata la relativa 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.