Enterprise Software Supply Chain Manager (ESSCM)IntegrationsSource Code (SCM)
Git (Generic)
Connect any Git repository using a generic Git URL
Permissions and token types
The Git integration guide lists the exact permissions each token needs, which token types work, and the current setup steps. Where this page and that guide differ, follow the guide.
Git (Generic URL) Integration
Connect any Git repository to Safeguard using a generic Git URL. This option works with any Git hosting service not explicitly listed.
Prerequisites
- A Git repository URL (HTTPS or SSH)
- For private repositories: Username and Password/Token
Public Repositories
Step 1: Navigate to Integrations
Go to Integrations from the sidebar and click Connect on the Git card.
Step 2: Enter Repository URL
- Select the Public tab
- Enter a Name for this configuration
- Optionally add a Description
- Enter the Git repository URL
- Click Add to add the URL to the list
Supported URL Formats
https://example.com/user/repo.git
https://example.com/user/repo
git://example.com/user/repo.gitStep 3: Review & Connect
- Review the added repository URLs
- Click Next to proceed
- Configure Branch/Tag, Project Name, and Version
- Click Connect to complete
Private Repositories
Step 1: Navigate to Integrations
Go to Integrations from the sidebar and click Connect on the Git card.
Step 2: Enter Credentials
- Select the Private tab
- Enter a Name for this configuration
- Optionally add a Description
- Enter the Git Repository URL
- Enter your credentials:
- Username - Your Git username
- Password / Token - Your password or access token
- Click Verify Credentials
Step 3: Review & Connect
- Once credentials are verified, configure settings
- Set Branch/Tag, Project Name, and Version
- Click Connect to complete
Supported Git Hosting Services
The generic Git integration works with:
| Service | URL Format |
|---|---|
| Gitea | https://gitea.example.com/user/repo |
| Gogs | https://gogs.example.com/user/repo |
| Forgejo | https://forgejo.example.com/user/repo |
| SourceHut | https://git.sr.ht/~user/repo |
| Codeberg | https://codeberg.org/user/repo |
| Self-hosted Git | https://git.yourcompany.com/repo |
| Any Git server | Any valid Git URL |
Authentication Methods
HTTPS with Password/Token
Most common method. Use your username and password or personal access token.
URL: https://git.example.com/user/repo.git
Username: your-username
Password: your-password-or-tokenToken-based Authentication
For services that use token-only authentication:
Username: oauth2 (or your username)
Password: your-access-tokenTroubleshooting
"Authentication failed"
- Verify username and password/token are correct
- Some services require tokens instead of passwords
- Check if the account has access to the repository
"Repository not found"
- Verify the URL is correct and accessible
- Ensure the
.gitsuffix is included if required - Check if the repository exists and is not deleted
"Connection refused"
- Verify the Git server is accessible
- Check firewall settings
- Ensure the URL protocol (HTTP/HTTPS) is correct