Skip To Content

Register an app

Once you've added your app to ArcGIS Online, you need to register it with the platform and obtain an App ID. This App ID identifies your app to the platform in the context of both user login and app login based on OAuth 2.0 and is also the foundation for distributing apps, accessing billable services, and getting usage reports. To learn more about authentication and OAuth 2.0, see ArcGIS for Developers.

Note:

The implementation pattern for user logins differs slightly, depending on whether you are developing a web-based app or a native app. ArcGIS for Developers documentation has details and code samples for both web-based and native apps.

  1. Verify that you are signed in as an administrator of your organization.
  2. Click Content and click the title of the app you want to register to view its item details.
  3. Click the Settings tab. Scroll down to the Application Settings section and click Register.

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

  4. Select the type of app: browser, native, server, or multiple.
  5. For each redirect Uniform Resource Identifier (URI), enter the address in the format ["https://<server>[:port]"] or ["http://<server>[:port]"] and click Add.

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

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

View and update app registration info

Once you've registered your app, you can view its 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 app tokens issued for the app. Users will need to sign in to the app again, and apps configured with the secret may need to be updated.

  1. Verify that you are signed in as an administrator of your organization.
  2. Click the title of the registered app.
  3. In the item details, click the Settings tab.
  4. Scroll down to the Application Settings section and click Registered Info.

    You can view the following details: App ID, App Secret, App Type, and Redirect URIs.

  5. To update the redirect URIs, follow these steps:
    1. Under Application Settings, click Update. The Registered Info window appears.
    2. To add a redirect URI, enter the address and click Add.
    3. To remove a redirect URl, select the URI address and click Delete.
    4. Click Update and click Save.
  6. To reset the app secret, follow these steps:
    1. Under Application Settings, click Update. The Registered Info window appears.
    2. Click Reset Secret.

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

    3. Click Yes if you are sure you want to reset the app secret.
    4. Click Update and click Save.
  7. To unregister your app, under Application Settings, click Unregister App.

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