ArcGIS organization portals

ArcGIS Online is a cloud-based, collaborative content management system for maps, apps, data, and other geographic content. ArcGIS Online and the developer dashboard provide tools that you can use to store and manage data for your applications. You can import existing data, create new datasets, or convert data to new types of data. All data is managed and accessed as a hosted layer, and each layer is powered by a data service.

ArcGIS Online

With ArcGIS Online you can do things like:

  • Create web maps
  • Web enable your data
  • Control how your maps, data, and applications are shared
  • Find relevant and useful basemaps, data, and configurable GIS resources
  • Manage content and users in your organization

Once hosted, you can access your data as services from your applications. You can also create new content (items), search for users and groups, and manage sharing.

ArcGIS for organizations

To access all the capabilities of ArcGIS Online, your organization can purchase a subscription. With a subscription to ArcGIS Online, organizations can manage all of their geographic content in a secure, cloud-based Esri environment. Members of the organization can use maps to explore data, create and share maps and apps, and publish their data as hosted web layers. Administrators customize the website, invite and add members to the organization, and manage resources.

Learn more about ArcGIS for organizations at ArcGIS Online.

Portal items, users, and groups

ArcGIS Online is an information portal and is represented in the API by the ArcGISPortal class.

This class is loadable.

When you sign in to ArcGIS Online with an organization account, you see a specialized view that your organization administrator has configured for you, giving you access to maps, content, and other services specific to your organization. You can also access all your own content and services.

Portal items

ArcGIS Online and ArcGIS Enterprise can store many types of content. See Supported items in the ArcGIS documentation for an exhaustive list. Perhaps the type most commonly used by apps is a web map—a JSON description of the data in a map, along with other display and behavioral properties. Other types include tile packages, feature collections, and services. Some types, such as globe documents and map templates, may only be relevant to desktop systems. Although you can access these types of data, you may not be able to use them on a mobile device.

The PortalItem class represents an individual item stored on a portal. Each item includes the following:

  • Metadata, such as a unique identifier (ID), title, summary, description, thumbnail image, and tags
  • Binary or text-based data—for example, the JSON that defines a web map or a feature collection, or a URL pointing to a map service, or the binary data of a tile package or shapefile

The item ID is the most important metadata for a portal item. You can use the ID to access an item in the portal and work with it in your app (such as loading a web map from a portal item, for example).

Portal users

A registered user of a portal is represented in the API by the PortalUser class. When you have signed in to a portal, you can get authentication information relating to the authenticated user from the portal class.

A user must authenticate to access secured resources. The authentication method you decide to implement might vary based upon the resources required by your application. Esri's preferred authentication methods are:

  • User authentication (OAuth 2.0): This method prompts users to sign in with an ArcGIS account and grants an OAuth 2.0 access token associated with the account to the client app. The app uses this token in all subsequent requests to the platform. This is the recommended method, and is most commonly used with ArcGIS Online and ArcGIS Enterprise.

  • API key: This unique identifier is used to authenticate a user, developer, or calling program to an API, although most typically used to authenticate a project rather than a human user.

For an overview of the ways to access secure services, see ArcGIS Security and Authentication.

Portal groups

Groups are a way to collaborate with other users who share a common interest. A user can create groups, join groups, and share items with those groups. Groups have titles, descriptions, thumbnails, and unique IDs to help users identify them. The sharing model within ArcGIS Online is based on groups. Groups are represented in the API by the PortalGroup class.

Connect to public content

To connect to ArcGIS Online and access public content anonymously, you can begin by creating an ArcGISPortal instance (without authenticating with the portal).

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
// Call the static method CreateAsync without arguments to get a reference to the arcgis.com portal
var portal = await ArcGISPortal.CreateAsync();

// Get portal info and read its properties
var portalInfo = portal.PortalInfo;

Console.WriteLine(string.Format("Access: {0}", portalInfo.Access.ToString()));
Console.WriteLine(string.Format("Name: {0}", portalInfo.PortalName));
Console.WriteLine(string.Format("Mode: {0}", portalInfo.PortalMode.ToString()));

From here, you can access public content; for example, you can

  • Display a web map.
  • Access the data stored in a portal item.
  • Search for content such as web maps, map services, map features, groups, and users.

Some organizations share content publicly and allow anonymous access to that content; connect to publicly accessible content from such organizations by specifying the organization URL.

For example:

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
// call the static method CreateAsync with a Uri argument to get a reference to a specific portal
ArcGISPortal portal = await ArcGISPortal.CreateAsync(new Uri("http://anorganization.maps.arcgis.com/sharing/rest"));

Connect to secured content

Apps that target organization users who have an ArcGIS account should add a Credential to the AuthenticationManager to authenticate the user when creating the portal object.

The portal object will have access to all the secure content for which the user has access rights and can be used to find out more information about the user, such as the user's full name (instead of the account user name). Additionally, information about the organization such as the name, banner image, description, and so on, can be found as shown above. Apps often make use of this information when a user connects to a specific portal, to show the user organization branding and context.

Typically, the portal object with the authenticated user is cached and used throughout the app session, to provide the app with a view of a portal that is centered around a single user. When the app is restarted, the credential must be reinstated, or the user must repeat the authentication process.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
// Generate an ArcGISTokenCredential using input from the user (username and password)
var cred = await AuthenticationManager.Current.GenerateCredentialAsync(
                    new Uri("http://anorganization.maps.arcgis.com/sharing/rest"),
                    userName,
                    password) as ArcGISTokenCredential;

// Add the credential to the AuthenticationManager
AuthenticationManager.Current.AddCredential(cred);

// Connect to the portal
ArcGISPortal portal = await ArcGISPortal.CreateAsync(
                            new Uri("http://anorganization.maps.arcgis.com/sharing/rest"));

// Get the current portal user and check privileges
PortalUser user = portal.User;
IEnumerable privileges = user.Privileges;

ArcGIS Enterprise

ArcGIS Enterprise provides you with the same core capabilities as ArcGIS Online, but it can be installed and hosted on your own premises, behind your firewall, for controlled distribution of content.

Learn more about ArcGIS Enterprise.

Connecting to an instance of ArcGIS Enterprise portal is done in a very similar way to connecting to ArcGIS Online and is represented in the API by the same class, ArcGISPortal. Use the URL to the Enterprise portal website, along with an appropriate credential valid on that portal, or no credential if accessing public content anonymously.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
// Generate an ArcGISTokenCredential using input from the user (username and password)
var cred = await AuthenticationManager.Current.GenerateCredentialAsync(
                    new Uri("http://geoportal.mycompany.com/sharing/rest"),
                    userName,
                    password) as ArcGISTokenCredential;

// Add the credential to the AuthenticationManager
AuthenticationManager.Current.AddCredential(cred);

// Connect to the portal
ArcGISPortal portal = await ArcGISPortal.CreateAsync(
                        new Uri("http://geoportal.mycompany.com/sharing/rest"));

// get the current portal user and check privileges
var user = portal.User;
var privileges = user.Privileges;

Samples

Open map (URL)

Open scene (portal item)

Create and save a map

Search for web map

Authenticate with OAuth

Feature collection layer (portal item)

Services

Tools

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.