seitime-frappe/frappe/utils/verified_command.py

84 lines
2.4 KiB
Python

# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors
# License: MIT. See LICENSE
import hashlib
import hmac
from urllib.parse import urlencode
import frappe
import frappe.utils
from frappe import _
def get_signed_params(params):
"""Sign a url by appending `&_signature=xxxxx` to given params (string or dict).
:param params: String or dict of parameters."""
if not isinstance(params, str):
params = urlencode(params)
signature = hmac.new(params.encode(), digestmod=hashlib.sha512)
signature.update(get_secret().encode())
return params + "&_signature=" + signature.hexdigest()
def get_secret():
from frappe.utils.password import get_encryption_key
return frappe.local.conf.get("secret") or get_encryption_key()
def verify_request():
"""Verify if the incoming signed request if it is correct."""
query_string = frappe.safe_decode(
frappe.local.flags.signed_query_string or getattr(frappe.request, "query_string", None)
)
signature_string = "&_signature="
if signature_string in query_string:
params, signature = query_string.split(signature_string)
given_signature = hmac.new(params.encode("utf-8"), digestmod=hashlib.sha512)
given_signature.update(get_secret().encode())
valid_signature = hmac.compare_digest(signature, given_signature.hexdigest())
valid_method = frappe.request.method == "GET"
valid_request_data = not (frappe.request.form or frappe.request.data)
if valid_signature and valid_method and valid_request_data:
return True
frappe.respond_as_web_page(
_("Invalid Link"),
_("This link is invalid or expired. Please make sure you have pasted correctly."),
)
return False
def get_url(cmd, params, nonce=None, secret=None):
if not nonce:
nonce = params
signature = get_signature(params, nonce, secret)
params["signature"] = signature
return frappe.utils.get_url("".join(["api/method/", cmd, "?", urlencode(params)]))
def get_signature(params, nonce, secret=None):
params = "".join(frappe.utils.cstr(p) for p in params.values())
if not secret:
secret = frappe.local.conf.get("secret") or "secret"
signature = hmac.new(str(nonce), digestmod=hashlib.md5)
signature.update(secret)
signature.update(params)
return signature.hexdigest()
def verify_using_doc(doc, signature, cmd):
params = doc.get_signature_params()
return signature == get_signature(params, doc.get_nonce())
def get_url_using_doc(doc, cmd):
params = doc.get_signature_params()
return get_url(cmd, params, doc.get_nonce())