Creating Multiple Secure User Connections

To create multiple, secure connections to your servers from a single client, so the client can service different user types, you create an authenticated RegionService for each user.

Typically, a GemFire client embedded in an application server supports data requests from many users. Each user can be authorized to access a subset of data on the servers. For example, customer users are allowed to see and update only their own orders and shipments.

The authenticated users all access the same Cache through instances of the RegionService interface. See RegionService.

To implement multiple user connections in your client cache, create your Cache as usual, with these additions:

Configure your client’s server pool for multiple secure user authentication. Example:
```
<pool name="serverPool" multiuser-authentication="true">
     <locator host="host1" port="44444"/>
</pool>
```
This enables access through the pool for the RegionService instances and disables it for the Cache instance.
After you create your cache, for each user, call your Cache instance createAuthenticatedView method, providing the user’s particular credentials. These are create method calls for two users:
```
PropertiesPtr credentials1 = Properties::create();
credentials1->insert("security-username", "root1");
credentials1->insert("security-password", "root1");
RegionServicePtr userCache1 = cachePtr->createAuthenticatedView(credentials1);

PropertiesPtr credentials2 = Properties::create();
credentials2->insert("security-username", "root2");
credentials2->insert("security-password", "root2");
RegionServicePtr userCache2 = cachePtr->createAuthenticatedView(credentials2);
```
For each user, do all of your caching and region work through the assigned region service pointer. Use the region service to get your regions, and the query service, if you need that, and then do your work with them. Access to the server cache will be governed by the server’s configured authorization rules for each individual user.
To close your cache, close the Cache instance.

Requirements and Caveats for RegionService