Repository files navigation

GSSAPI Console allows provides an easy way to test out Python applicationsusing GSSAPI in a self-contained environment.

By default, the console will set up a self-contained MIT krb5 environment.However, other GSSAPI environments are planned.

• python-gssapi >= 1.1.0
• Requirements for the environment used (for example, the default environment isMIT krb5, which uses thek5test)

gssapi-console will not work without first being installed. If you areworking from a local checkout, it suffices to dopip install -e . ..

further information is available by runninggssapi-console.py --help

The main executable of GSSAPI Console isgssapi-console.py. The basicinvocation works just like launchingpython -- usegssapi-console.py FILEto run a file in the established environment, or just rungssapi-console.pyorgssapi-console.py -i to get an interactive environment (the-i flagcan be used with a file, just likepython FILE -i).

There are several additional flags that may be passed togssapi-console.py:

• --realm-args key1=true,key2=false,... can be used to pass specific argumentsto the realm constructor (the set of such keys is driver-dependent)
• --mech MECH_NAME can be used to specify a different driver (currently, only--mech krb5 will work)
• -a IDENTIFIER, --attach IDENTIFIER may be used to "attach" a new GSSAPI Consolesession to an environment set up by an existing GSSAPI Console session. The identifierwill be noted at the top of the existing GSSAPI Console session asSession: IDENTIFIER.
• -v, --verbose may be used to increase the verbosity of the logging level (generally togain more details on what the driver is doing to set up the realm).

Additional GSSAPI Console drivers may be introduced using thegssapi_console.driverssetuptools entry point. They should follow thegssapi_console.drivers.GSSAPIConsoleDriverclass.

GSSAPI Console provides aYALPT environment driver forwriting tutorials and literate python files involving GSSAPI. You can use it by passing-e gssapi to YALPT (it will use the default GSSAPI Console driver in this case).