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

email

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 description

Common issue longer description (if required)

Issue solution or workaround