Detailed guide for connecting Factory with your self-hosted GitHub Enterprise Server
This guide provides a comprehensive walkthrough for integrating Factory with your GitHub Enterprise Server (GHES) instance. This integration enables the Factory platform to securely access and work with your on-premise repositories.
Connecting to a GitHub Enterprise Server is only supported in the Enterprise plan.
Initial Setup & Information Gathering
Create GitHub App
Collect Integration Information
Gather the following details:
Submit Information to Factory
Securely send the collected information to your Factory representative.
Network Security Configuration
Evaluate Network Policy
Review your current network security policies to identify potential connectivity barriers with Factory’s AWS VPC.
Establish Connectivity
Choose one of the following methods:
Firewall Configuration
Webhook Setup
Configure the webhook in your GHES to send events to the Factory-provided cloud function URL.
Required Permissions
Ensure the GitHub App has the following permissions:
Testing and Validation
Preliminary Testing
Work with Factory to conduct initial tests of webhook connectivity and data exchange.
Comprehensive Testing
Test all GitHub events that trigger Tools within Factory, including:
Validation
Verify that Factory Tools respond correctly to these events.
Final Adjustments and Go-Live
Feedback and Adjustments
Provide feedback on any issues encountered during testing. Work with Factory to make necessary adjustments.
Go-Live
Agree on a go-live date with Factory.
Monitoring
Implement continuous monitoring for the initial days post-launch to quickly address any unforeseen issues.
For any specific issues or detailed support needs, contact the Factory team through your designated support channel.
Learn about Factory’s security measures for enterprise integrations