The  schema defines the XML structure of the objects and attributes that  manages. You can modify the schema to manage new types of objects or object properties. Thus, you can add the class and attribute definitions to the schema in order to meet the needs of your organization.
NOTE: In proxy mode, you can add only those object classes and attributes that are valid according to the Active Roles schema.
 
The  schema is stored in the SPMLSchema.Config file. The SPMLSchema.Config file is located in the Web subfolder of the  installation folder.
The schema format corresponds to the DSML Version 2 profile (DSMLv2). For detailed information on the DSML v2 profile, refer to the OASIS SPML v2 - DSML v2 Profile specification. The specification describes the use of the DSML protocol as a data model for SPML- based provisioning and can be accessed from the OASIS Web site at http://www.oasis-open.org/specs/index.php#spmlv2.0.
 
    
To access , enter the following URL in your web browser:
http://<hostname>/ARServerSPML/SPMLProvider.asmx 
In this URL, <hostname> is the name of the computer where  is installed.
NOTE: The  web service is described by a Web Services Description Language (WSDL) file. To obtain a WSDL description of , open the following URL:
http://<hostname>/ARServerSPML/SPMLProvider.asmx?WSDL 
  
    
You can configure  to operate in two modes.
- 
Proxy mode: In this mode,  accesses Active Directory, Azure AD, or AD LDS using the Active Roles proxy service. While in proxy mode,  can manage objects in all Active Directory domains and/or AD LDS instances that are registered with Active Roles as managed domains and managed AD LDS instances, respectively.
With proxy mode,  not only extends the functionality of Active Roles, but also offers better interoperability than Active Roles ADSI Provider, due to  using open standards, such as HTTP, XML, and SOAP.
TIP: To take full advantage of the management capabilities of Active Roles, One Identity recommends using proxy mode when configuring .
 
 - 
Direct access mode: In this mode,  directly accesses Active Directory, Azure AD, or AD LDS.
When working in direct access mode,  can only manage objects that are located in the Active Directory / Azure AD domain or AD LDS instance to which  is connected via the Active Directory domain controller (DC) or the AD LDS server.
 
 
    
Active Roles implements special parameters called "Active Roles controls" (hereafter "controls"). Controls allow you to customize request processing.
In proxy mode,  clients can send controls to the Active Roles Administration Service with an SPML request to perform an administrative operation. The Administration Service can process the controls. On the other hand, the Administration Service can return its own control to the  client, then the client can process that control. The controls a client sends to the Administration Service are referred to as InControls, while the controls the Administration Service returns to the client are referred to as OutControls.
For more information, see the following sections:
For more information about Active Roles controls and for the list of available built-in controls, see the Active Roles SDK documentation.
IMPORTANT: All elements described in this section must be defined at the beginning of your SPML request. For a sample of use, see Sample SPML requests.