Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 17 additions & 17 deletions docs/enterprise-cloud/github-enterprise-cloud.md
Original file line number Diff line number Diff line change
@@ -1,56 +1,56 @@
# GitHub Enterprise Cloud

Use your GitHub Enterprise credentials when signup or login to Codacy and all your GitHub Enterprise organizations that you belong to, will be available to be added as Organizations on Codacy.
Use your GitHub Enterprise credentials when signing up or logging in to Codacy and all your GitHub Enterprise organizations that you belong to, will be available to be added as Organizations on Codacy.

Codacy also has a dedicated Enterprise area where GitHub Enterprise admins and owners of the enterprise will be able to manage them.
Codacy also has a dedicated Enterprise area where GitHub Enterprise admins and owners of the enterprise will be able to manage their respective organizations.

### GitHub Enterprise types
Codacy supports both [GitHub Enterprises types](https://docs.github.com/en/enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/choosing-an-enterprise-type-for-github-enterprise-cloud), Managed Users and Personal Accounts.
Codacy supports both [GitHub Enterprise types](https://docs.github.com/en/enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/choosing-an-enterprise-type-for-github-enterprise-cloud), Managed Users and Personal Accounts.

## Access cloud Enterprises
Access you enterprises in Codacy by setting up its integration:
Access your Enterprises in Codacy by setting up its integration:

1. In codacy app, click on your avatar image, in the top right corner
1. then navigate throught "My account" and "Access management"
1. In Codacy, click on your avatar, in the top right corner
2. Navigate through "My account" and "Access management"
1. There, you'll be able to add a **GitHub Enterprise Cloud** access token.

Once generated and added in Codacy you will start seeing all infomration you have access to regarding your cloud enterprises.
You can revoke the cloud enterpises access at any time in the same place.
Once generated and added in Codacy you will start seeing all the information you have access to regarding your Cloud Enterprises.
You can revoke the Cloud Enterpises' access at any time in the same place.

Check failure on line 18 in docs/enterprise-cloud/github-enterprise-cloud.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'Enterpises'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'Enterpises'?", "location": {"path": "docs/enterprise-cloud/github-enterprise-cloud.md", "range": {"start": {"line": 18, "column": 26}}}, "severity": "ERROR"}

Check warning on line 18 in docs/enterprise-cloud/github-enterprise-cloud.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Terms] Prefer 'cloud' over 'the Cloud'. Raw Output: {"message": "[Microsoft.Terms] Prefer 'cloud' over 'the Cloud'.", "location": {"path": "docs/enterprise-cloud/github-enterprise-cloud.md", "range": {"start": {"line": 18, "column": 16}}}, "severity": "WARNING"}
![Enterprise cloud manage enterprises access](images/Codacy-Access-Management.png)


## Manage Enterprises
- [Enterprise organizations list](#enterprise-organizations-list)
- [Seats management](#seats)
- [Enterprise Limitations](#limitations)
- [Enterprise limitations](#limitations)

Once signup or login with your GitHub Enterprise credentials and, [setup access to could enterprises](#access-cloud-enterprises), navigate to your Enterprises area to manage your enterprises in Codacy, as well its organizations and seats management.
Once you sign up or log in with your GitHub Enterprise credentials and, [set up access to Cloud Enterprise](#access-cloud-enterprises), navigate to your Enterprise area to manage your Enterprises in Codacy, as well as its organizations and seats management.

!!! note
If you only have one Enterprise, Codacy will skip this screen and directs you to the [enterprise organizations list](#enterprise-organizations-list).

![Enterprise cloud manage enterprises](images/Codacy-Enterprises.png)

### Enterprise organizations list
Choose to view a enterprise and access its list of existing organizations, that you have access to.
Select an Enterprise and access its list of existing organizations that you have access to.
![Enterprise cloud manage organizations](images/Codacy-Enterprise-Organizations.png)

### Seats
View and export your enterprise seats and its activity by:
View and export your Enterprise seats and its activity by:

1. Choose and view an enterprise organization
1. Navigate to **People** on the left-handside navigation
1. Choose and view an Enterprise organization
1. Navigate to **People** on the left-hand side navigation
1. View, search and export the list of author seats

!!! note
- Codacy members won't be part of this list, only authors, users that have done commits.
- In some Enterprise plans, **Members** are people that signup and joined an Organization in Codacy, and **Authors** are people that contribute to code changes. It can happen that Authors aren't Codacy Members.
- Codacy members won't be part of this list; only authors and users that have committed.
- In some Enterprise plans, **Members** are people that signed up and joined an Organization in Codacy, and **Authors** are people that contribute to code changes. It can happen that Authors aren't Codacy Members.
- Only Enterprise **Owners** or **Admins** will be able to view and export the list of authors.

### Limitations
Currently, the integration between Codacy and GitHub Enterprise has the following limitations:

- **Repositories with visibility Internal** will, in Codacy, have the same behavior as Private visibility. Although you see the repository in the provider, if you aren't part of the repository in the provider, you won't be able to see it in Codacy.
- **Repositories with visibility set to Internal** will, in Codacy, have the same behavior as those with Private visibility. Although you see the repository in the provider, if you aren't part of the repository in the provider, you won't be able to see it in Codacy.
- **Same email connected to multiple GitHub accounts.** Codacy won't allow you to connect your enterprise account if that email is already associated with a different GitHub account. You can manage your [associated emails in the provider GitHub](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account).
- **GitHub Cloud data residency is not supported.** Codacy is incompatible with GitHub Enterprise Cloud's data residency features. If your GitHub Enterprise Cloud has data residency enabled, Codacy won't be able to access or process your repositories.

Expand Down
Loading