ETHZ IAM Webservice

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

Command Line Interface

When installing this module, the iam command is also installed. The basic parameters which are always needed – otherwise they will be asked interactivley – are:

$ iam -u admin-username --password MY-SECRET-PASSWORD

You can also set these environment variables instead:

$ export IAM_USERNAME=admin-username
$ export IAM_PASSWORD=MY-SECRET-PASSWORD

Group

$ iam group --help                           # get extensive help text
# create new group
$ iam group --new id-test-test-01 --ag "ID SIS" -d 'some test description' -t AD -t LDAP ou=AGRL
$ iam group <group-name>                     # info about a group
$ iam group <group-name> -a user1 -a user2   # add new users
$ iam group <group-name> -r user3 -r user4   # remove users

Mailing list

$ iam maillist --help                           # get extensive help text
$ iam maillist <group-name>                     # info about a group
$ iam maillist <group-name> -a user1 -a user2   # add new users
$ iam maillist <group-name> -r user3 -r user4   # remove users

User

Get info about a person (identity). You might either provide a username, a NPID or a email address.

$ iam user --help
$ iam user username
$ iam user some.person@ethz.ch
$ iam user 123445

Guest

Create guests. For the new guest a new username will automatically be generated. This user gets LDAP and VPN service granted. Because by policy the VPN password needs to differ from the other passwords, the result will present the two initial passwords that are set shortly after creating the guest.

CLI

$ iam guest get <username>
$ iam guest new --help
$ iam guest new -f firstname -l lastname -m first.last@unknown.org -d "my test guest" -h host_username -a "Admingroup Name"
{
    "firstName": "first",
    "lastName": "last",
    "mail ": "first.last@unknown.org",
    "host ": "host_username",
    "respAdminRole ": "Admingroup Name",
    "description": "my test guest",
    "dateOfBirth": "16.06.2000",
    "guestTechnicalContact": "somebody@ethz.ch",
    "notification": "To guest and host",
    "hostOrg": "06006",
    "startDate": "16.06.2021",
    "endDate": "16.06.2022",
    "username": "flast",
    "npid": "3210159",
    "init_ldap_password": "xxxxxxx",
}

Default values:

--technicalContact / -c will default to the email address of the host
--notification / -n will default to «gh», meaning guest and host will be notified when a guest account expires.
--startDate / -s is today.
--endDate / -e is today + 1 year
--dateOfBirth / -b is today's date in year 2000

Extend guest. After a year, you might want to extend the validity of your guest by another year or by a specific number of months

$ iam guest extend <username>               # will extend the guest by 1 year
$ iam guest extend <username> -m 6          # extend it by today+6 months
$ iam guest extend <username> -e 1.4.2022   # extend it until April 1st. 2022
$ iam guest extend <username> -e 2022-04-01 # same thing, different date format

Metadata

Release files for ethz_iam_webservice 0.16.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ethz_iam_webservice 0.16.11
File	Size	Uploaded
ethz_iam_webservice-0.16.11.tar.gz	26.7 kB	May 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ethz_iam_webservice 0.16.11
File	Interpreter	ABI	Platform	Reset
ethz_iam_webservice-0.16.11-py3-none-any.whl 29.8 kB May 28, 2026	Python 3	none	any	Details

Total release size: 56.5 kB

Release files / ethz_iam_webservice-0.16.11.tar.gz

Download URL	ethz_iam_webservice-0.16.11.tar.gz
Size	26.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`5f6756f6d3accaa76d06848ab8e1fa484d1eb5075fdb088bb20ab0955c151bf3`
BLAKE2b-256 checksum How to use checksums	`3093fc62e15a025e9ac6e5aed7c464f7b30268fed777c17ad536937dc984a07f`
Upload date	May 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Alpine Linux","version":"3.23.4","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / ethz_iam_webservice-0.16.11-py3-none-any.whl

Download URL	ethz_iam_webservice-0.16.11-py3-none-any.whl
Size	29.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2d594d43e29b9deea50c168183c167605a5aeddc0c3fc9a5ff5105038452915b`
BLAKE2b-256 checksum How to use checksums	`1a2554ad1458ce5bc60249bf4fd39986bc5bb8c01c0ec0915e8f5c2ec467c970`
Upload date	May 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Alpine Linux","version":"3.23.4","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`