CLI script to programmatically replace SSL certs on Synology NAS

replace_synology_ssl_certs.sh

#!/bin/bash
#
# *** For DSM v7.x ***
#
# How to use this script:
#  1. Get your 3 PEM files ready to copy over from your local machine/update server (privkey.pem, fullchain.pem, cert.pem)
#     and put into a directory (this will be $CERT_DIRECTORY).
#     Personally, I use this script (https://gist.github.com/catchdave/3f6f412bbf0f0cec32469fb0c9747295) to automate steps 1 & 4.
#  2. Ensure you have a user setup on synology that has ssh access (and ssh access is setup).
#     This user will need to be able to sudo as root (i.e. add this line to sudoers, <USER> is the user you create):
#       <USER> ALL=(ALL) NOPASSWD: /var/services/homes/<USER>/replace_certs.sh
#  3. Copy this script to Synology: sudo scp replace_synology_ssl_certs.sh $USER@$SYNOLOGY_SERVER:~/
#  4. Call this script as follows:
#     sudo bash -c scp ${CERT_DIRECTORY}/{privkey,fullchain,cert}.pem $USER@$SYNOLOGY_SERVER:/tmp/ \
#     && ssh $USER@$SYNOLOGY_SERVER 'sudo ./replace_synology_ssl_certs.sh'

# Script start.

DEBUG=  # Set to any non-empty value to turn on debug mode
error_exit() { echo "[ERROR] $1"; exit 1; }
warn() { echo "[WARN ] $1"; }
info() { echo "[INFO ] $1"; }
debug() { [[ "${DEBUG}" ]] && echo "[DEBUG ] $1"; }

# 1. Initialization
# =================
[[ "$EUID" -ne 0 ]] && error_exit "Please run as root"  # Script only works as root

certs_src_dir="/usr/syno/etc/certificate/system/default"
services_to_restart=("nmbd" "avahi" "ldap-server")
packages_to_restart=("ScsiTarget" "SynologyDrive" "WebDAVServer" "ActiveBackup")
target_cert_dirs=(
    "/usr/syno/etc/certificate/system/FQDN"
    "/usr/local/etc/certificate/ScsiTarget/pkg-scsi-plugin-server/"
    "/usr/local/etc/certificate/SynologyDrive/SynologyDrive/"
    "/usr/local/etc/certificate/WebDAVServer/webdav/"
    "/usr/local/etc/certificate/ActiveBackup/ActiveBackup/"
    "/usr/syno/etc/certificate/smbftpd/ftpd/")

# Add the default directory
default_dir_name=$(</usr/syno/etc/certificate/_archive/DEFAULT)
if [[ -n "$default_dir_name" ]]; then
    target_cert_dirs+=("/usr/syno/etc/certificate/_archive/${default_dir_name}")
    debug "Default cert directory found: '/usr/syno/etc/certificate/_archive/${default_dir_name}'"
else
    warn "No default directory found. Probably unusual? Check: 'cat /usr/syno/etc/certificate/_archive/DEFAULT'"
fi

