This Azure Pipelines task generates GitHub App installation tokens that can be used for authenticating with GitHub APIs. It's particularly useful when you need to interact with GitHub repositories using a GitHub App instead of personal access tokens or other authentication methods.

• Generates GitHub App installation tokens for API authentication
• Supports organization-wide or repository-specific tokens
• Provides multiple authentication options (service connection or direct inputs)
• Handles proxy configurations through environment variables
• Secure handling of private keys and credentials
• Cross-platform compatibility

1. A GitHub App created and installed in your organization
2. The GitHub App's private key (PEM format)
3. The GitHub App ID
4. The GitHub App must be installed in the organization where you want to generate tokens

1. Go to your GitHub organization settings
2. Navigate to GitHub Apps section
3. Create a new GitHub App or select an existing one
4. Note down the App ID
5. Generate and download a private key (PEM format)
6. Install the app in your organization

Add the task to your pipeline:

steps:
- task: create-github-app-token@1
  inputs:
    githubAppConnection: 'MyGitHubAppConnection'
    organization: 'your-org-name'
    repositories: 'repo1,repo2'  # Optional

steps:
- task: create-github-app-token@1
  inputs:
    organization: 'your-org-name'
    appClientId: 'lv2313qqwqeqweqw'        # Your GitHub App ID
    certificate: '$(pem)'       # PEM content as variable
    repositories: 'repo1,repo2' # Optional

*Required if githubAppConnection is not specified

1. In your Azure DevOps project, go to Project Settings
2. Select "Service connections" under Pipelines
3. Create a new service connection of type "GitHub App"
4. Enter:
   • Connection name
   • GitHub App Client ID
   • Private Key (PEM content)
   • Scope to repository. If this is set then the repositories input is ignored and the token will be scoped to the repository where the pipeline is running. For example this can be useful if install the on all or some repositories but you don't want the pipeline to access other repositories.
     • only works if sources repository is GitHub. If you try to use with another source it will throw an error.
   • Optionally change the API URL if not using github.com
5. Save the connection

steps:
- task: create-github-app-token@1
  name: token
  inputs:
    githubAppConnection: 'MyGitHubAppConnection'
    organization: 'MyOrg'
- bash: |
    gh api \
    --method POST -H "Accept: application/vnd.github+json" -H "X-GitHub-Api-Version: 2022-11-28" \
    /repos/MyOrg/myRepo/issues \
    -f "title=Found a bug" -f "body=I'm having a problem with this."
  displayName: 'Create issue using GitHub CLI'
  env:
    GH_TOKEN: $(token.installationToken)

steps:
- task: create-github-app-token@1
  inputs:
    organization: 'MyOrg'
    appClientId: 'lv2313qqwqeqweqw'
    certificate: '$(githubAppPem)'  # Variable containing PEM content

steps:
- task: create-github-app-token@1
  inputs:
    githubAppConnection: 'MyGitHubAppConnection'
    organization: 'MyOrg'
    repositories: 'repo1'

steps:
- task: create-github-app-token@1
  name: githubAuth
  inputs:
    githubAppConnection: 'MyGitHubAppConnection'
    organization: 'MyOrg'
    

- script: |
    curl -H "Authorization: Bearer $(githubAuth.installationToken)" https://api.github.com/repos/MyOrg/MyRepo/issues | jq
  displayName: 'List issues using cURL'

The task automatically detects and uses proxy settings from the following environment variables:

• HTTP_PROXY
• HTTPS_PROXY

Common issues and solutions:

1. Invalid Private Key: Ensure the PEM file is properly formatted and includes the full key including header and footer
2. Permission Issues: Verify that the GitHub App has the necessary permissions for the repositories
3. Installation Not Found: Confirm that the GitHub App is installed in the specified organization

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License.

If you encounter any issues or need support, please open an issue in the GitHub repository.