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”.
Page 3 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”.
Page 4 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
Select the text file you wish to use and click “Open”, then click “Next” to continue.
Page 5 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
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.
Page 6 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
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…”
Page 7 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
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”.
Page 8 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
For “Define Object Types”, we may leave these default. Click “Next” to continue.
Page 9 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
For “Configure Connector Filter”, we will leave these default. Click “Next” to continue.
Page 10 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
For “Configure Join and Projection Rules”, you may wish to include join logic. If so, click “New Join Rule..”
Page 11 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
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.
Page 12 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
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.
Page 13 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
For “Configure Deprovisioning”, we may leave this default or select another option based on your environment. Click “Next” to continue.
Page 14 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
Click “Finish” to complete.
Page 15 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
We should now see our newly created management agent.
Page 16 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering Forefront Identity Manager 2010 Installation & Configuration
Page 17 Prepared by Anthony Marsiglia & Kristopher Tackett Microsoft Premier Field Engineering