GitHub

GitHub is a software development platform that allows developers to create, store, manage, and share their code. This guide explains how to add GitHub integration to Cloudaware.

To see how Cloudaware seamlessly integrates with GitHub in action, request a demo.

Create GitHub token

Cloudaware collects repositories accessible to the authenticated user as a member of the organization.

Generate a user token in GitHub:

Log in to the GitHub. Under the user icon, select Settings.
Go to Developer settings → Personal Access Tokens. Select the token type.
Click Generate new token. Set a name, description, and expiration period (recommended: at least 1 year).
Click Add permissions and select the following:
- For fine-grained access tokens:
  - Actions
  - Codespaces
  - Contents
  - Dependabot alerts
  - Environments
  - Issues
  - Pull requests
  - Secrets^*
  - Webhooks
  - Workflows
- For tokens (classic):
  - repo (full access for private repositories) or public_repo (public repos only)
  - workflow
  - read:packages
  - read:org
  - read:repo_hook
  - admin:org_hook
  - codespace
  - read:project
Click Generate token.

^*Clodaware collects only metadata of secrets.

Add GitHub account

Log in to Cloudaware → Admin.
Find GitHub Accounts in integrations. Click +ADD.
Fill out the form:
WHERE
Name – enter a name for GitHub integration
Token – insert a GitHub token

Click CHECK to test the connection. Once the validation passed, click SAVE.
A green light in the ‘Status’ column indicates a successful configuration. If the light is red, contact support@cloudaware.com.
To view GitHub-related data, go to Cloudaware CMDB Navigator. Select GITHUB in the menu on the left:

List of GitHub objects

Cloudaware supports the following GitHub objects:

GitHub Account
GitHub Branch
GitHub Codespace
GitHub Dependabot Alert
GitHub Environment
GitHub Issue
GitHub Organization
GitHub Package
GitHub Project
GitHub Pull Request
GitHub Repository
GitHub Secret
GitHub Team
GitHub User
GitHub Webhook
GitHub Workflow