Overview
This page explains the steps for integrating GitHub via the App Catalog page in Josys.
- Regarding integration with GitHub, you can only add existing accounts to the organization (and delete accounts from the added organization when deleting accounts).
- Due to system specifications, up to 10 organizations can be integrated with the same authorized account.
- If you want to integrate more than 10 organizations, please prepare an additional authorized account.
(Reference: Official Documentation )
Integration Specifications
| Target Plans | All *However, retrieving App Usage Status is only available for the Enterprise plan. |
|---|---|
| Required Admin Role |
(Organization) Owner *However, an Enterprise Owner is required to retrieve the "Last Used Date and Time" under the Enterprise plan. |
| Integration Method | OAuth |
| Integration Key | Username |
| Supported Features | Delete Account Account Visualization License Visualization Add Existing Account Change Permissions |
| Account Visualization Status | Pending Active Deleted |
| Status Excluded from Unmanaged ID Targets | Deleted |
| Settings Available on Creation | Group Settings (Team) Permission Settings |
| Settings Available on Deletion | |
| Billing Info | How to check billing information |
| Other Retrieved Items | User Type, Site Admin, Teams |
| Visible Items |
• Permissions • Status • User Type • Site Admin • Teams |
| Retrieved Items for License Management | App Usage Status (Source: Audit Logs) Plan Name User Licenses Total Licenses Assigned Unassigned |
| Inactive Criteria | No Git events for 30 days |
| Common Fields | Role Status User |
| Retrieved Permission Types | ・Admin |
| Permission Editing | Supported |
Integrating GitHub
- From the left sidebar of Josys, click Integrations > App Catalog.
- Search for GitHub and click it.
- The setup page will appear on the right side.
- Enter the Organization Name you want to integrate.
If you are using the Enterprise plan, enter your Enterprise URL Slug.How to find your Organization Name
You can find the organization name by clicking your profile photo in the upper-right corner of GitHub.com, and then clicking Your organizations.
If multiple organizations are displayed, select the one you want to integrate.
The Enterprise URL Slug can be checked from the Enterprise URL.
For example, if it ishttps://github.com/enterprises/octo-enterprise, enterocto-enterprise. -
Click Next and log in with your Owner GitHub account.
-
If the "Grant" button is displayed next to the organization name you want to integrate, click it first, and then click "Authorize."
Authorized Permission Items
<App Permission Scope Settings>
admin:org : Fully manage organizations and their teams, projects, and members