# Add reverse proxy app directories
for proxy in /usr/syno/etc/certificate/ReverseProxy/*/; do
    debug "Found proxy dir: ${proxy}"
    target_cert_dirs+=("${proxy}")
done

[[ "${DEBUG}" ]] && set -x

# 2. Move and chown certificates from /tmp to default directory
# =============================================================
mv /tmp/{privkey,fullchain,cert}.pem "${certs_src_dir}/" || error_exit "Halting because of error moving files"
chown root:root "${certs_src_dir}/"{privkey,fullchain,cert}.pem || error_exit "Halting because of error chowning files"
info "Certs moved from /tmp & chowned."

# 3. Copy certificates to target directories if they exist
# ========================================================
for target_dir in "${target_cert_dirs[@]}"; do
    if [[ ! -d "$target_dir" ]]; then
      debug "Target cert directory '$target_dir' not found, skipping..."
      continue
    fi

    info "Copying certificates to '$target_dir'"
    if ! (cp "${certs_src_dir}/"{privkey,fullchain,cert}.pem "$target_dir/" && \
        chown root:root "$target_dir/"{privkey,fullchain,cert}.pem); then
          warn "Error copying or chowning certs to ${target_dir}"
    fi
done

# 4. Restart services & packages
# ==============================
info "Rebooting all the things..."
for service in "${services_to_restart[@]}"; do
    /usr/syno/bin/synosystemctl restart "$service"
done
for package in "${packages_to_restart[@]}"; do  # Restart packages that are installed & turned on
    /usr/syno/bin/synopkg is_onoff "$package" 1>/dev/null && /usr/syno/bin/synopkg restart "$package"
done

# Faster ngnix restart (if certs don't appear to be refreshing, change to synosystemctl
if ! (/usr/syno/bin/synow3tool --gen-all && sudo systemctl reload nginx); then
    warn "nginx failed to restart"
fi

info "Completed"

BTW @catchdave thank you SO much for this script! It’s made ssl renewals and applications incredibly simple and reliable. I’m all about “no human interaction” automation and this and the derivatives have been key to that for me!

Thanks you very much for this scripts which is a great help!!
I managed to make it work on my NAS from an NGINX linux server that is used as reverse proxy for all my services. The wildcard let's encrypt certificate for my domain is generated from that server too which explain why this script is perfect for me.

I have a question (hope not too stupid); how did you managed to avoid having to write the password of the user created on synology each time the commands are sent?

When using this command from my nginx server, the password for the synology user is requested twice (for the 2 actions it does)

sudo bash -c scp ${CERT_DIRECTORY}/{privkey,fullchain,cert}.pem $USER@$SYNOLOGY_SERVER:/tmp/ \
     && ssh $USER@$SYNOLOGY_SERVER 'sudo ./replace_synology_ssl_certs.sh'

I would like to find a way to do it passwordless so that I can put it into a crontab on the nginx server.
How did you guys managed to fully automate it (if some of you did)?

I also noticed on the command that the single quote is missing before scp and after /tmp/ like this. Before finding this, the command was not working for me.

sudo bash -c 'scp ${CERT_DIRECTORY}/{privkey,fullchain,cert}.pem $USER@$SYNOLOGY_SERVER:/tmp/' \
     && ssh $USER@$SYNOLOGY_SERVER 'sudo ./replace_synology_ssl_certs.sh'

It was too beautiful to be real... When I execute the script, it reset (hard reboot) all my VMs running on VMM which is a big problem for me :(
I see that footswitch is mentioning using "reload" for nginx but this is already implemented on the script provided by catchdave.
I any case, I tried commenting this on the script but it still resetting all VMs.
I found out that this is the restart of the package ScsiTarget that do it...
Do you think this is important restart that package once the certificate is changed?

If you have any idea , I would be very grateful since this issue is blocking me to use this amazing script.

Do you think this is important restart that package once the certificate is changed?

I'm not convinced that those apps need to be restarted; As a check, I'd recommend you try the scripts with service_to_restart and packages_to_restart empty, as well as emptying target_cert_dirs and then run this script once everything is done. It will identify the folders you need to add back to target_cert_dirs that weren't handled by the synology OS and then you'll be able to populate the target folders and the packages / services to restart based only on those that it finds. Then you can test those apps you depend on to ensure they're working properly.

regarding your SSH login, you should be able to use import your public SSH key from the host you're copying FROM into the ~/.ssh/authorized_keys file on your synology (whichever user you're logging in as) and use key authentication which won't require a password prompt.

For example, if you're copying the files from linuxhost as user bob:
login to linuxhost as bob and copy the contents of the file ~/.ssh/id_rsa.pub
If you're logging INTO the admin user of the synology:
login to synology as admin and edit the file ~/.ssh/authorized_keys
paste the contents from bob's public key into the bottom of the authorized_keys file (should be a single line, don't add any additional line breaks etc)

then when you attempt to ssh into the synology from linuxhost it should use the key instead of a password prompt. Do it manually the first time for a prompt to add the machine to known_hosts and then once it's done, you won't have to use a password any more.

I added the script I use to renew my ssl and copy the cert everywhere here: https://gist.github.com/catchdave/3f6f412bbf0f0cec32469fb0c9747295

Could be a useful starting place for folks to create their own (won't be usable out of the box, since you will have different combinations services & servers). This specific one is controlled by a cronjob on the server that plex runs on.

Do you think this is important restart that package once the certificate is changed?

I'm not convinced that those apps need to be restarted; As a check, I'd recommend you try the scripts with service_to_restart and packages_to_restart empty, as well as emptying target_cert_dirs and then run this script once everything is done. It will identify the folders you need to add back to target_cert_dirs that weren't handled by the synology OS and then you'll be able to populate the target folders and the packages / services to restart based only on those that it finds. Then you can test those apps you depend on to ensure they're working properly.

regarding your SSH login, you should be able to use import your public SSH key from the host you're copying FROM into the ~/.ssh/authorized_keys file on your synology (whichever user you're logging in as) and use key authentication which won't require a password prompt.

For example, if you're copying the files from linuxhost as user bob: login to linuxhost as bob and copy the contents of the file ~/.ssh/id_rsa.pub If you're logging INTO the admin user of the synology: login to synology as admin and edit the file ~/.ssh/authorized_keys paste the contents from bob's public key into the bottom of the authorized_keys file (should be a single line, don't add any additional line breaks etc)

then when you attempt to ssh into the synology from linuxhost it should use the key instead of a password prompt. Do it manually the first time for a prompt to add the machine to known_hosts and then once it's done, you won't have to use a password any more.

Thank you very much for the quality of your answer telnetdoogie!

I managed to make passwordless work very well and I finally did my own script to replace the certificate on the synology because my need was not to replace the default certificate for everything, but just to replace the one I use only for synology drive because the port 6690 used by drive cannot be proxied by nginx since it is not a https protocol. So for this port, I do a port forwarding while all the rest is going through my nginx server which has the certbot certificate automatically renewed. This explain why I needed a script to send the certificate to the NAS each time it is renewed on the nginx.
So my need was just to use this certificate for drive and let the default one for all the rest.
I do the same with my firewall which is also used for the SSL vpn. I used a script that use the API of the firewall to send and update the certificate to it each time it is renewed on the nginx.

Thank you for the great job that has been made here. It helped me a lot!

Here is my script if it can help anyone.

So first I have manually uploaded a certificate in to the synology so that it creates the cert folder name which is using random characters. I also configure "Synology Drive Server" to use this certificate so that the link is made on the system.
Then, I just update the script to use that folder name and the script just update the cert and restart the "Synology Drive" service.

I made another script on the nginx that do the action of copying and executing that script into the synology NAS.

In my case too it was enough to run the synow3tool and do an nginx restart, thanks for the hints.
My script to find the correct folder and an opportunity to check nginx config before restarting the server:

cp ~/certs/* /usr/syno/etc/certificate/_archive/$(cat /usr/syno/etc/certificate/_archive/DEFAULT)

/usr/syno/bin/synow3tool --gen-all
nginx -t

read -p "nginx config ok?"

systemctl restart nginx

Hi Catchdave,

I'm looking for a solution for my DS1010+ with DSM 5.2-5967 Update 9.
I found many article on the net but nothing help me until yet.

Maybe you have already an idee.

Best Regards
DJG.

Hi Catchdave,

I'm looking for a solution for my DS1010+ with DSM 5.2-5967 Update 9. I found many article on the net but nothing help me until yet.

@DJGauthier : I have never had a system with 5.x OS so I simply don't know what it looks like. Fundamentally, you simply need to find where the SSL certs are stored and then find out the right way to restart associated services to use the new certs when you upload them. Perhaps the locations are similar to the 6.x version of this (look at the gist's history). You can probably easily find certs using a find command once you SSH in.

Hi CatchDave, Thanks very much for your answer. I know where the location of the ssl certificates are. The Internet box configuration and the zyxel router are ok as well firewalls. I use acme as LetsEncrypt described but l’m faced with an error ‘malformed error {‘. Best Regards

…

Le 19 juin 2023 à 18:07, catchdave ***@***.***> a écrit : ***@***.*** commented on this gist. Hi Catchdave, I'm looking for a solution for my DS1010+ with DSM 5.2-5967 Update 9. I found many article on the net but nothing help me until yet. @DJGauthier : I have never had a system with 5.x OS so I simply don't know what it looks like. Fundamentally, you simply need to find where the SSL certs are stored and then find out the right way to restart associated services to use the new certs when you upload them. Perhaps the locations are similar to the 6.x version of this (look at the gist's history). You can probably easily find certs using a find command once you SSH in. — Reply to this email directly, view it on GitHub or unsubscribe. You are receiving this email because you were mentioned. Triage notifications on the go with GitHub Mobile for iOS or Android.

I don't know where you are getting that error from, or what the context is. So I can't really work off just that error (is it on the browser, on the synology box, elsewhere). You could also consider upgrading your OS. version 5.x is a 8 years old.

Hi catchdave, It’s difficult for me too with the error: I configure the internet box to allow traffic for port 80 and 443 as well firewall. (tcp/udp) My Syno is behind a second router I allow traffic for port 80 and 443 as well firewall too. (tcp/udp) I open the firewall on Syno for the two ports (tcp/udp) Trying to get the certificate: acme.sh --issue -d [mysyno].synology.me --webroot /var/lib/letsencrypt --certpath /usr/syno/etc/ssl/ssl.crt/server.crt --keypath /usr/syno/etc/ssl/ssl.key/server.key --capath /usr/syno/etc /ssl/ssl.crt/ca.crt --debug 3 --log acme.log [Wed Jun 21 09:18:49 CEST 2023] status='invalid' [Wed Jun 21 09:18:49 CEST 2023] error='"error":{' [Wed Jun 21 09:18:49 CEST 2023] errordetail [Wed Jun 21 09:18:49 CEST 2023] [mysyno].synology.me:Verify error:"error":{ … [Wed Jun 21 09:18:49 CEST 2023] url='http:// [mysyno].synology.me/.well-known/acme-challenge/Y5KNRP___BK6pNS0HouHkgcKVdM8N7vcT2N1N-dtIn4' … [Wed Jun 21 09:42:45 CEST 2023] _t_url='https://acme.zerossl.com/v2/DV90/chall/ukpO0DZWxLCMZFVen7gc8Q' …. [Wed Jun 21 09:18:49 CEST 2023] Please check log file for more details: acme.log Trying to the url in local: http:// [mysyno].synology.me/.well-known/acme-challenge/Y5KNRP___BK6pNS0HouHkgcKVdM8N7vcT2N1N-dtIn4 Sorry, unable to access this page Looking at: https://acme.zerossl.com/v2/DV90/chall/ukpO0DZWxLCMZFVen7gc8Q {"type":"urn:ietf:params:acme:error:malformed","status":405,"detail":"The request message was malformed"} Test with curl ( <https://community.letsencrypt.org/t/synology-dsm-5-renew-certificate-failed/124501/26> Synology DSM 5 - Renew Certificate failed - Help - Let's Encrypt Community Support (letsencrypt.org)) [mysyno]> curl -Iki http:// [mysyno].synology.me HTTP/1.1 403 Forbidden Date: Wed, 21 Jun 2023 07:35:08 GMT Server: Apache Last-Modified: Tue, 26 Apr 2016 09:36:45 GMT ETag: "1e5-5316008094540" Accept-Ranges: bytes Content-Length: 485 Vary: Accept-Encoding Content-Type: text/html [mysyno]> curl -Iki https:// [mysyno].synology.me HTTP/1.1 403 Forbidden Date: Wed, 21 Jun 2023 07:35:08 GMT Server: Apache Last-Modified: Tue, 26 Apr 2016 09:36:45 GMT ETag: "1e5-5316008094540" Accept-Ranges: bytes Content-Length: 485 Vary: Accept-Encoding Content-Type: text/html I don’t know how to resolve this error 403 I try to deactivate https connection for DSM without result Sorry but I cannot update to New OS version because DS1010+ is not supported De : catchdave ***@***.***> Envoyé : mardi, 20 juin 2023 17:40 À : catchdave ***@***.***> Cc : Comment ***@***.***> Objet : Re: catchdave/replace_synology_ssl_certs.sh @catchdave commented on this gist.

…

_____ I don't know where you are getting that error from, or what the context is. So I can't really work off just that error (is it on the browser, on the synology box, elsewhere). You could also consider upgrading your OS. version 5.x is a 8 years old. — Reply to this email directly, view it on GitHub <https://gist.github.com/catchdave/69854624a21ac75194706ec20ca61327#gistcomment-4605109> or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABECB6PV2MKHW5PH3YRW64TXMG73NBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTAMJQHE2TEMZVU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you commented on the thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

Hi catchdave, I tried to do the job using the hook synology_dsm <https://github.com/acmesh-official/acme.sh/wiki/Synology-NAS-Guide> Synology NAS Guide · acmesh-official/acme.sh Wiki · GitHub I specified the variables : export SYNO_Username='Admin User' export SYNO_Password='password' export SYNO_Hostname='[mysyno].synology.me' export SYNO_Scheme="https" export SYNO_Port="5001" export SYNO_Certificate="My description" acme.sh -d "[mysyno].synology.me" --deploy --deploy-hook synology_dsm --webroot /var/lib/letsencrypt --staging --debug 2 --log acme_hook.log # staging for test ! now I get these errors: … == Info: SSLv3, TLS alert, Server hello (2): => Send SSL data, 2 bytes (0x2) 0000: .0 == Info: SSL certificate problem: self signed certificate in certificate chain == Info: SSLv3, TLS alert, Client hello (1): => Send SSL data, 2 bytes (0x2) 0000: .. [Wed Jun 21 15:31:59 CEST 2023] Unable to authenticate to [mysyno].synology.me:5001 using https. [Wed Jun 21 15:31:59 CEST 2023] Check your username and password. [Wed Jun 21 15:31:59 CEST 2023] Error deploy for domain: [mysyno].synology.me [Wed Jun 21 15:31:59 CEST 2023] Deploy error. This admin can login in from my handy without problem. Did you know if we have somewhere an option to specify for using login in from https from command line? Hi tried the command I see in log on my browser , but no chance: https:// <https://[mysyno]..synology.me:5001/webman/login.cgi?username='MyAdmin'&passwd='Mypass'&enable_syno_token=yes> [mysyno]..synology.me:5001/webman/login.cgi?username='MyAdmin'&passwd='Mypass'&enable_syno_token=yes result: { "reason" : "error_cantlogin", "result" : "error", "success" : false } Best regards De : Denis Gauthier ***@***.***> Envoyé : mercredi, 21 juin 2023 09:48 À : ***@***.***' ***@***.***> Objet : RE: catchdave/replace_synology_ssl_certs.sh Hi catchdave, It’s difficult for me too with the error: I configure the internet box to allow traffic for port 80 and 443 as well firewall. (tcp/udp) My Syno is behind a second router I allow traffic for port 80 and 443 as well firewall too. (tcp/udp) I open the firewall on Syno for the two ports (tcp/udp) Trying to get the certificate: acme.sh --issue -d [mysyno].synology.me --webroot /var/lib/letsencrypt --certpath /usr/syno/etc/ssl/ssl.crt/server.crt --keypath /usr/syno/etc/ssl/ssl.key/server.key --capath /usr/syno/etc /ssl/ssl.crt/ca.crt --debug 3 --log acme.log [Wed Jun 21 09:18:49 CEST 2023] status='invalid' [Wed Jun 21 09:18:49 CEST 2023] error='"error":{' [Wed Jun 21 09:18:49 CEST 2023] errordetail [Wed Jun 21 09:18:49 CEST 2023] [mysyno].synology.me:Verify error:"error":{ … [Wed Jun 21 09:18:49 CEST 2023] url='http:// [mysyno].synology.me/.well-known/acme-challenge/Y5KNRP___BK6pNS0HouHkgcKVdM8N7vcT2N1N-dtIn4' … [Wed Jun 21 09:42:45 CEST 2023] _t_url='https://acme.zerossl.com/v2/DV90/chall/ukpO0DZWxLCMZFVen7gc8Q' …. [Wed Jun 21 09:18:49 CEST 2023] Please check log file for more details: acme.log Trying to the url in local: http:// [mysyno].synology.me/.well-known/acme-challenge/Y5KNRP___BK6pNS0HouHkgcKVdM8N7vcT2N1N-dtIn4 Sorry, unable to access this page Looking at: https://acme.zerossl.com/v2/DV90/chall/ukpO0DZWxLCMZFVen7gc8Q {"type":"urn:ietf:params:acme:error:malformed","status":405,"detail":"The request message was malformed"} Test with curl ( <https://community.letsencrypt.org/t/synology-dsm-5-renew-certificate-failed/124501/26> Synology DSM 5 - Renew Certificate failed - Help - Let's Encrypt Community Support (letsencrypt.org)) [mysyno]> curl -Iki http:// [mysyno].synology.me HTTP/1.1 403 Forbidden Date: Wed, 21 Jun 2023 07:35:08 GMT Server: Apache Last-Modified: Tue, 26 Apr 2016 09:36:45 GMT ETag: "1e5-5316008094540" Accept-Ranges: bytes Content-Length: 485 Vary: Accept-Encoding Content-Type: text/html [mysyno]> curl -Iki https:// [mysyno].synology.me HTTP/1.1 403 Forbidden Date: Wed, 21 Jun 2023 07:35:08 GMT Server: Apache Last-Modified: Tue, 26 Apr 2016 09:36:45 GMT ETag: "1e5-5316008094540" Accept-Ranges: bytes Content-Length: 485 Vary: Accept-Encoding Content-Type: text/html I don’t know how to resolve this error 403 I try to deactivate https connection for DSM without result Sorry but I cannot update to New OS version because DS1010+ is not supported De : catchdave ***@***.***> Envoyé : mardi, 20 juin 2023 17:40 À : catchdave ***@***.***> Cc : Comment ***@***.***> Objet : Re: catchdave/replace_synology_ssl_certs.sh @catchdave commented on this gist.

…

_____ I don't know where you are getting that error from, or what the context is. So I can't really work off just that error (is it on the browser, on the synology box, elsewhere). You could also consider upgrading your OS. version 5.x is a 8 years old. — Reply to this email directly, view it on GitHub <https://gist.github.com/catchdave/69854624a21ac75194706ec20ca61327#gistcomment-4605109> or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABECB6PV2MKHW5PH3YRW64TXMG73NBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTAMJQHE2TEMZVU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you commented on the thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

@DJGauthier It appears you're running into a port forwarding issue. Have you been able to renew certs successfully using the Synology UI? The address you're using - [mysyno].synology.me will point to your public WAN IP, so you're unlikely to be able to test that locally unless you're doing some hairpin NAT rules on your router. I'd start with validating that LetsEncrypt certificates can be generated via the UI on the Synology NAS before you try to use scripts to do the same.

Alternatively you could switch to certbot using DNS-01 challenge instead of HTTP-01 to avoid the need to have ports open and forwarded. More info here:

https://letsencrypt.org/docs/challenge-types/

Hi Jason, I do not have the option to renew or create letsEncrypt Certificate on the DSM 5.2 UI. My hardware is not compatible with new DSM Version. I use DDNS name from sinology and I don’t know how to use DNS-01 challenge in this situation. I already read the article you mentioned before asking here. De : Jason Hobbs ***@***.***> Envoyé : mercredi, 21 juin 2023 17:55 À : telnetdoogie ***@***.***> Cc : Mention ***@***.***> Objet : Re: catchdave/replace_synology_ssl_certs.sh @telnetdoogie commented on this gist.

…

_____ @DJGauthier <https://github.com/DJGauthier> It appears you're running into a port forwarding issue. Have you been able to renew certs successfully using the Synology UI? The address you're using - [mysyno].synology.me will point to your public WAN IP, so you're unlikely to be able to test that locally unless you're doing some hairpin NAT rules on your router. I'd start with validating that LetsEncrypt certificates can be generated via the UI on the Synology NAS before you try to use scripts to do the same. Alternatively you could switch to certbot using DNS-01 challenge instead of HTTP-01 to avoid the need to have ports open and forwarded. More info here: https://letsencrypt.org/docs/challenge-types/ — Reply to this email directly, view it on GitHub <https://gist.github.com/catchdave/69854624a21ac75194706ec20ca61327#gistcomment-4606250> or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABECB6MSWMTRRDQ2PI62C6LXMMKMVBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTAMJQHE2TEMZVU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you were mentioned. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

Hi,

Is it necessary to reboot all the services? As the script restarts all the services, docker and virtual machines that are running on the synology are affected.

I guess, some of Step 4. "Rebooting all the things..." can be disabled by default ?

I am not sure—this was the easiest method to make sure everything works. Feel free to experiment :)

You definitely need to restart any web servers serving the cert (so nginx at least).

Is it necessary to reboot all the services?

It's not, unless you have a service specifically that seems to need it.

For me, simply running:
/usr/syno/bin/synow3tool --gen-all
/usr/syno/bin/synow3tool --nginx=reload
and /usr/syno/bin/synow3tool --restart-dsm-service

...refreshes certs for DSM and Reverse Proxy setups with no need to bounce apps (like docker, which takes a long time and is disruptive if runnning network services in containers)

I use Caddy Web Server as my reverse proxy running inside Container Manager (Docker) on my Synology DSM. Caddy is also great as a certificate manager.

Inspired by you and your code (all of you here), I wrote my own script synology-cert-deploy.sh which takes only the private key and full certificate chain files as input, since those are the only two TLS files coming from Caddy, and deploys them to Synology DSM. As long as it has the new private key and full chain, it can extract all the remaining files from these two files.

On DSM 7.2-64570 Update 1, the script will update the certificates (as verified by the Certificate tab of the Security applet in the Control Panel), but fail to restart the DSM webserver which runs on port 5001 for me.

Manually issuing the /usr/syno/bin/synow3tool --nginx=reload command seemed to do the trick, though.

Hi,
I installed this script and when running it everything seems fine.
The certificate in the control panel is updated. But when browsing to the DSM webserver on port 5001 it keeps showing the old certificate.
I already rebooted the device, but keeps showing the old certificate.

What am I missing?

Thanks.

@Daermegil check in the Certificates pane in DSM and see if you have one certificate set up, and make sure it's this one. It is possible to have multiples and assign a different one to DSM.

@telnetdoogie thank you for your quick reply.
I do have 2 certificates, one is my actual certificate. The other one is for quickconnect, but I can't delete that one. I also don't think it is the one causing problems.

But I think I see the problem. The certificate I'm using is RSA, but the old one from synology is RSA/ECC. The webserver is probally using ECC I guess, because the file ECC-cert.pem is still my old certificate. I'm just going to reset the certificates and readd them. But I have reached my request limit so I'll have to wait a bit.

@Daermegil RSA is fine; that's what I'm using too... I did see in my notes that I needed to manually import the LE certificates into DSM before the automation worked reliably.
When you're prompted for Private Key that's the privkey.pem file. When you're prompted for the Certificate that's cert.pem. When prompted for the Intermediate Certificate that's fullchain.pem.

DSM does accept certs without adding the intermediate cert, but it causes some things to fail.

Try manually adding those and see if that works for you. Once the manual add works, the automation should also work.

I think from my memory, if you upload the wrong files (and it'll still appear to work sometimes) in the wrong inputs, it will actually rename things on the filesystem but when the automation works, it's now updating the wrong files. I'm not stating that right but I definitely had some weirdness early on because I wasn't providing the Intermediate cert; instead I was using fullchain.pem as the Certificate file, which gave me issues with VPN, for example.

@telnetdoogie I added a RSA only certificate and replaced it using the script, everything seems to work brilliantly now!
Thanks for the help!

This appears to miss all "WebStation" pages for me.
I added

# Add WebStation directories
for webstation in /usr/local/etc/certificate/WebStation/*/; do
    debug "Found WebStation dir: ${webstation}"
    target_cert_dirs+=("${webstation}")
