Skip to content

Instantly share code, notes, and snippets.

Last active June 17, 2024 21:47
Show Gist options
  • Save velzend/895c18d533b3992f3a0cc128f27c0894 to your computer and use it in GitHub Desktop.
Save velzend/895c18d533b3992f3a0cc128f27c0894 to your computer and use it in GitHub Desktop.
Reolink doorbell refresh certificates using Lego (ACME) and the API
#!/usr/bin/env python3
I wanted to replace the self-signed certificate with one signed by Let's Encrypt, and
did not want to perform this action manually.
I asked Reolink technical support, but they answered there is no API to manage certificates.
So I did some research and found the Reolink doorbell camera and probably other models
do support to upload your own certificates.
In developer tools I checked the API and found the annoying client side AES encryption
implementation where the key is generated/ rotated in the script during login.
To reveal the key and iv, I simply set a breakpoint on the login logic and have the `e` and `t` values.
To decrypt the JSON payload I wrote the script below:
#!/usr/bin/env python3
from crypto.Cipher import AES
import base64
#e = "B642D317BD521D58", t = "0D6A4261FCD46185"
key = b"B642D317BD521D58"
iv = b"0D6A4261FCD46185"
encrypted_payload = "Plha/2eKtaMXwqNXZAlawvZB88qw3KdkRpLrMRol2nh1EmKPQJN****"
decipher =, AES.MODE_CFB, IV=iv, segment_size=128)
decrypted_payload = decipher.decrypt(base64.b64decode(encrypted_payload))
Now I know the endpoints and payload of API requests.
Important notes:
The webservice in the doorbell camera only supports RSA certificates and not EC (Elliptic Curve, ec256 for example).
If you use this script the certificate and key filenames are hardcoded to `server.crt` and `server.key`,
but during testing I found using filenames that contains the FQDN the API fails.
Next, you need a certificate and key.
I use Cloudflare as DNS provider, and prefer Lego as ACME client.
To request the certificate from Let's Encrypt I used the Lego container image below:
docker run \
-v "$(pwd)/.lego:/.lego" \
-e "CF_DNS_API_TOKEN=***" \
goacme/lego \
--key-type="rsa4096" \
--accept-tos \
--email="***" \
--domains="***" \
--dns="cloudflare" \
Next step is to update some values in the script below, schedule this
script to run periodically after the docker run above and
enjoy automatic certificate updates/ rotation.
import requests
import os
import base64
import time
import ssl
import sys
os.environ['no_proxy'] = '*'
base_url = "https://***"
username = "admin"
password = "****"
certificate_path = ".lego/***.crt"
key_path = ".lego/***.key"
class Reolink(object):
def __init__(self, **kwargs):
self.base_url = kwargs.pop('base_url', None)
self.username = kwargs.pop('username', None)
self.password = kwargs.pop('password', None)
self.token = None
def login(self):
login_req = [{"cmd":"Login",
"param": {"User": {"userName": self.username,
"password": self.password}
url = f'{self.base_url}/cgi-bin/api.cgi?cmd=Login'
login_resp =, json=login_req, verify=False)
login_data = login_resp.json()
self.token = login_data[0]['value']['Token']['name']
print(f"Login was succesfull, got token: {self.token}")
return self.token
def verify_ssl_certificate(self):
response = requests.get(self.base_url)
print(f"Certificate for {self.base_url} is valid.")
return True
except ssl.SSLCertVerificationError as err:
print(f"Certificate verification failed for {self.base_url}, error: {err}", file=sys.stderr)
return False
def clear_certs(self):
url = f"{self.base_url}/cgi-bin/api.cgi?cmd=CertificateClear&token={self.token}"
clear_req = [{
"cmd": "CertificateClear",
"action": 0,
"param": {}
clear_certs_resp =, json=clear_req, verify=False)
clear_certs_data = clear_certs_resp.json
return clear_certs_data
def update_certs(self, certificate_path, key_path):
crtfile_stats = os.stat(certificate_path)
crt_filesize = crtfile_stats.st_size
with open(certificate_path, "rb") as crt_file:
b64_crt = base64.b64encode(
keyfile_stats = os.stat(key_path)
key_filesize = keyfile_stats.st_size
with open(key_path, "rb") as key_file:
b64_key = base64.b64encode(
cert_req = [{
"cmd": "ImportCertificate",
"action": 0,
"param": {
"importCertificate": {
"crt": {
"size": crt_filesize,
"name": "server.crt",
"content": b64_crt.decode("UTF-8")
"key": {
"size": key_filesize,
"name": "server.key",
"content": b64_key.decode("UTF-8")
url = f"{self.base_url}/cgi-bin/api.cgi?cmd=ImportCertificate&token={self.token}"
update_certs_resp =, json=cert_req, verify=False)
update_certs_data = update_certs_resp.json
return update_certs_data
def logout(self):
url = f"{self.base_url}/cgi-bin/api.cgi?cmd=Logout&token={self.token}"
logout_resp = requests.get(url=url, verify=False)
logout_data = logout_resp.json
print(f"Logout was succesfull, got response: {logout_data}")
return logout_data
def main():
reolink = Reolink(base_url=base_url,
# the doorbell will restart the internal web daemon
# the doorbell will restart the internal web daemon
if not reolink.verify_ssl_certificate():
if __name__ == "__main__":
Copy link

curzon01 commented Feb 1, 2024

typo in line 189, should be


Copy link

velzend commented Feb 1, 2024

typo in line 189, should be


Thanks, good finding... I updated certs using the script. So now I am not sure if it is really required to clear the certs if the API is used... In the GUI you first need to clear the certs, and re-login before it is possible to select and upload new certs...

Anyway, I have updated the script, and can test the script tomorrow. I also want to verify if clearing out the certs is required at all...

Copy link

curzon01 commented Feb 2, 2024

First, many thx for the script, I use it as basis for my own (added vars as params)

I am not sure if it is really required to clear the certs if the API is used...

I tried it with several ReoLink cams (E1 Outdoor, RLC410W, RLC420, RLC520 which all needs longer delays between the actions) and cert clear is required:
ImportCertificate probably assumes an empty cert configuration, in any case imported certs cannot be overwritten, you have to execute CertificateClear first.

Copy link

Great thing.
Do you think it's possible to get in touch with the developers of opnsense firewall? There is an acme client which allows to automate such scripts for example to change certs in true nas, fritz box routers, promox servers and so. It would be really great, if they would merge your code into theirs

Copy link

stratus-ss commented Jun 13, 2024

I found that I had to login again after the reolink.clear_certs() and subsequent sleep was executed. I simply added a reolink.login() before reolink.update_certs()

In addition, the Let's Encrypt certs I am using seem to fail the SSL validation function, so I commented that out

I also disabled the warnings:

import urllib3
# I am choosing to disable the URL SSL cert warnings as the whole purpose of this script is 
# to update or replace invalid certs

to clean up the output a bit

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment