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

Sean dc6827018d Merge branch 'renovate/python-3.x' 3 gadi atpakaļ
.vscode f34f4fc42f Initial commit 4 gadi atpakaļ
ocma 7982949e0d Add typed marker 3 gadi atpakaļ
tests 0be3489ccb Add docs to tests package 3 gadi atpakaļ
.drone.yml 8b263b2d33 Merge branch 'renovate/python-3.x' of ssh://git.snas.black-burn.ch:43057/FHNW/openconnect-ms-auth into renovate/python-3.x 3 gadi atpakaļ
.gitignore f34f4fc42f Initial commit 4 gadi atpakaļ
.mypy.ini f34f4fc42f Initial commit 4 gadi atpakaļ
.pre-commit-config.yaml c12ab0523a Fix pylint and pydocstyle issues 3 gadi atpakaļ
.pylintrc c12ab0523a Fix pylint and pydocstyle issues 3 gadi atpakaļ
Dockerfile f3263310fb Update python Docker tag 3 gadi atpakaļ
license.md 491d8b6ade Add license 4 gadi atpakaļ
poetry.lock fe95efe96f Update dependency mypy to ^0.971 3 gadi atpakaļ
pyproject.toml fe95efe96f Update dependency mypy to ^0.971 3 gadi atpakaļ
readme.md 1fb95c6f41 Add upgrade instruction 4 gadi atpakaļ
renovate.json 0547f1134b Add renovate config 3 gadi atpakaļ

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"
)