done

But those then weren't re"compiled" into the correct folders nginx uses, so I wrote

# somehow WebStation ends up not getting applied later, so lets manually do it (if it works later it will simply get overwritten)
for ws in /usr/syno/etc/www/certificate/WebStation_*/; do
    info "Copying WebStation certificates to '$ws'"
    ws_crt=$( grep -o "$ws"cert.conf -Pe '(?<=ssl_certificate\s)\s*.*(?=;$)' | xargs )
    ws_key=$( grep -o "$ws"cert.conf -Pe '(?<=ssl_certificate_key\s)\s*.*(?=;$)' | xargs )
    ln -f "${certs_src_dir}/"fullchain.pem "$ws_crt"
    ln -f "${certs_src_dir}/"privkey.pem "$ws_key"
done

which appears to be sufficient. I still had to add nginx -s reload to get changes to show up.

Is this really the only way to do this?

---

In the process I grepped through my /usr and also saw my cert ended up in /usr/local/etc/certificate/LogCenter/pkg-LogCenter/ somehow, so it might be good to add that path as

target_cert_dirs=(
    [...]
    "/usr/local/etc/certificate/LogCenter/pkg-LogCenter/")

# Faster ngnix restart (if certs don't appear to be refreshing, change to synosystemctl
if ! /usr/syno/bin/synow3tool --gen-all && sudo systemctl reload nginx; then
    warn "nginx failed to restart"
