Cloudability SaaS Connect GitHub to Cloudability SaaS
What data is used by Cloudability SaaS from GitHub?
GitHub is integrated with Cloudability SaaS using the GitHub API.
For more information, refer to https://docs.github.com/en/rest .
Cloudability SaaS uses user and expense data from the GitHub API. The data is analyzed and displayed as useful insights in Cloudability SaaS .
The list of fields that are retrieved by the connector can be quite long and detailed. It's therefore in a drop-down so that it's easier to read through this intro if you're not wanting the detail:
View the data fields that are used by Cloudability SaaS from GitHub.Cloudability SaaS uses API calls to retrieve data from GitHub.
List organization members
For more information about this API call, refer to https://docs.github.com/en/rest/reference/orgs#list-organization-members .
Cloudability SaaS parses the data from the following fields:
login
id
avatar_url
gravatar_id
url
html_url
followers_url
following_url
gists_url
starred_url
subscriptions_url
organizations_url
repos_url
events_url
received_events_url
type
site_admin
Get a user
For more information about this API call, refer to https://docs.github.com/en/rest/reference/users#get-a-user .
Cloudability SaaS parses the data from the following fields:
login
id
avatar_url
gravatar_id
url
html_url
followers_url
following_url
gists_url
starred_url
subscriptions_url
organizations_url
repos_url
events_url
received_events_url
type
site_admin
name
company
blog
location
hireable
bio
public_repos
public_gists
followers
following
created_at
updated_at
plan
name
space
private_repos
collaborators
List events for the authenticated user
For more information about this API call, refer to https://docs.github.com/en/rest/reference/activity#list-events-for-the-authenticated-user .
Cloudability SaaS parses the data from the following fields:
id
created_at
OAuth Authorization
For more information about this API call, refer to https://docs.github.com/en/developers/apps/building-oauth-apps/authorizing-oauth-apps .
Cloudability SaaS parses the data from the following fields:
access_token
token_type
scope
Calculated fields
Last login date
The last login date is based on the created_at value of the latest event from the list-events-for-the-authenticated-user API call. If there are no events for a user, then this is null.
Activity status
The last login date is used to determine when the user was last active; see Last login date .
If there is no last login date, then the user is marked as inactive.
Purchased license count
This value is set manually.
Used license count
The used license count is based on the number of users found.
Connect to GitHub
Before you start
Prerequisites, supported versions, , decisions you need to make (might XREFto a "best practice" topic or HREF to Community page)
Before you can integrate GitHub with Cloudability SaaS , you must have the following:
A GitHub account subscription.
For more information, refer to https://github.com/pricing
The GitHub account must have Admin rights to approve access for the Cloudability SaaS app.
If an Organization admin approves access, members of that organization can also approve access.
For more information, refer to https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps#oauth-apps-and-organizations
Steps to connect
Connect GitHub to Cloudability SaaS .
Find the GitHub tile and select Connect .
Enter the name of your organization, used in your GitHub account.
Log in to your GitHub account and view the address bar in your browser. The name of your organization comes after github.com/ . For example, if the full URL is https://github.com/cloudability-saas , enter only cloudability-saas .
Select Continue .
Complete the steps in the License Wizard to add your GitHub license to Cloudability SaaS .
Confirm success
Use the wording below as a guide when describing a single connector. For example, a single application connected using an API connection.
Confirm that GitHub has been integrated with Cloudability SaaS correctly.
Confirm that the Cloudability SaaS Dashboard displays the GitHub tile under Your Connected Applications .
Select the GitHub tile and confirm that data from GitHub can be viewed in the application details page.
Compare the data in GitHub to data in Cloudability SaaS to confirm success.
Troubleshooting
Troubleshooting questions can be listed here using the drop-down. Copy the following Madcap dropdown and replace the text for each common issue.
Common Issue short descriptionCommon issue longer description (if required)
Issue solution or workaround