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 you need by using the New Deprovisioning Policy Object Wizard. For information about the wizard, see Creating a Policy Object.
To configure the policy, click Notification Distribution on the Select Policy Type page of the wizard. Then, click Next.
On the Notification Recipients and Message page, click the button next to the Notification recipients box to display the Deprovisioning Notification Recipients dialog. In that dialog, type the administrator’s email address, such as administrator@mydomain.com, then click OK.
Then, customize the message subject and the message body as necessary. For example, you might enter the following subject and body:
-
Message subject
Deprovisioning of %<objectClass> ’%<name>’ Requested
-
Message body
Deprovisioning of %<objectClass> ’%<name>’ is in progress. Please take any additional deprovisioning actions, if necessary, to complete the deprovisioning of that %<objectClass>.
This notification was generated automatically by Active Roles according to corporate deprovisioning rules.
Click Next to display the Outgoing Mail Server page.
From the list in the Outgoing mail server (SMTP) box, select Deprovisioning Notification Distribution, which is the email configuration you created earlier. Then, click Next to display the Enforce Policy page.
Add the Active Directory folder to the list on the Enforce Policy page:
-
Click Add to display the Select Objects window.
-
In the Select Objects window, click Browse to display the Browse for Container dialog.
-
In the Browse for Container dialog, click Active Directory, then click OK.
-
From the upper list in the Select Objects window, select Active Directory.
-
Click Add, then click OK to close the Select Objects window.
Click Next, then click Finish to close the wizard.
You can also use the Enforce Policy command on the Active Directory folder in the Console tree to apply the policy to that folder. For more information on how to apply a Policy Object, see Applying Policy Objects and Managing policy scope.
Policies in this category are intended to automatically send a report on deprovisioning results upon completion of a deprovisioning operation. The primary purpose of such a policy is to inform designated persons about problems, if any encountered, when processing deprovisioning requests. These reports are discussed later in this chapter. For more information, see Report on deprovisioning results.
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.
Upon completion of a deprovisioning operation, Active Roles uses this policy to determine if the report on deprovisioning results must be sent. Then, Active Roles generates the report message and sends it to the recipients specified in the policy configuration. The report includes a list of actions taken during the deprovisioning operation. For each action, the report informs of whether the action is completed successfully, and provides information about the action results.
With the Report Distribution policy configured not to send reports if no errors occurred, Active Roles examines the deprovisioning results for errors. If there are no errors, the report is not sent.
Active Roles generates deprovisioning reports on a per-object basis: Each report message contains information on the deprovisioning of one object. When deprovisioning multiple objects, Active Roles sends multiple report messages, one message per deprovisioned object.
Active Roles sends report messages via an SMTP server. The policy configuration specifies the outbound SMTP server by using Active Roles email settings that include the name of the SMTP server and information required to connect to the SMTP server.