fi

The above lines should change to

if ! /usr/syno/bin/synow3tool --gen-all; then
    warn "nginx failed to generate config"
fi

info "Restart nginx"
# Faster ngnix restart (if certs don't appear to be refreshing, change to systemctl restart)
systemctl reload nginx

Otherwise, systemctl reload nginx will not be executed.

Otherwise, systemctl reload nginx will not be executed.

@xiaozhuai: I'm not sure I understand how the above is true (or why you want to separate out the two commands). The intent is that we do not restart if the certs did not generate correctly and instead issue a warning.

systemctl reload nginx will be executed if and only if the synow3tool --gen-all command is executed correctly, which is the intent of the original code.
Could you provide an example where this does not work as intended?

Could you provide an example where this does not work as intended?

@catchdave
That's odd.
I try this script on my machine last time and foud the second command never exec.
And I'm sure the /usr/syno/bin/synow3tool --gen-all is ok.

---

Confirmed, the script is wrong. You can try below.

#!/usr/bin/env bash

if ! true && echo "Good"; then
    echo "Not good"
fi

It prints nothing.
It should be

#!/usr/bin/env bash

if ! (true && echo "Good"); then
    echo "Not good"
fi

And it prints Good.

So the script should change to

# Faster ngnix restart (if certs don't appear to be refreshing, change to systemctl restart)
if ! (/usr/syno/bin/synow3tool --gen-all && systemctl reload nginx); then
    warn "nginx failed to restart"
fi

Thanks --you are right, it should have parenthesis! I updated the script. Appreciate the suggestion, @xiaozhuai