Integrations

Overview

The GitHub Integration allows Cywift to securely connect with GitHubrepositories using Personal Access Tokens (PAT) to collect repositoryconfigurations, code visibility, and security-related metadata.

Before starting the integration, ensure the following:

• GitHub account access
• Personal Access Token (PAT)
• Repository access permissions
• Organization access (if applicable)

Step 1: Generate Personal Access Token

Login to GitHub.

Navigate to:

Settings → Developer Settings → Personal Access Tokens

Click Generate New Token.

Grant permissions:

• repo
• read:org
• security_events

Copy and save the token.

Important Notes:

• Store token securely
• Use minimum required permissions

Step 2: Navigate to Integrations inCywift

• Log in to Cywift Platform
• Go to Integration
• Under Version Control Systems
• Select GitHub
• Click Connect

Step 3: Add Individual Integration

Use this option when integrating a single GitHub account or organization.

Required Fields

Number of Integration
Select Individual Integration

Integration Type
Version Control Systems

Collectors
Select configured collector

Integration System
GitHub

Alias
Enter friendly name

Owner
Select integration owner

Username
Enter GitHub username

Token
Enter Personal Access Token

Actions

Test Connection
Verifies authentication and repository access

Cancel
Discards configuration

Step 4: Add Bulk Integration

Use this option to integrate multiple GitHub accounts or repositories.

Steps:

• Select Bulk Integration
• Download Template
• Fill required account details
• Upload file
• Click Test Connection

Troubleshooting Tips

• Verify token permissions
• Confirm repository access
• Check organization permissions