Configuring a Text File Management Agent

Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration

MICROSOFT MAKES NO WARRANTIES, EXPRESS OR IMPLIED, IN THIS DOCUMENT. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, our provision of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. The descriptions of other companies’ products in this document, if any, are provided only as a convenience to you. Any such references should not be considered an endorsement or support by Microsoft. Microsoft cannot guarantee their accuracy, and the products may change over time. Also, the descriptions are intended as brief highlights to aid understanding, rather than as thorough coverage. For authoritative descriptions of these products, please consult their respective manufacturers. © 2013 Microsoft Corporation. All rights reserved. Any use or distribution of these materials without express authorization of Microsoft Corp. is strictly prohibited. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

ii Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration Configuring a Text File Management Agent

Now we will create a management agent based on a flat text file. To being, navigate to your Synchronization server.

From here, click “Create”. Using the “Management agent for:” drop down menu, select “Delimited text file”. Enter a name, then click “Next”.

Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration

It is necessary to input a “template” file so that FIM may know the formatting. It is perfectly acceptable here to use the actual user data containing file as the template. To locate it, click “Browse”.

Select the text file you wish to use and click “Open”, then click “Next” to continue.

If your input text file has a header row (such as the below example), place a check in the box next to “Use first row for header names”. Select the delimiter type and text qualifier. In this scenario, we are delimiting with commas and using an apostrophe as a qualifier. Click “Next” to continue.

Here we should see all the attributes being read in from the file. If any of these are multi-valued and need to be changed, select “Edit”. Also, under “Configure special attributes”, select “Set Anchor…”

This will display the “Set Anchor” dialogue. Select an anchor attribute from the left-hand list and click “Add”. Note that an anchor attribute must be present and unique on each side (i.e. text file as well as inside FIM). Once selected, click “OK”.

For “Define Object Types”, we may leave these default. Click “Next” to continue.

For “Configure Connector Filter”, we will leave these default. Click “Next” to continue.

For “Configure Join and Projection Rules”, you may wish to include join logic. If so, click “New Join Rule..”

In this scenario, I am creating a “Direct” join mapping of “PoliticianID” to “PoliticianID”. This is because I know (in this environment) it is unique for every user object. Click on “Add Condition” and then click “OK”. Click “Next” to continue.

For “Configure Attribute Flow”, we will leave this default. By doing so, we will pull all available attributes from the source file into FIM and then manipulate them there (based on workflows, sets and synchronization rules). Click “Next” to continue.

For “Configure Deprovisioning”, we may leave this default or select another option based on your environment. Click “Next” to continue.

Click “Finish” to complete.

We should now see our newly created management agent.

Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering