GASRemoteAccessProvider Thing
Derived from the GenericThing Thing Template, the GASRemoteAccessProvider Thing represents a Global Access Server that is to be used for remote sessions with Axeda eMessage Agents (Axeda Gateway and Axeda Connector) through the ThingWorx Platform.
This Thing has settings for an Axeda GAS, including a soft limit for the maximum number of Global Access Servers that may be registered with the ThingWorx Platform at any given time. The property is called maxServers. Its minimum value is 1 and default value is 50.
If a GAS attempts to register with the eMessage Connector, before a new GAS Thing is created, the current count of registered Global Access Servers is compared against the value of the maxServers setting. If the current count is greater than, or equal to maxServers, the next registration attempt will fail. This setting is editable and can be modified by a ThingWorx user with appropriate permissions.
* 
Reducing this value does NOT have any effect on already-created Global Access Servers. Setting this value below 1 will prevent any new GAS from registering.
As of version 2.2.0 of the Axeda Compatibility Package, and 3.0.0 of the RAE, this Thing is enabled once you import the Remote Access Extension (RAE) into ThingWorx Platform. In addition, if a GAS presents an invalid token to ThingWorx Platform, the invalidToken property of the GAS Thing is set to true and the GAS selection algorithm ignores any GAS whose invalidToken property is set to true.
* 
The GASRemoteAccessProvider requires the following RunTime permissions:
PropertyRead on the selector and maxServers properties
ServiceInvoke on the GetRemoteAccessibleEndpoints and GetRemoteServerConfiguration services
Properties of the GASRemoteAccessProvider Thing 
The GASRemoteAccessProvider has the following properties:
Name
Base Type
Description
selector
THINGNAME
The GAS Selector to use for GAS selection when starting a remote session. The value of this property is preserved over restarts of ThingWorx Platform. Its value is set by running the service of the GASSelectorService Thing Shape.
maxServers
INTEGER
This property specifies the maximum number of Global Access Servers that will handle remote sessions for a ThingWorx Platform. The minimum value is 1, and the default value is 50, which should suffice for most environments. The value of this property is preserved over restarts of ThingWorx Platform.
Services of the GASRemoteAccessProvider Thing 
The GASRemoteAccessProvider Thing provides the following services:
Service
Description
Result Base Type
IsCreateAllowed
Returns true if a new Global Access Server may be created, false if not.
BOOLEAN
EndpointJsonToInfoTable
Converts the JSON-formatted providerConfig of a RemoteEndpoint to an infotable.
The required parameter for this service is called providerConfigJson. This parameter is the JSON-formatted providerConfig of the RemoteEndpoint
This service creates a GASRemoteEndpointProviderConfig Data Shape, which contains the providerConfig as a ThingWorx infotable.
INFOTABLE
EndpointInfoTableToJson
Converts the providerConfig infotable of a RemoteEndpoint to JSON format.
The required parameter for this service is called providerConfigInfoTable. This parameter is the GAS.RemoteEndpointProviderConfig infotable to convert to providerConfig-compatible JSON.
JSON
SessionParametersJsonToInfoTable
Converts JSON-formatted RemoteSessionParameters of the providerConfig to a ThingWorx infotable.
The required parameter for this service is called providerConfigJson. This parameter is the JSON-formatted providerConfig of the remote session parameters.
This service creates a GAS.SessionParametersProviderConfig Data Shape, which contains the parameters in a ThingWorx infotable.
INFOTABLE
SessionParametersInfoTableToJson
Converts the providerConfig infotable of a RemoteEndpoint to JSON format.
The required parameter for this service is called providerConfigInfoTable. This parameter is the GAS.SessionParametersProviderConfig infotable to convert to providerConfig-compatible JSON.
JSON
Runtime Permissions Needed 
The runtime permissions that the service to grant permissions for Remote Access grants to this Thing include permissions to run the following services:
Service
Description
GetRemoteAccessibleEndpoints
Retrieves the names of the endpoints for device Things that implement the RemoteAccessible Data Shape.
GetRemoteServerConfiguration
Returns the JSON serverConfiguration data for the given agentDevice and endpointName. The GASRemoteAccessProvider implementation returns the remoteServerConfiguration data stored in the endpoint property (endpointName) of the given agentDevice.
This service takes two properties: agentDevice, which is the name of the Thing (THINGNAME) and endpointName, which is the name of the remote interface or endpoint of this Thing for remote sessions (a STRING). An example of a remote interface or endpoint is an SSH client.
Was this helpful?