ethz_iam_webservice 0.0.5

Manage users, groups and services of the ETH Identity and Access Management system (IAM)

ETHZ IAM Webservice

Manage users, groups and services of the ETH Identity and Access Management system (IAM)

Synopsis

Beginning

import ethz_iam_webservice
import getpass

e = ethz_iam_webservice.login('admin4iam', getpass.getpass())

Person

person = e.get_person('[e-mail]')
person = e.get_person('some_username')
person = e.get_person(123456) # npid, the identifer of every person

person.usernames     # an array of dicts of usernames
person.data          # the whole response
person.firstname
person.familyname
person.email
# etc.

User

user = person.new_user('username', 'password', 'description')
user = e.get_user('username')
user.services        # returns an array of dicts of services

user.grant_service("LDAPS")
user.grant_service("Active Directory")
user.grant_service("WLAN_VPN")

user.revoke_service("LDAP")

user.delete()  # Method currently not allowed
user.add_to_group('groupname')
user.remove_from_group('groupname')

Group and Group Members

group = e.get_group('groupname')
group.data          # all data received from webservice
group.members       # returns array of usernames or group-names
group.gidNumber
...

group.add_members('some', 'new', 'members')
group.set_members('just', 'these')
group.del_members('remove', 'these', 'members')

groups = e.get_groups(agroup='ID SIS')
groups = e.get_groups(name='starts_with*')
groups = e.get_groups(agroup='ID SIS', name='starts_with*')

Mailinglists

ml = e.get_mailinglist('ID.SIS.SSDM')
ml = e.get_mailinglist('[e-mail]')
ml.name
ml.mail
ml.gidNumber
ml.groupType
ml.displayName
...

ml.members        # returns all (direct) members of that list
ml.add_members('user1', 'user2')
ml.del_members('user3, 'user4')

See also FAQ