Arne Schwabe 20ce5e3173 Add example script demonstrating TOTP via auth-pending
Signed-off-by: Arne Schwabe <arne@rfc2549.org>

Patch v3: Some minor cleanups in the script (rename CNs, add more comments)

Signed-off-by: Arne Schwabe <arne@rfc2549.org>
Acked-by: David Sommerseth <davids@openvpn.net>
Message-Id: <20210304114018.8442-1-arne@rfc2549.org>
URL: https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg21603.html
Signed-off-by: Gert Doering <gert@greenie.muc.de>
2022-09-11 22:32:26 +02:00

112 lines
3.9 KiB
Python
Executable File

#! /usr/bin/python3
# Copyright (c) 2021 OpenVPN Inc <sales@openvpn.net>
# Copyright (c) 2021 Arne Schwabe <arne@rfc2549.org>
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
import sys
import os
from base64 import standard_b64decode
import pyotp
# Example script demonstrating how to use the auth-pending API in
# OpenVPN. This script is provided under MIT license to allow easy
# modification for other purposes.
#
# This needs support of crtext support on the client (e.g. OpenVPN for Android)
# See also the management-notes.txt file for more information about the auth pending
# protocol
#
# To use this script add the following lines in the openvpn config
# client-crresponse /path/to/totpauth.py
# auth-user-pass-verify /path/to/totpauth.py via-file
# auth-user-pass-optional
# auth-gen-token
# Note that this script does NOT verify username/password
# It is only meant for querying additional 2FA when certificates are
# used to authenticate
# For this demo script we hardcode the TOTP secrets in a simple dictionary.
secrets = {"Test-Client": "OS6JDNRK2BNUPQVX",
"Client-2": "IXWEMP7SK2QWSHTG"}
def main():
# Get common name and script type from environment
script_type = os.environ['script_type']
cn = os.environ['common_name']
if script_type == 'user-pass-verify':
# signal text based challenge response
if cn in secrets:
extra = "CR_TEXT:E,R:Please enter your TOTP code!"
write_auth_pending(300, 'crtext', extra)
# Signal authentication being deferred
sys.exit(2)
else:
# For unknown CN we report failure. Change to 0
# to allow CNs without secret to auth without 2FA
sys.exit(1)
elif script_type == 'client-crresponse':
response = None
# Read the crresponse from the argument file
# and convert it into text. A failure because of bad user
# input (e.g. invalid base64) will make the script throw
# an error and make OpenVPN return AUTH_FAILED
with open(sys.argv[1], 'r') as crinput:
response = crinput.read()
response = standard_b64decode(response)
response = response.decode().strip()
if cn not in secrets:
write_auth_control(1)
return
totp = pyotp.TOTP(secrets[cn])
# Check if the code is valid (and also allow code +/-1)
if totp.verify(response, valid_window=1):
write_auth_control(1)
else:
write_auth_control(0)
else:
print(f"Unknown script type {script_type}")
sys.exit(1)
def write_auth_control(status):
with open(os.environ['auth_control_file'], 'w') as auth_control:
auth_control.write("%d" % status)
def write_auth_pending(timeout, method, extra):
with open(os.environ['auth_pending_file'], 'w') as auth_pending:
auth_pending.write("%d\n%s\n%s" % (timeout, method, extra))
if __name__ == '__main__':
main()