This scenario assumes that your SMTP server:
-
Runs on the server smtp.mycompany.com.
-
Uses the default port number (25).
-
Allows anonymous access.
-
Allows non-encrypted connections.
Additionally, the service account of the Administration Service is assumed to have a mailbox with the email address of ARSService@mycompany.com.
Create the email configuration by using the Active Roles Console:
-
In the Console tree, expand Configuration > Server Configuration, right-click Mail Configuration, and then select New > Mail Configuration to start the New Mail Configuration Wizard.
-
Click Next.
-
In Name, type Deprovisioning Notification Distribution.
-
Click Next.
-
In Outgoing mail server (SMTP), type smtp.mycompany.com.
-
In Sender e-mail address, type the email address of the service account: ARSService@mycompany.com.
-
In Name (used in the From field), type Active Roles.
-
Click Next, then click Finish.
You can create, configure, and apply the Policy Object that you need by using the New Deprovisioning Policy Object Wizard.
To configure the policy, on the Select Policy Type page of the wizard, click Notification Distribution. Then, click Next.
On the Notification Recipients and Message page, to display the Deprovisioning Notification Recipients dialog, click the button next to Notification recipients. In that dialog, type the administrator’s email address, for example, administrator@mydomain.com, then click OK.
Then, customize the message subject and the message body as necessary. For example, enter the following subject and body:
-
Message subject
Deprovisioning of %<objectClass> ’%<name>’ Requested
-
Message body
Deprovisioning of %<objectClass> ’%<name>’ is in progress. To complete the deprovisioning of that %<objectClass>, please take any additional deprovisioning actions, if necessary.
This notification was generated automatically by Active Roles according to corporate deprovisioning rules.
To display the Outgoing Mail Server page, click Next.
From the Outgoing mail server (SMTP) list, select Deprovisioning Notification Distribution, which is the email configuration that you created earlier. Then, click Next to display the Enforce Policy page.
On the Enforce Policy page, add the Active Directory folder to the list:
-
To display the Select Objects window, click Add.
-
To display the Browse for Container dialog, in the Select Objects window, click Browse.
-
In the Browse for Container dialog, click Active Directory, then click OK.
-
From the upper list in the Select Objects window, select Active Directory.
-
To close the Select Objects window, click Add, then click OK.
To close the wizard, click Next, then click Finish.
To apply the policy to the Active Directory folder, in the Console tree, you can also use the Enforce Policy command on the folder.
For more information on how to apply a Policy Object, see Linking Policy Objects to directory objects.
Report Distribution policies automatically send a report on deprovisioning results after completing a deprovisioning operation. As such, this policy is meant to inform designated persons about any problems that might occur when performing deprovisioning requests.
Reports are delivered via email. When configuring a Report Distribution policy, you can set up a list of report recipients, customize the subject of report messages, and specify whether to send a report if no errors occurred.
For a detailed description of this policy, see Concept: Report Distribution in the Active Roles Feature Guide.
You can configure a new Report Distribution policy via the Policy to Configure page of the Active Roles Console.
To configure a Report Distribution policy
-
On the Policy to Configure page, select Report Distribution Policy, then click Next.
-
On the Report Recipients and Message page, do the following, then click Next:
-
Click the button next to Report recipients, then select one or more email recipients.
-
In Message Subject, type the subject of the message that the specified recipients will receive upon completion of a deprovisioning operation.
Macros have the same syntax and semantics as values for policy conditions in Property Generation and Validation policies: An attribute’s LDAP display name enclosed in angle brackets (<>) and prefixed with the percent character (%) represents the value of that attribute. For instance, before sending a message, Active Roles replaces %<name> with the original name of the object that has been deprovisioned.
NOTE: Active Roles retrieves the attribute value prior to starting the deprovisioning operation so the value is current as of the time the deprovisioning process begins. Even if you have a deprovisioning policy configured to update a given attribute, the message reads the original rather than updated value of that attribute.
-
Select the Send out the report only if any errors occur check box if you want the policy not to send the report if no errors occurred during the deprovisioning operation. Clear the check box if you want the policy to send the report regardless of whether or not any errors occurred.
-
On the Outgoing Mail Server page, select the email configuration you want the policy to use. In the Outgoing mail server (SMTP) list, click the appropriate mail settings.
This page is similar to the respective wizard page for Notification Distribution policies. For more information, see Configuring a Notification Distribution policy). You can select the email configuration you want the policy to use, and view or modify email settings in the selected configuration.
First, from the Outgoing mail server (SMTP) list, select the email configuration you want the policy to use.
NOTE: By default, the Outgoing mail server (SMTP) list includes a single entry. You can add more entries to the list using the Active Roles Console. In the Console tree, expand Configuration/Server Configuration, right-click Mail Configuration, select New > Mail Configuration, then follow the instructions in the wizard.
-
If you want to view or modify the selected mail settings, click Settings, and use the Mail Setup tab. For more information, see Configuring email settings.
-
Click Next.
-
On the Enforce Policy page, you can specify objects to which this Policy Object is to be applied. To do so, click Add, then use the Select Objects dialog to locate and select the objects you want.
-
Click Next, and then click Finish.