Chat now with support
Chat with Support

Active Roles 8.2.1 - Administration Guide

Introduction Getting started with Active Roles Configuring rule-based administrative views Configuring role-based administration Configuring rule-based autoprovisioning and deprovisioning
Configuring Provisioning Policy Objects
User Logon Name Generation E-mail Alias Generation Exchange Mailbox AutoProvisioning Group Membership AutoProvisioning Home Folder AutoProvisioning Property Generation and Validation Script Execution O365 and Azure Tenant Selection AutoProvisioning in SaaS products
Configuring Deprovisioning Policy Objects
User Account Deprovisioning Group Membership Removal User Account Relocation Exchange Mailbox Deprovisioning Home Folder Deprovisioning User Account Permanent Deletion Office 365 Licenses Retention Group Object Deprovisioning Group Object Relocation Group Object Permanent Deletion Script Execution Notification Distribution Report Distribution
Configuring entry types Configuring a Container Deletion Prevention policy Configuring picture management rules Managing Policy Objects Checking for policy compliance Deprovisioning users or groups Restoring deprovisioned users or groups Configuring policy extensions
Using rule-based and role-based tools for granular administration Workflows
About workflow processes Workflow processing overview Workflow activities overview Configuring a workflow
Creating a workflow definition for a workflow Configuring workflow start conditions Configuring workflow parameters Adding activities to a workflow Configuring an Approval activity Configuring a Notification activity Configuring a Script activity Configuring an If-Else activity Configuring a Stop/Break activity Configuring an Add Report Section activity Configuring a Search activity Configuring CRUD activities Configuring a Save Object Properties activity Configuring a Modify Requested Changes activity Enabling or disabling an activity Enabling or disabling a workflow Using the initialization script
Approval workflow Email-based approval Automation workflow Activity extensions
Temporal Group Memberships Group Family Dynamic groups Active Roles Reporting Management History Entitlement profile Recycle Bin AD LDS data management One Identity Starling Join and configuration through Active Roles Managing One Identity Starling Connect Configuring linked mailboxes with Exchange Resource Forest Management Configuring remote mailboxes for on-premises users Migrating Active Roles configuration with the Configuration Transfer Wizard Managing Skype for Business Server with Active Roles
About Skype for Business Server User Management Active Directory topologies supported by Skype for Business Server User Management User Management policy for Skype for Business Server User Management Master Account Management policy for Skype for Business Server User Management Access Templates for Skype for Business Server Configuring the Skype for Business Server User Management feature Managing Skype for Business Server users
Exchanging provisioning information with Active Roles SPML Provider Monitoring Active Roles with Management Pack for SCOM Configuring Active Roles for AWS Managed Microsoft AD Azure AD, Microsoft 365, and Exchange Online Management
Azure tenant types and environment types supported by Active Roles Using Active Roles to manage Azure AD objects Unified provisioning policy for Azure M365 Tenant Selection, Microsoft 365 License Selection, Microsoft 365 Roles Selection, and OneDrive provisioning Changes to Active Roles policies for cloud-only Azure objects
Managing the configuration of Active Roles
Connecting to the Administration Service Managed domains Using unmanaged domains Evaluating product usage Creating and using virtual attributes Examining client sessions Monitoring performance Customizing the Console Using Configuration Center Changing the Active Roles Admin account Enabling or disabling diagnostic logs Active Roles Log Viewer
SQL Server replication Using regular expressions Administrative Template Configuring federated authentication Communication ports and URLs used by Active Roles Integrating Active Roles with other products and services Active Roles Language Pack Active Roles Diagnostic Tools Active Roles Add-on Manager

Using Active Roles SPML Provider

To access SPML Provider, enter the following URL in your web browser:

http://<hostname>/ARServerSPML/SPMLProvider.asmx

In this URL, <hostname> is the name of the computer where SPML Provider is installed.

NOTE: The SPML Provider web service is described by a Web Services Description Language (WSDL) file. To obtain a WSDL description of SPML Provider, open the following URL:

http://<hostname>/ARServerSPML/SPMLProvider.asmx?WSDL

SPML Provider operation modes

You can configure SPML Provider to operate in two modes.

  • Proxy mode: In this mode, SPML Provider accesses Active Directory, Azure AD, or AD LDS using the Active Roles proxy service. While in proxy mode, SPML Provider 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, SPML Provider not only extends the functionality of Active Roles, but also offers better interoperability than Active Roles ADSI Provider, due to SPML Provider 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 SPML Provider.

  • Direct access mode: In this mode, SPML Provider directly accesses Active Directory, Azure AD, or AD LDS.

    When working in direct access mode, SPML Provider can only manage objects that are located in the Active Directory / Azure AD domain or AD LDS instance to which SPML Provider is connected via the Active Directory domain controller (DC) or the AD LDS server.

Active Roles controls supported by SPML Provider

Active Roles implements special parameters called "Active Roles controls" (hereafter "controls"). Controls allow you to customize request processing.

In proxy mode, SPML Provider 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 SPML Provider 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.

Sending controls to the Active Roles Administration Service

This section covers the controls and control XML elements that your SPML request must include to send controls to the Active Roles Administration Service.

Element name: controls

Element description: Specifies a collection of InControl-type controls to send to Administration Service.

Child elements: control

Attributes:

Table 66: Controls attributes

attribute name

attribute description

xmlns

Declares the namespase for all child elements of the controls element. This attribute must be set to quest:ars:SPML:2:0

Element name: control

Element description: Describes a control to send to the Administration Service.

Parent elements: controls

Child elements: None

Attributes:

Table 67: Control attributes

attribute name

attribute description

name

Specifies the name of the control.

The control value in the control element body must be specified as follows:

<control name=%control name%>%control value%</control>

To send an empty control, use the following syntax:

<control name=%control name% />

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating