2020-02-05 23:29:01 +01:00
#!/usr/bin/env sh
# Script to deploy certificates to Palo Alto Networks PANOS via API
# Note PANOS API KEY and IP address needs to be set prior to running.
# The following variables exported from environment will be used.
# If not set then values previously saved in domain.conf file are used.
#
# Firewall admin with superuser and IP address is required.
#
# export PANOS_USER="" # required
# export PANOS_PASS="" # required
# export PANOS_HOST="" # required
2023-04-24 20:45:50 +02:00
# export PANOS_KEY="" # optional
2020-02-05 23:29:01 +01:00
# This function is to parse the XML
parse_response( ) {
2020-02-12 03:15:10 +01:00
type = $2
2020-02-12 07:26:48 +01:00
if [ " $type " = 'keygen' ] ; then
2020-02-12 03:15:10 +01:00
status = $( echo " $1 " | sed 's/^.*\([' \' ']\)\([a-z]*\)' \' '.*/\2/g' )
if [ " $status " = "success" ] ; then
panos_key = $( echo " $1 " | sed 's/^.*\(<key>\)\(.*\)<\/key>.*/\2/g' )
_panos_key = $panos_key
else
message = "PAN-OS Key could not be set."
fi
else
status = $( echo " $1 " | sed 's/^.*"\([a-z]*\)".*/\1/g' )
message = $( echo " $1 " | sed 's/^.*<result>\(.*\)<\/result.*/\1/g' )
2023-04-24 20:45:50 +02:00
if [ " $type " = 'testkey' ] && [ " $status " != "success" ] ; then
2023-04-13 00:00:53 +02:00
_debug "**** Saved API key is invalid ****"
unset _panos_key
fi
2020-02-12 03:15:10 +01:00
fi
2020-02-05 23:29:01 +01:00
return 0
}
deployer( ) {
2020-02-14 03:01:27 +01:00
content = ""
2023-04-13 00:00:53 +02:00
type = $1 # Types are testkey, keygen, cert, key, commit
_debug " **** Deploying $type **** "
2020-02-12 03:15:10 +01:00
panos_url = " https:// $_panos_host /api/ "
2023-04-24 20:45:50 +02:00
2023-04-13 00:00:53 +02:00
#Test API Key by performing an empty commit.
if [ " $type " = 'testkey' ] ; then
_H1 = "Content-Type: application/x-www-form-urlencoded"
content = " type=commit&cmd=<commit></commit>&key= $_panos_key "
fi
# Generate API Key
2020-02-12 07:26:48 +01:00
if [ " $type " = 'keygen' ] ; then
2020-02-12 03:15:10 +01:00
_H1 = "Content-Type: application/x-www-form-urlencoded"
content = " type=keygen&user= $_panos_user &password= $_panos_pass "
# content="$content${nl}--$delim${nl}Content-Disposition: form-data; type=\"keygen\"; user=\"$_panos_user\"; password=\"$_panos_pass\"${nl}Content-Type: application/octet-stream${nl}${nl}"
2020-02-05 23:29:01 +01:00
fi
2020-02-12 03:15:10 +01:00
2020-02-12 07:26:48 +01:00
if [ " $type " = 'cert' ] || [ " $type " = 'key' ] ; then
2020-02-12 07:34:55 +01:00
#Generate DEIM
delim = " -----MultipartDelimiter $( date "+%s%N" ) "
nl = "\015\012"
#Set Header
export _H1 = " Content-Type: multipart/form-data; boundary= $delim "
2020-02-12 07:26:48 +01:00
if [ " $type " = 'cert' ] ; then
2020-03-25 04:01:51 +01:00
panos_url = " ${ panos_url } ?type=import "
content = " -- $delim ${ nl } Content-Disposition: form-data; name=\"category\"\r\n\r\ncertificate "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"certificate-name\"\r\n\r\n $_cdomain "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"key\"\r\n\r\n $_panos_key "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"format\"\r\n\r\npem "
2020-02-12 03:15:10 +01:00
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"file\"; filename=\" $( basename " $_cfullchain " ) \" ${ nl } Content-Type: application/octet-stream ${ nl } ${ nl } $( cat " $_cfullchain " ) "
fi
2020-02-12 07:26:48 +01:00
if [ " $type " = 'key' ] ; then
2020-03-25 04:01:51 +01:00
panos_url = " ${ panos_url } ?type=import "
content = " -- $delim ${ nl } Content-Disposition: form-data; name=\"category\"\r\n\r\nprivate-key "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"certificate-name\"\r\n\r\n $_cdomain "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"key\"\r\n\r\n $_panos_key "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"format\"\r\n\r\npem "
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"passphrase\"\r\n\r\n123456 "
2023-03-31 02:33:44 +02:00
content = " $content ${ nl } -- $delim ${ nl } Content-Disposition: form-data; name=\"file\"; filename=\" $( basename " $_cdomain .key " ) \" ${ nl } Content-Type: application/octet-stream ${ nl } ${ nl } $( cat " $_ckey " ) "
2020-02-12 03:15:10 +01:00
fi
#Close multipart
2020-03-25 04:01:51 +01:00
content = " $content ${ nl } -- $delim -- ${ nl } ${ nl } "
2020-02-12 03:15:10 +01:00
#Convert CRLF
content = $( printf %b " $content " )
2020-02-05 23:29:01 +01:00
fi
2020-02-12 07:26:48 +01:00
if [ " $type " = 'commit' ] ; then
2020-02-12 07:23:10 +01:00
export _H1 = "Content-Type: application/x-www-form-urlencoded"
2020-02-12 03:15:10 +01:00
cmd = $( printf "%s" " <commit><partial>< $_panos_user ></ $_panos_user ></partial></commit> " | _url_encode)
content = " type=commit&key= $_panos_key &cmd= $cmd "
2020-02-05 23:29:01 +01:00
fi
2020-02-12 03:15:10 +01:00
response = $( _post " $content " " $panos_url " "" "POST" )
2020-02-12 07:23:10 +01:00
parse_response " $response " " $type "
2020-02-05 23:29:01 +01:00
# Saving response to variables
response_status = $status
#DEBUG
_debug response_status " $response_status "
if [ " $response_status " = "success" ] ; then
_debug " Successfully deployed $type "
return 0
else
_err " Deploy of type $type failed. Try deploying with --debug to troubleshoot. "
_debug " $message "
return 1
fi
}
# This is the main function that will call the other functions to deploy everything.
panos_deploy( ) {
2023-04-24 20:45:50 +02:00
_cdomain = $( echo " $1 " | sed 's/*/WILDCARD_/g' ) #Wildcard Safe Filename
2020-02-05 23:29:01 +01:00
_ckey = " $2 "
_cfullchain = " $5 "
2023-03-31 02:33:44 +02:00
# VALID ECC KEY CHECK
2023-04-24 20:45:50 +02:00
keysuffix = $( printf '%s' " $_ckey " | tail -c 8)
if [ " $keysuffix " = "_ecc.key" ] && [ ! -f " $_ckey " ] ; then
_debug " The ECC key $_ckey doesn't exist. Attempting to strip '_ecc' from the key name "
_ckey = $( echo " $_ckey " | sed 's/\(.*\)_ecc.key$/\1.key/g' )
if [ ! -f " $_ckey " ] ; then
_err "Unable to find a valid key. Try issuing the certificate using RSA (non-ECC) encryption."
return 1
2023-03-31 02:33:44 +02:00
fi
fi
2020-02-12 23:57:31 +01:00
# PANOS ENV VAR check
if [ -z " $PANOS_USER " ] || [ -z " $PANOS_PASS " ] || [ -z " $PANOS_HOST " ] ; then
_debug "No ENV variables found lets check for saved variables"
_getdeployconf PANOS_USER
_getdeployconf PANOS_PASS
_getdeployconf PANOS_HOST
2023-04-24 20:45:50 +02:00
_getdeployconf PANOS_KEY
2020-02-12 23:57:31 +01:00
_panos_user = $PANOS_USER
_panos_pass = $PANOS_PASS
_panos_host = $PANOS_HOST
2023-04-24 20:45:50 +02:00
_panos_key = $PANOS_KEY
2020-02-12 23:57:31 +01:00
if [ -z " $_panos_user " ] && [ -z " $_panos_pass " ] && [ -z " $_panos_host " ] ; then
_err "No host, user and pass found.. If this is the first time deploying please set PANOS_HOST, PANOS_USER and PANOS_PASS in environment variables. Delete them after you have succesfully deployed certs."
2020-02-05 23:29:01 +01:00
return 1
else
2020-02-12 23:57:31 +01:00
_debug "Using saved env variables."
2020-02-05 23:29:01 +01:00
fi
else
2020-02-12 23:57:31 +01:00
_debug "Detected ENV variables to be saved to the deploy conf."
2020-02-05 23:29:01 +01:00
# Encrypt and save user
2020-02-12 23:57:31 +01:00
_savedeployconf PANOS_USER " $PANOS_USER " 1
_savedeployconf PANOS_PASS " $PANOS_PASS " 1
_savedeployconf PANOS_HOST " $PANOS_HOST " 1
2020-02-05 23:29:01 +01:00
_panos_user = " $PANOS_USER "
_panos_pass = " $PANOS_PASS "
2020-02-12 23:57:31 +01:00
_panos_host = " $PANOS_HOST "
2023-04-24 20:45:50 +02:00
if [ " $PANOS_KEY " ] ; then
_savedeployconf PANOS_KEY " $PANOS_KEY " 1
_panos_key = " $PANOS_KEY "
else
_getdeployconf PANOS_KEY
_panos_key = $PANOS_KEY
fi
2020-02-05 23:29:01 +01:00
fi
_debug "Let's use username and pass to generate token."
if [ -z " $_panos_user " ] || [ -z " $_panos_pass " ] || [ -z " $_panos_host " ] ; then
_err "Please pass username and password and host as env variables PANOS_USER, PANOS_PASS and PANOS_HOST"
return 1
else
2023-04-24 20:45:50 +02:00
#Test API Key
2023-04-13 00:00:53 +02:00
if [ " $_panos_key " ] ; then
_debug "**** Testing Saved API KEY ****"
deployer testkey
fi
2023-04-24 20:45:50 +02:00
# Generate a new API key if no valid key exists
2023-04-13 00:00:53 +02:00
if [ -z " $_panos_key " ] ; then
_debug "**** Generating new PANOS API KEY ****"
deployer keygen
_savedeployconf PANOS_KEY " $_panos_key " 1
fi
2023-04-24 20:45:50 +02:00
# Confirm that a valid key was generated
2020-02-12 03:15:10 +01:00
if [ -z " $_panos_key " ] ; then
2020-02-12 23:57:31 +01:00
_err "Missing apikey."
2020-02-05 23:29:01 +01:00
return 1
else
deployer cert
deployer key
deployer commit
fi
fi
2020-02-12 07:34:55 +01:00
}