formsg 0.1.6

A Python SDK for handling FormSG webhooks.

FormSG Python SDK

This SDK provides convenient utilities for verifying FormSG webhooks and decrypting submissions in Python and Flask or Django.

Installation

pip install formsg

Usage

The SDK provides two main utility functions for handling FormSG webhook:

• webhook_uri: str, signature_header: str, signature_expiry_seconds: float = 60) -> Mapping[str, Any] verifies that the incoming webhook's signature is valid based on the FormSG production public key. It raises a nacl.exceptions.BadSignatureError if the signature is invalid. The signature header is usually found in the X-FormSG-Signature header. Details on how the signature is constructed can be found here.

• decrypt_content(body: Mapping[str, Any], secret_key: str) -> Mapping[str, Any] will decrypt the encrypted content using the given Base-64 encoded secret key. body is expected to be a dictionary-like object.

• decrypt_attachment(body: Mapping[str, Any], field_id: str, secret_key: str) -> bytes will download and decrypt the encrypted attachment for a field and using the given Base-64 encoded secret key. body is expected to be a dictionary-like object.

For convenience, the SDK implements a decrypt_django_request and decrypt_flask_request which returns the decrypted FormSG content from a Django/Flask request object directly.

Example with Flask

from formsg.flask import decrypt_flask_request

from flask import Flask
from flask import jsonify
from flask import request

app = Flask(__name__)


@app.route('/formsg_webhook', methods=['POST'])
def formsg_webhook():
    decrypted = decrypt_flask_request(
        request,
        secret_key='xxx',
        webhook_uri='https://xxx.ngrok.io/formsg_webhook',  # we use ngrok to test our webhooks locally
    )

    return jsonify(decrypted)
#end def


if __name__ == '__main__':
    app.run(debug=True)
#end if

Contributions

If you find any issues or would like to contribute improvements, please feel free to raise them in this repository directly.