Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Purpose

This article step-by-step guide to creating ArcGIS Enterprise App IDs or ArcGIS Online (AGOL) Client IDs and configuring their redirects when adding connectors to the "Manage Identities" feature of Admin Tools Enterprise, Backup My Org, and Clean My Org. This tutorial applies to non-IWA (Oauth2) Authentication.

Step-By-Step Instructions

The steps will differ between using ArcGIS Online or Enterprise, so please select one of the following expandable content arrows that best corresponds to your organization type:

Expand
titleArcGIS Enterprise App ID Step-by-step Instructions


Step-by-step guide for ArcGIS Enterprise

  1. From the “Content” tab, navigate to "My Content" sub-tab, select “Add Item” → “An Application”

Screenshot 2024-05-07 161715.png

  1. Creating your application

    1. Select the "Application" option in “Add an application” prompt.

    2. Name the “New item” as “Admin Tools Enterprise”, "Clean My Org", or "Backup My Org" (based on which solution you're using).

    3. Provide your application with tag names that will assist with locating your application item in the future.

    4. Click “Add Item” when done.

  1. Go to the "Settings" Tab of your newly created application.

  1. Scrolling to the "Application" section in “Settings”, click the "Registered Info" button. The App ID will be is listed here. Copy the App ID and paste it into the App ID field for the identity you're setting up in the Clean My Org/Backup My Org application that is running.

  1. NEXT, click the "Update" button.

  1. Configure the Redirect URIs:

    1. Finally, ensure you “Add” your URI to “Redirect URI” before selecting "Update" to save these changes.

Note

THIS IS AN EXAMPLE DOMAIN!

Please add the real domain you will be running Clean My Org/Backup My Org from this Redirect URI. Ensure that '/' is not included at the end of your domain as this could potentially cause Admin Tools, Backup My Org, or Clean My Org to unsuccessfully connect to the Redirect URI.

NOTE: for Backup My Org, this is (usually) both http and https://localhost:8500, or http://yourwebserver:8500

NOTE: for Clean My Org, this is (usually) both http and https://localhost:8000, or http://yourwebserver:8000

Note

If you’re using https instead of http or a different port, the Redirect URI will need to be exact.

You should now have the OAuth App ID and Redirects necessary to run Clean My Org/Backup My Org.

Expand
titleArcGIS Online App ID Step-by-step Instructions

Step-by-step guide for ARCGIS ONLINE

  1. From the main “Contents” tab, navigate to "My Content" tab, and select "New Item".

  1. Select the "Application" option.

  1. Select the "Other Application" option in the next step

  1. Title the application as “Admin Tools Enterprise“, "Clean My Org", or "Backup My Org" (based on which solution you're using).

Info

The Client ID will be listed in the Credentials section in the Item Overview

  1. Go to the Settings Tab for the Application Item

  1. Scroll down to the "Redirect URLs" Section. This is where you will configure the Redirect URLs

    1. Click the “Add” button, and include all relevant redirects to this section.

Note

NOTE: If there are multiple ways for your Organization to access Admin Tools Enterprise, CleanMyOrg, or BackupMyOrg, you will need to add each different domain.

Info

For Backup My Org, this is (usually) both http and https://localhost:8500, or http://yourwebserver:8500

Info

For Clean My Org, this is (usually) both http and https://localhost:8000, or http://yourwebserver:8000

Note

If you’re using https instead of http or a different port, the Redirect URI will need to be exact.

  1. Finally, ensure you click the "Save" button to update changes made.

Great! You should now have the OAuth App ID and Redirects configuration that is necessary to run Clean My Org/Backup My Org.

For a guide on how to create an ArcGIS App ID for AdminTools, please follow the link below:

How To Register Admin Tools for an OAuth App ID (Non-IWA Installs)

...