Appearance
Set Up Jfrog Webhook
JFrog webhooks enable real-time notifications and integrations with external systems when specific events occur in Artifactory (such as artifact uploads, deletions, or security alerts).
Prerequisites
- JFrog Artifactory Project admin access
- Target endpoint (e.g., a service, Slack, Teams, or CI/CD system) ready to receive POST requests
Steps to Create a Webhook
Log in to JFrog Artifactory
Navigate to Webhooks Configuration
- In the JFrog UI, go to Admin > General > Webhooks.
Create a New Webhook
- Click Create Webhook.
- Enter a name and (optional) description.
Configure the Webhook Endpoint
- Set the URL to your target endpoint (e.g., https://hooks.example.com/jfrog).
- (Optional) Add custom HTTP headers (for authentication, etc.).
Select Events to Trigger the Webhook
- Choose relevant events (e.g., Artifact Created, Deleted, Property Changed).
- You can filter by repository, path, or event type.
Set Security Options
- Use secret tokens or basic auth as needed for your endpoint.
- Consider restricting IPs or using HTTPS for secure communication.
Test the Webhook
- Use the Test button if available, or manually trigger an event to verify delivery.
Save the Webhook
- Click Save to activate the webhook configuration.
Best Practices
- Use HTTPS endpoints for all webhooks.
- Validate incoming requests on your endpoint (e.g., check a secret header).
- Limit webhook triggers to only the events you need.
- Monitor webhook delivery status in the JFrog UI.
Troubleshooting
- Check the webhook delivery history in Artifactory for errors.
- Ensure your endpoint is reachable and responds with HTTP 2xx status.
- Review firewall and network ACLs if webhooks are not received.