The first part of this blog introduced you to the ArcGIS Platform by describing it from a developers perspective. It described (at a high level) some of the most common tools for developers in the context of the broad workflow steps: Data, Design, and Develop. In this post, I'll continue to describe these tools further by stepping through that workflow towards the creation of a simple app.
Sign up, log in, geek out
Let's start by creating an ArcGIS for Developers account. Logging in with your account gives you access to all of the ArcGIS Runtime SDK downloads, documentation, API references, samples, and so on. The site also provides tools for creating your own feature services, tracking data and app usage, and managing app security settings. Bonus: it also gives you access to ArcGIS Online, where you'll be able to manage your data and author maps (among other things).
- Open a web browser and navigate to the ArcGIS for Developers sign up page.
- Enter your First Name, Last Name, and Email Address in the form. The email address must be unique for each ArcGIS for Developers account, you cannot use an address that's associated with an existing account. If using Gmail, you can provide an email address alias that will be routed to the same email account.
- Click the Sign up for free button. A confirmation email will be sent to the address you provided.
- When you receive the confirmation email, navigate to the link in the message to finalize creation of your account. The account activation page will prompt you for a username, password, and other account information.
- Accept the account terms and conditions to complete your account.
Create a new application ... kinda
An application, created using your ArcGIS for Developers account, is used to represent an item inside ArcGIS Online. It's not an actual application, instead it contains metadata that describes an app (that may or may not yet exist). The information you define for an application can be used to track app usage, to obtain tokens for accessing secured ArcGIS Online content and services, and so on. When creating an application, ArcGIS for Developers also generates information needed to implement OAuth 2.0 authentication in your (real) app. You'll use this information later to access secured data.
- Log in to ArcGIS for Developers. When you're logged into the site, a row of tabs appears in the upper-right portion of the page.
- Click the Applications tab (button) to show the Applications page.
- On the Applications page, click the Register New Application button.
- In the New Application Details panel, provide a Title, a comma-separated list of Tags, and a Description for the application. The values shown below describe the app you'll create in this tutorial. You can use these values or supply your own.
- Click Register New Application in the form to create the application. When the item is created, you will be redirected to a page that contains generated application info, such as the Client ID (which you'll need in order to authorize for access to ArcGIS Online).
One piece of information that ArcGIS for Developers does not generate for a new application is a redirect URI for handling authentication responses in the OAuth framework. You'll do that next.
Add a redirect URI
When using the OAuth 2.0 authentication framework in your ArcGIS Runtime app, you need to specify a URL to which an authorization response can be redirected from the server. The URL you use in your code must be in the list of allowed redirect URIs configured for the application.
- Click the Authentication tab in the page for the application you created (Portal Maps, for example).
- Scroll to the Redirect URIs section, near the bottom of the page.
Type https://developers.arcgis.com in the Add Redirect URI text box and click Add to add it to the Current Redirect URIs list box.Note that the URI you provide as a redirect does not necessarily need to be an actual address. As you will see later, the redirect URI a placeholder for checking for a response from an authentication request.
By creating an application with your ArcGIS for Developers account and configuring it with a redirect URI, you have all you need to implement OAuth 2.0 authentication. If you don't need to use OAuth for your app, you may still want to register your applications with ArcGIS for Developers for things like tracking app usage.
In the next post, you will use ArcGIS Online to author a map for use in your ArcGIS Runtime SDK for .NET app.