This scenario describes how to configure a policy so that the administrator is notified of deprovisioning objects in any domain registered with Active Roles (managed domain).
To implement this scenario, you must perform the following actions:
- Create the appropriate e-mail configuration.
- Create, configure, and apply the Policy Object that defines the appropriate policy.
As a result, upon a request to deprovision an object such as a user or group in any managed domain, the administrator receives an e-mail message informing of the deprovisioning request. The message includes the name of the object to deprovision.
The following two sections elaborate on the steps to implement this scenario.
Step 1: Creating the e-mail configuration
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 e-mail address of ARSService@mycompany.com.
Create the e-mail 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 e-mail address of the service account: ARSService@mycompany.com.
- In Name (used in the From field), type Active Roles.
- Click Next, and then click Finish.
Step 2: Creating, configuring, and applying the Policy Object
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 in the Policy Object management tasks section earlier in this chapter.
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 box. In that dialog box, type the administrator’s e-mail address, such as administrator@mydomain.com, and 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—the e-mail configuration you created in Step 1. Then, click Next to display the Enforce Policy page.
Add the Active Directory folder to the list on the Enforce Policy page:
- Click the Add button to display the Select Objects window.
- In the Select Objects window, click the Browse button to display the Browse for Container dialog box.
- In the Browse for Container dialog box, click Active Directory, and then click OK.
- From the upper list in the Select Objects window, select Active Directory.
- Click Add, and then click OK to close the Select Objects window.
Click Next, and 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 earlier in this chapter.
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 (see the Report on deprovisioning results section).
Reports are delivered via e-mail. 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.