[[TOC(Software/eAM/*, depth=3)]]


== Delegated Account Management ==

This AM group is enabling remote account management. Users can belong to multiple groups

==== deleteGroup - Delete delegated group ====

{{{
<service name="deleteGroup">
  <info>Delete group/project created by external account manager</info>
  <args>
    <arg isRequired="true" name="groupname" value="groupname">
      <info>Group/project name to delete</info>
    </arg>
     <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
 </args>
</service>
}}}

==== getGroupsAndUsers - Get all delegated users and groups ====

{{{
<service name="getGroupsAndUsers">
  <info>Show inventory of delegated users and groups/projects</info>
  <args>
    <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
  </args>
</service>
}}}

==== changeGroupAdmin - Change the leader of the group ====

{{{
<service name="changeGroupAdmin">
  <info>Change the administrator of the group/project</info>
  <args>
     <arg isRequired="true" name="username" value="username">
       <info>User name of the new admin</info>
     </arg>
     <arg isRequired="true" name="groupname" value="groupname">
       <info>Group/project name</info>
     </arg>
    <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
  </args>
</service>
}}}

==== addUserForm - Show the form for uploading the new user LDIF ====

{{{
<service name="addUserForm">
  <info>Show browser form to upload new user's LDIF</info>
</service>
}}}

==== saveForm - process the new user LDIF ====

{{{
<service name="saveUser">
  <info>Parse uploaded LDIF and create user account</info>
</service>
}}}

==== deleteUser - Delete user ====

{{{
<service name="deleteUser">
  <info>Delete user created by external source</info>
  <args>
    <arg isRequired="true" name="user" value="user">
      <info>User DN to delete</info>
    </arg>
    <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
  </args>
</service>
}}}

==== moveUser - Change users primary group ====

{{{
<service name="moveUser">
  <info>Change user's project</info>
  <args>
    <arg isRequired="true" name="user" value="user">
      <info>User DN</info>
    </arg>
    <arg isRequired="true" name="group" value="group">
      <info>User's new primary group/project DN</info>
    </arg>
    <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
  </args>
</service>
}}}

==== addUserToGroup - Add user to the secondary group/project ====

{{{
<service name="addUserToGroup">
  <info>Add user to new secondary group/project</info>
  <args>
    <arg isRequired="true" name="user" value="user">
      <info>User DN</info>
    </arg>
    <arg isRequired="true" name="group" value="group">
      <info>Group/project DN</info>
    </arg>
    <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
  </args>
</service>
}}}

==== deleteGroupUser - Delete user from the secondary group/project ====

{{{
<service name="deleteUserFromGroup">
  <info>Delete user from the group/project</info>
  <args>
    <arg isRequired="true" name="user" value="user">
      <info>User DN</info>
    </arg>
    <arg isRequired="true" name="group" value="group">
      <info>Group/project DN</info>
    </arg>
    <arg isRequired="false" name="baseDN" value="[baseDN]">
      <info>baseDN</info>
    </arg>
  </args>
</service>
}}}


== Error Messages ==

=== Generic errors ===
 1. ERROR 1: UID and OU and DC match
 2. ERROR 2: UID and DC match but OU is different
 3. ERROR 3: UID matches but DC and OU are different
 4. ERROR 4: UID and OU match but DC is different
 5. ERROR 5: Uknonw user DN:
 6. ERROR 6: Cannot delete user: User is a admin for a group
 7. ERROR 7: Unknown group DN:
 8. ERROR 8: Group/project not deleted because it contains admin(s):
 9. ERROR 9: Cannot move users: different DCs
 10. ERROR 10: Missing OU LDIF entry
 11. ERROR 11: Missing group name attribute in OU entry
 12. ERROR 12: Missing objectClass attribute (organizationalUnit/organizationalRole/organizationalUnit) for:
=== Group manipulation errors ===
 20. ERROR 20: Group exists
 21. ERROR 21: Missing PI mail:
 22. ERROR 22: Missing PI ssh public key:
=== User manipulation errors ===
 30. ERROR 30: Missing username (UID)
 31. ERROR 31: Organization does not exist for this user. Missing organization LDIF entry
 32. ERROR 32: Missing user's email address
 33. ERROR 33: Missing user's ssh public key: