GitHub Credentials

Configure your GitHub integration to manage repositories, issues, pull requests, and other GitHub resources from your Jinba Flow workflows.

Prerequisites

• A GitHub account
• Access to the repositories you want to manage

Creating a Personal Access Token

1. Visit GitHub.com and sign in to your account
2. Click on your profile picture in the top right corner
3. Select “Settings” from the dropdown menu
4. In the left sidebar, click “Developer settings”
5. Click “Personal access tokens”
6. Select “Tokens (classic)” or “Fine-grained tokens”

Choosing the Right Token Type

Personal Access Token (Classic)

• Use for: Full repository access and legacy integrations
• Scopes needed:
  • repo - Full control of private repositories
  • public_repo - Access public repositories only
  • workflow - Update GitHub Action workflows
  • admin:org - Full control of organizations (if needed)

Fine-grained Personal Access Token

• Use for: More secure, granular permissions
• Repository access: Select specific repositories or all repositories
• Permissions needed:
  • Repository permissions:
    • Issues: Read and write
    • Pull requests: Read and write
    • Contents: Read and write
    • Metadata: Read-only

Generating Your Token

For Classic Tokens:

1. Click “Generate new token (classic)”
2. Give your token a descriptive name (e.g., “Jinba Flow Integration”)
3. Set an expiration date (recommended: 90 days or less)
4. Select the required scopes:
   • ✅ repo (Full control of private repositories)
   • ✅ workflow (Update GitHub Action workflows)
5. Click “Generate token”
6. Important: Copy the token immediately - you won’t be able to see it again!

For Fine-grained Tokens:

1. Click “Generate new token”
2. Give your token a descriptive name
3. Set an expiration date
4. Select “All repositories” or specific repositories
5. Under “Repository permissions”, set:
   • Issues: Read and write
   • Pull requests: Read and write
   • Contents: Read and write
   • Metadata: Read-only
6. Click “Generate token”
7. Important: Copy the token immediately - you won’t be able to see it again!

Setting Up in Jinba Flow

1. Go to your workspace settings in Jinba Flow
2. Navigate to the “Secret” section
3. Find “GitHub” in the list of available credentials
4. Click “Configure” or “Add New”
5. Enter your GitHub credentials:
   • Token: Your personal access token (starts with ghp_ for classic tokens or github_pat_ for fine-grained tokens)
   • Username: Your GitHub username
6. Click “Save” to store your credentials

Usage

Once configured, you can use GitHub in your flows to:

• List and create issues
• Manage pull requests
• Read repository contents
• Update files and create commits
• Manage workflows and actions
• Interact with GitHub’s API