mirror of
https://github.com/netbox-community/netbox.git
synced 2024-05-10 07:54:54 +00:00
5cbc978cad
- Update markdown documentation - Expand on the help text for the Webhook model
103 lines
3.4 KiB
Python
103 lines
3.4 KiB
Python
import logging
|
|
|
|
import requests
|
|
from django.conf import settings
|
|
from django_rq import job
|
|
from jinja2.exceptions import TemplateError
|
|
|
|
from .choices import ObjectChangeActionChoices
|
|
from .conditions import ConditionSet
|
|
from .webhooks import generate_signature
|
|
|
|
logger = logging.getLogger('netbox.webhooks_worker')
|
|
|
|
|
|
def eval_conditions(webhook, data):
|
|
"""
|
|
Test whether the given data meets the conditions of the webhook (if any). Return True
|
|
if met or no conditions are specified.
|
|
"""
|
|
if not webhook.conditions:
|
|
return True
|
|
|
|
logger.debug(f'Evaluating webhook conditions: {webhook.conditions}')
|
|
if ConditionSet(webhook.conditions).eval(data):
|
|
return True
|
|
|
|
return False
|
|
|
|
|
|
@job('default')
|
|
def process_webhook(webhook, model_name, event, data, snapshots, timestamp, username, request_id):
|
|
"""
|
|
Make a POST request to the defined Webhook
|
|
"""
|
|
# Evaluate webhook conditions (if any)
|
|
if not eval_conditions(webhook, data):
|
|
return
|
|
|
|
# Prepare context data for headers & body templates
|
|
context = {
|
|
'event': dict(ObjectChangeActionChoices)[event].lower(),
|
|
'timestamp': timestamp,
|
|
'model': model_name,
|
|
'username': username,
|
|
'request_id': request_id,
|
|
'data': data,
|
|
'snapshots': snapshots,
|
|
}
|
|
|
|
# Build the headers for the HTTP request
|
|
headers = {
|
|
'Content-Type': webhook.http_content_type,
|
|
}
|
|
try:
|
|
headers.update(webhook.render_headers(context))
|
|
except (TemplateError, ValueError) as e:
|
|
logger.error(f"Error parsing HTTP headers for webhook {webhook}: {e}")
|
|
raise e
|
|
|
|
# Render the request body
|
|
try:
|
|
body = webhook.render_body(context)
|
|
except TemplateError as e:
|
|
logger.error(f"Error rendering request body for webhook {webhook}: {e}")
|
|
raise e
|
|
|
|
# Prepare the HTTP request
|
|
params = {
|
|
'method': webhook.http_method,
|
|
'url': webhook.render_payload_url(context),
|
|
'headers': headers,
|
|
'data': body.encode('utf8'),
|
|
}
|
|
logger.info(
|
|
f"Sending {params['method']} request to {params['url']} ({context['model']} {context['event']})"
|
|
)
|
|
logger.debug(params)
|
|
try:
|
|
prepared_request = requests.Request(**params).prepare()
|
|
except requests.exceptions.RequestException as e:
|
|
logger.error(f"Error forming HTTP request: {e}")
|
|
raise e
|
|
|
|
# If a secret key is defined, sign the request with a hash of the key and its content
|
|
if webhook.secret != '':
|
|
prepared_request.headers['X-Hook-Signature'] = generate_signature(prepared_request.body, webhook.secret)
|
|
|
|
# Send the request
|
|
with requests.Session() as session:
|
|
session.verify = webhook.ssl_verification
|
|
if webhook.ca_file_path:
|
|
session.verify = webhook.ca_file_path
|
|
response = session.send(prepared_request, proxies=settings.HTTP_PROXIES)
|
|
|
|
if 200 <= response.status_code <= 299:
|
|
logger.info(f"Request succeeded; response status {response.status_code}")
|
|
return f"Status {response.status_code} returned, webhook successfully processed."
|
|
else:
|
|
logger.warning(f"Request failed; response status {response.status_code}: {response.content}")
|
|
raise requests.exceptions.RequestException(
|
|
f"Status {response.status_code} returned with content '{response.content}', webhook FAILED to process."
|
|
)
|