* Empty commit * updated beta note for GHAE * more GHAE update + resolve conflict * more GHAE updates + prepare for screenshots * Apply suggestions from code review Co-authored-by: Shati Patel <42641846+shati-patel@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Shati Patel <42641846+shati-patel@users.noreply.github.com> * address remaining review comments * Revise "About GitHub AE" (#17679) * add screenshots to the Configuring article * reworked to have a separate GHAE section * list numbering * more work on screenshots and conditions * add GHAE screenshots in article * review screenshots in article * added more screenshots and updated more articles * screenshot madness * fix liquid versioning * refactor the ghae script * [GHAE CB/Feb 22]: Add article about data residency for GitHub AE (#17847) * add missing GHAE versioning to article * move screenshots to GHAE asset directory * forgot to change the path for these two images * replace CBB screenshot + add better screenshot * [GHAE CB/Feb 22]: Document upgrades for GitHub AE (#17848) * Version article for GitHub AE * Replace unused variable * Incorporate reviewer feedback * Update intro Co-authored-by: Ethan P <56270045+ethanpalm@users.noreply.github.com> * [GHAE] Enable IP allow list (#17691) * Notes for CC * Updat permission leves chart * Add updated article to further reading * Update gated feature callout with GitHub AE * Version "Managing allowed IP addresses for your organization" for AE * Update images * Update "Restricting network traffic to your enterprise" with new procedures * remove todo note * Update audited actions * Update info about Premium Runners * Use reusable for Premium Runners * Change "Premium Runners" to "AE hosted runners" * Incorporate reviewer feedback * Use correct reusable * Version reusable correctly * [Feb 22] GHAE: Code scanning beta (#17830) * Add "github-ae" to all the frontmatter * GHAE-ify the reusables * Add some more changes * Re-use some content * 🔪 Semmle links * Revert change re "--external-repository-token" in the CodeQL runner * Update CodeQL runner token scopes * Update two screenshots * Remove mention of GitHub.com from AE + other fixes * Apply suggestions from code review Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> * Use `product_name` variable instead of `product_location` * Remove confusing phrase * [Feb 22] GHAE: Code scanning API and webhook docs (#17883) * Version API and webhook docs * Actually add versioning for GHAE * Fix anchor * [TEMPORARY] Preview for API endpoints * Revert API previews * Update procedure step Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> * Update docs for AzureAD Group SCIM support in GHAE (#17892) * [GHAE CB] SMTP bootstrapping flow (#17888) * draft * update with AE conntent * update with tons of versioning * remove that lie * fill out the rest of these steps * update with correct versioning * more edits * add images * reversion most of ae article * fix versioning * format correctlly * words matter * last image * update with permmissions * update versioning * add link * apply feedback ❤️ * update with differrent spacing * update with feedback * more feedback * Temporary GHAE release notes for consumables beta launch (#17859) * Create release-notes.md * Add frontmatter * Add to index file * Update github-ae-release-notes.md * Add release notes from Google Doc * Update finalized docs links that have been reviewed * OAuth device flow link update * version for AE * few fixes * Update content/admin/overview/github-ae-release-notes.md * small edits * whoops * commit * update with different links * used wrong reusable * fix more brokenness * Update repository-references.js * Update repository-references.js Co-authored-by: Meg Bird <megbird@github.com> Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com> * [GHAE] Audit public repos (#17917) * verifying what we mean by public * Apply suggestions from code review * Update content/developers/apps/installing-github-apps.md Co-authored-by: Laura Coursen <lecoursen@github.com> * fixing placememnt of liquid conditional Co-authored-by: Laura Coursen <lecoursen@github.com> * GHAE packages beta (#17786) Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com> Co-authored-by: Martin Lopes <martin389@github.com> * fix broken links * [GHAE CB/March 01]: GitHub Actions on GHAE (beta) (#17725) * Added initial layout for premium runners * Restructured content * Added placeholder for removing premium runner * Added versioning and warning note for self-hosted runners * Added versioning and beta notice for actions content * Rephrased beta note * Added versioning for API docs, fixes * Added versioning fixes * Split Github-hosted and premium topics into separate articles * Added edits * Restructured some topics * Revised "Using premium runners in a workflow" * Some small fixes * Fixed typo * Added fixes to reusable * Added edits * Made section titles consistent * Added billing, group mgmt, reusable steps * Cropped certain screenshots for future-proofing * Removed superfluous reusable * Added fixes * Revert "Cropped certain screenshots for future-proofing" This reverts commit c7f24f31fa30d4fe3de2b63fc3cd5feba44ef518. * Added new section for custom images * Added versioning for enterprise-admin operations * Added edits * Added edits * Update adding-premium-runners.md * Removed SHR screenshots. Intending to update them when UI is available. * Update using-labels-with-premium-runners.md * Added custom labels section * Added preview of API docs changes * Added versioning for ip allow list section * Removed removal article * Renamed premium runners to AE hosted runners * Re-added added API preview * Fixed links, updated software specs * Revised "Software specifications" based on feedback * Fixed typos * Small fixes * Added new article "Creating custom images" * Moved "Creating custom images" link * Apply suggestions from code review Co-authored-by: ahdbilal <55514721+ahdbilal@users.noreply.github.com> * Added update from review * Added updates from tech review * Apply suggestions from code review Co-authored-by: ahdbilal <55514721+ahdbilal@users.noreply.github.com> * Added updates from tech review * Added updates from tech review * Added updates from tech review * Added updates from tech review * Fixed reusable * Added fixes * Added update from tech review * Removed the dereferenced OpenAPI schema files * Added fixes * Fixed links * Fixed links * Apply suggestions from code review Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com> * Added updates from peer review * Removed sections that are not in beta * Update viewing-your-github-actions-usage.md * Update viewing-job-execution-time.md * Update index.md * Update about-github-hosted-runners.md * Restored versioning to match GHES approach * Fixed link * Restored self-hosted runner reference to UI steps. * Updated screenshots * Updated screenshots and procedures * Small edits to screenshots * Added AE url info for SHR * Removed superfluous versioning * Update security-hardening-for-github-actions.md * Update actions-shared.md * Small edits * Update usage-limits-billing-and-administration.md * Update managing-complex-workflows.md * Additional versioning * Additional versioning * version environments api and checkrun deployments for ghae (#17991) Co-authored-by: Martin Lopes <martin389@github.com> * Update reviewing-the-audit-log-for-your-organization.md * Added versioning for enterprise policy settings * version configuring artifact retention for AE * remove AE versioning for connecting to Marketplace * Apply suggestions from code review Co-authored-by: Joe Bourne <thejoebourneidentity@github.com> * Update content/admin/github-actions/getting-started-with-github-actions-for-github-ae.md Co-authored-by: Joe Bourne <thejoebourneidentity@github.com> * rewording not public to private * fixing liquid * Fixed elseif entries * Added expectations note * Revised label management article for AE hosted runners * Added enterprise-admin note for adding AE hosted runners * Update enterprise-admin.md * Update self-hosted-runner-security.md * Versioned reusable for AE * Empty commit for CI Co-authored-by: ahdbilal <55514721+ahdbilal@users.noreply.github.com> Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com> Co-authored-by: skedwards88 <skedwards88@github.com> Co-authored-by: Leona B. Campbell <3880403+runleonarun@users.noreply.github.com> Co-authored-by: Joe Bourne <thejoebourneidentity@github.com> Co-authored-by: runleonarun <runleonarun@github.com> * Update OpenAPI Descriptions for GHAE * Update content/admin/overview/github-ae-release-notes.md Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: mchammer01 <42146119+mchammer01@users.noreply.github.com> Co-authored-by: Shati Patel <42641846+shati-patel@users.noreply.github.com> Co-authored-by: shati-patel <shati-patel@github.com> Co-authored-by: Sarah Schneider <sarahs@github.com> Co-authored-by: skedwards88 <skedwards88@github.com> Co-authored-by: Sarah Schneider <sarahs@users.noreply.github.com> Co-authored-by: Melanie Yarbrough <11952755+myarb@users.noreply.github.com> Co-authored-by: Felicity Chapman <felicitymay@github.com> Co-authored-by: Meg Bird <megbird@github.com> Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com> Co-authored-by: Leona B. Campbell <3880403+runleonarun@users.noreply.github.com> Co-authored-by: Laura Coursen <lecoursen@github.com> Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com> Co-authored-by: Martin Lopes <martin389@github.com> Co-authored-by: ahdbilal <55514721+ahdbilal@users.noreply.github.com> Co-authored-by: Joe Bourne <thejoebourneidentity@github.com> Co-authored-by: runleonarun <runleonarun@github.com> Co-authored-by: github-openapi-bot <69533958+github-openapi-bot@users.noreply.github.com>
17 KiB
title, intro, miniTocMaxHeadingLevel, redirect_from, versions
| title | intro | miniTocMaxHeadingLevel | redirect_from | versions | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Repository permission levels for an organization | You can customize access to each repository in your organization with granular permission levels, giving people access to the features and tasks they need. | 4 |
|
|
People with admin permissions can manage individual and team access to an organization-owned repository.
Permission levels for repositories owned by an organization
You can give organization members, outside collaborators, and teams of people different levels of access to repositories owned by an organization. Each permission level progressively increases access to a repository's content and settings. Choose the level that best fits each person or team's role in your project without giving people more access to the project than they need.
From least access to most access, the permission levels for an organization repository are:
- Read: Recommended for non-code contributors who want to view or discuss your project
- Triage: Recommended for contributors who need to proactively manage issues and pull requests without write access
- Write: Recommended for contributors who actively push to your project
- Maintain: Recommended for project managers who need to manage the repository without access to sensitive or destructive actions
- Admin: Recommended for people who need full access to the project, including sensitive and destructive actions like managing security or deleting a repository
{% if currentVersion == "free-pro-team@latest" %}
{% endif %}
For more information about giving people and teams access to repositories, see "Managing access to your organization's repositories."
Organization owners can set base permissions that apply to all members of an organization when accessing any of the organization's repositories. For more information, see "Setting base permissions for an organization."
Organization owners can also choose to further limit access to certain settings and actions across the organization. For more information on options for specific settings, see "Managing organization settings."
In addition to managing organization-level settings, organization owners have admin permissions for every repository owned by the organization. For more information, see "Permission levels for an organization."
{% warning %}
Warning: When someone adds a deploy key to a repository, any user who has the private key can read from or write to the repository (depending on the key settings), even if they're later removed from the organization.
{% endwarning %}
Repository access for each permission level
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %}
Note: Repository permissions required to use security features are listed in "Permission requirements for security features" below.
{% endnote %} {% endif %}
| Repository action | Read | Triage | Write | Maintain | Admin |
|---|---|---|---|---|---|
| Pull from the person or team's assigned repositories | X | X | X | X | X |
| Fork the person or team's assigned repositories | X | X | X | X | X |
| Edit and delete their own comments | X | X | X | X | X |
| Open issues | X | X | X | X | X |
| Close issues they opened themselves | X | X | X | X | X |
| Reopen issues they closed themselves | X | X | X | X | X |
| Have an issue assigned to them | X | X | X | X | X |
| Send pull requests from forks of the team's assigned repositories | X | X | X | X | X |
| Submit reviews on pull requests | X | X | X | X | X |
| View published releases | X | X | X | X | X |
| View GitHub Actions workflow runs | X | X | X | X | X |
| Edit wikis | X | X | X | X | X |
| Report abusive or spammy content | X | X | X | X | X |
| Apply/dismiss labels | X | X | X | X | |
| Create, edit, delete labels | X | X | X | ||
| Close, reopen, and assign all issues and pull requests | X | X | X | X | |
| Enable and disable auto-merge on a pull request | X | X | X | ||
| Apply milestones | X | X | X | X | |
| Mark duplicate issues and pull requests | X | X | X | X | |
| Request pull request reviews | X | X | X | X | |
| Push to (write) the person or team's assigned repositories | X | X | X | ||
| Edit and delete anyone's comments on commits, pull requests, and issues | X | X | X | ||
| Hide anyone's comments | X | X | X | ||
| Lock conversations | X | X | X | ||
| Transfer issues (see "Transferring an issue to another repository" for details) | X | X | X | ||
| Act as a designated code owner for a repository | X | X | X | ||
| Mark a draft pull request as ready for review | X | X | X | ||
| Convert a pull request to a draft | X | X | X | ||
| Submit reviews that affect a pull request's mergeability | X | X | X | ||
| Apply suggested changes to pull requests | X | X | X | ||
| Create status checks | X | X | X | ||
| Create, edit, run, re-run, and cancel GitHub Actions workflows | X | X | X | ||
| Create and edit releases | X | X | X | ||
| View draft releases | X | X | X | ||
| Edit a repository's description | X | X | |||
| View and install packages | X | X | X | X | X |
| Publish packages | X | X | X | ||
| {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}Delete and restore packages{% elsif currentVersion ver_lt "enterprise-server@3.1" or currentVersion == "github-ae@latest" %}Delete packages{% endif %} | X | ||||
| Manage topics | X | X | |||
| Enable wikis and restrict wiki editors | X | X | |||
| Enable project boards | X | X | |||
| Configure pull request merges | X | X | |||
| Configure a publishing source for {% data variables.product.prodname_pages %} | X | X | |||
| Push to protected branches | X | X | |||
| Create and edit repository social cards | X | X | |||
| Limit interactions in a repository | X | X | |||
| Delete an issue (see "Deleting an issue") | X | ||||
| Merge pull requests on protected branches, even if there are no approving reviews | X | ||||
| Define code owners for a repository | X | ||||
| Add a repository to a team (see "Managing team access to an organization repository" for details) | X | ||||
| Manage outside collaborator access to a repository | X | ||||
| Change a repository's visibility | X | ||||
| Make a repository a template (see "Creating a template repository") | X | ||||
| Change a repository's settings | X | ||||
| Manage team and collaborator access to the repository | X | ||||
| Edit the repository's default branch | X | ||||
| Rename the repository's default branch (see "Renaming a branch") | X | ||||
| Rename a branch other than the repository's default branch (see "Renaming a branch") | X | X | X | ||
| Manage webhooks and deploy keys | X | ||||
| Manage data use settings for your private repository | X | ||||
| Manage the forking policy for a repository | X | ||||
| Transfer repositories into the organization | X | ||||
| Delete or transfer repositories out of the organization | X | ||||
| Archive repositories | X | ||||
| Display a sponsor button (see "Displaying a sponsor button in your repository") | X | ||||
| Create autolink references to external resources, like JIRA or Zendesk (see "Configuring autolinks to reference external resources") | X | ||||
| Enable {% data variables.product.prodname_discussions %} in a repository | X | X | |||
| Create and edit categories for {% data variables.product.prodname_discussions %} | X | X | |||
| Move a discussion to a different category | X | X | X | ||
| Transfer a discussion to a new repository | X | X | X | ||
| Manage pinned discussions | X | X | X | ||
| Convert issues to discussions in bulk | X | X | X | ||
| Lock and unlock discussions | X | X | X | X | |
| Individually convert issues to discussions | X | X | X | X | |
| Create new discussions and comment on existing discussions | X | X | X | X | X |
| Delete a discussion | X | X |
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %}
Permission requirements for security features
In this section, you can find the repository permission levels required for security features, such as {% data variables.product.prodname_advanced_security %} features.
| Repository action | Read | Triage | Write | Maintain | Admin | |:---|:---:|:---:|:---:|:---:|:---:|{% if currentVersion == "free-pro-team@latest" %} | Receive {% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies in a repository | | | | | X | | Dismiss {% data variables.product.prodname_dependabot_alerts %} | | | | | X | | Designate additional people or teams to receive {% data variables.product.prodname_dependabot_alerts %} for vulnerable dependencies | | | | | X | | Create security advisories | | | | | X |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@latest" %} | Manage access to {% data variables.product.prodname_GH_advanced_security %} features (see "Managing security and analysis settings for your organization") | | | | | X |{% endif %}{% if currentVersion == "free-pro-team@latest" %} | Enable the dependency graph for a private repository | | | | | X | | View dependency reviews | X | X | X | X | X |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} | View {% data variables.product.prodname_code_scanning %} alerts on pull requests | X | X | X | X | X | | List, dismiss, and delete {% data variables.product.prodname_code_scanning %} alerts | | | X | X | X |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@latest" %} | View {% data variables.product.prodname_secret_scanning %} alerts in a repository | | | | | X | | Resolve, revoke or re-open {% data variables.product.prodname_secret_scanning %} alerts | | | | | X | | Designate additional people or teams to receive {% data variables.product.prodname_secret_scanning %} alerts in repositories | | | | | X |{% endif %} {% endif %}