authenticate with your MFA enabled Microsoft-Account into the openconnect VPN client

renovate [bot] f3263310fb Update python Docker tag 3 rokov pred
.vscode f34f4fc42f Initial commit 4 rokov pred
ocma 7982949e0d Add typed marker 3 rokov pred
tests 0be3489ccb Add docs to tests package 3 rokov pred
.drone.yml f3263310fb Update python Docker tag 3 rokov pred
.gitignore f34f4fc42f Initial commit 4 rokov pred
.mypy.ini f34f4fc42f Initial commit 4 rokov pred
.pre-commit-config.yaml c12ab0523a Fix pylint and pydocstyle issues 3 rokov pred
.pylintrc c12ab0523a Fix pylint and pydocstyle issues 3 rokov pred
Dockerfile f3263310fb Update python Docker tag 3 rokov pred
license.md 491d8b6ade Add license 4 rokov pred
poetry.lock eb1caaf4ba Update deps 3 rokov pred
pyproject.toml 7982949e0d Add typed marker 3 rokov pred
readme.md 1fb95c6f41 Add upgrade instruction 4 rokov pred
renovate.json 0547f1134b Add renovate config 3 rokov pred

readme.md

Openconnect MS-Auth

This package allows you to authenticate with your MFA enabled Microsoft-Account into the openconnect VPN client.

It uses selenium to open the login webpage and fill in the form details. At the end, it fetches the correct VPN HOST and the Cisco AnyConnect webvpn cookie.

Installation for CLI usage

Simply run pip install --upgrade git+https://git.snas.black-burn.ch/FHNW/openconnect-ms-auth to install the package globally. Then the "ocma" command should be available. Try it out by typing ocma -h.

Example CLI usage

Replace [username] and [password] with your own information. If you have your account secured with a TOTP MFA, provide the -m flag with the TOTP secret as the value.

Example of a TOTP url: otpauth://totp/FHNW%3Aelon.musk%40students.fhnw.ch?secret=NBSWY3DPEB3W64TMMQ&issuer=Microsoft The secret in this case would be NBSWY3DPEB3W64TMMQ. This needs to be provided as an input.

eval $( ocma -u [username] -p [password] -m [mfa_secret] --print-to-stdout );
[ -n $VPN_COOKIE ] && echo $VPN_COOKIE | sudo openconnect --cookie-on-stdin $VPN_HOST

Example usage in a Python project

Add with poetry: poetry add git+https://git.snas.black-burn.ch/FHNW/openconnect-ms-auth

from ocma import connect

connect.login(
    username="username",
    password="password",
    mfa_secret="mfa_secret"
)