Adding applications

Adding a URL reference to an existing desktop, web, or mobile application is an effective way to share your work with members of your organization and the general public. In addition to the URL, you can share other details such as the type of app, its purpose, a summary and description, and a ZIP file with the code you used to create the app. As an app developer with an organizational account, you can also register your app and obtain an app ID.

Adding an app to ArcGIS Online only adds a reference to your URL; the website does not actually store the app files.

Tip:

Another way to share apps with members of your organization and the general public is to publish a web mapping app you create from a web map. For more information, see Creating applications with web maps.

To add an existing app to the website, follow the steps below.

Steps:

1. Verify that you are signed in.
2. Open My Content and click the Add Item button.

   The Add Item window appears.

3. Choose An Application from the The item is options.
4. Choose the type of item:
   • Web Mapping—An external site with its own URL and built with a web API such as JavaScript.
   • Mobile—A downloadable app for devices built with an SDK such as iOS.
   • Application—A desktop application or any type of generic app where you don't have details about purpose, API/SDK, or URL address.
5. For web mapping or mobile, choose the purpose of the app:
   • Ready to Use—Fully functioning website or mobile app
   • Configurable—Fully functioning app that can be deployed by configuring a file
   • Code Sample—Code for a specific piece of functionality, either as a live sample or a description of how to use the sample in an app
6. For web mapping or mobile, choose the API (web mapping) or SDK (mobile) used to create the app.
7. For web mapping or mobile, type the URL of the app, for example, http://<myServer>/myWebMapApp.
8. Type a title.
9. Type tags. Alternatively, you can click the Choose from your tags link to open the list of tags you've used previously and choose the tags you want to use for this item.
   Tags are words or short phrases that describe your item. Separate terms with commas. Federal land is considered one tag, while Federal, land is considered two tags. It is useful to enter keywords related to how you want others to use your app (for example, code sample, template, or user app).
10. Click the Add Item button.

Once you've added your app, it appears on My Content and you can edit the item details (where you can attach code if you want) and share it.

Registering your app

If you are an application developer with an organizational account, you can register your application and obtain an app ID. This app ID identifies your application to the platform in the context of both user logins as well as app logins based on OAuth 2 and is also the foundation for distributing apps, accessing billable services, and getting usage reports. To learn more about authentication and OAuth 2, see ArcGIS for Developers.

Before you can register your application, you need to add it to ArcGIS Online. See the section above for details. After you've added it, follow the steps below to register your application and get an app ID and app secret.

Steps:

1. Verify that you are logged in with your organizational account and click My Content.
2. Click the title of the application you want to register to view its item details.
3. Scroll down to the App Registration section and click the Register button.

   If you've added a generic type of app, the app is automatically registered and you see the Registered Info button instead of the Register button. You can view and update the information.

4. Select the type of app—browser, native, server, or multiple.
5. For each redirect URI, enter the address in the format http://<server>[:port] and click the Add button.

   Redirect URIs are valid addresses that users of your app can be redirected to after they successfully log in to.

6. To remove a URI you previously added, select it and click the Delete button.
7. Click the Register button.

Viewing and updating app registration info

Once you've registered your application, you can view registration info which includes an app ID and an app secret. You can also update the redirect URIs, reset the secret, and unregister the app.

Note:

Resetting the app secret will invalidate all existing user and application tokens issued for the application. Users will need to log in to the app again and applications configured with the secret may need to be updated.

Follow the steps below to view and update the registration information.

Steps:

1. Verify that you are logged in with your organizational account and click My Content.
2. Click the title of the registered application.
3. Scroll down to the App Registration section and click the Registered Info button.

   You can view the following details: app ID, app secret, app type, and redirect URIs.

4. To update the redirect URIs, follow the steps below.
   1. Click the Edit button from the top of the item details page.
   2. Scroll down to the App Registration section and click the Update button. The Registered Info window opens.
   3. To add a redirect URI, enter the address and click the Add button.
   4. To remove a redirect URl, select the URI address and click the Delete button.
   5. Click Update.
   6. Click Save at the bottom of the item details page.
5. To reset the app secret, follow the steps below.
   1. Click the Edit button from the top of the item details page.
   2. Scroll down to the App Registration section and click the Update button. The Registered Info window opens.
   3. Click the Reset Secret button.

      Resetting the app secret will invalidate all existing user and application tokens issued for this application. Users will need to log in to the application again and applications configured with the secret may need to be updated.

   4. Click Yes if you are sure you want to reset the app secret.
   5. Click Update.
   6. Click Save at the bottom of the item details page.
6. To unregister your app, follow the steps below.
   1. Click the Edit button from the top of the item details page.
   2. Scroll down to the App Registration section and click the Unregister App button.

      Your app is no longer registered. You do not need to save the item details page.