Enterprise access for GitHub apps

[github-product-roadmap]

Summary

GitHub apps will be able to call APIs on the enterprise object, by being installed on an enterprise and granted new, fine-grained permissions that control access to the Enterprise. This allows administrators to deprecate the use of PATs (classic) and OAuth apps to manage their enterprises.

Intended Outcome

GitHub apps need to be able to operate at the Enterprise layer in order to best automate enterprise operations like managing settings, provisioning users, and reading the audit log. This update helps remove one of the last reasons developers and administrators are forced to use OAuth apps instead of the more secure and manageable GitHub app platform.

How will it work?

App developers will be able to specify Enterprises as a resource target, similar to how organizations and users are selected today. New fine-grained permissions (such as enterprise_audit_log:read) will be created, which administrators can then grant to apps installed on their enterprise.

[ankneis]

Please continue to refer to our updated Public Roadmap for the latest ships, including updates on the continuation of these projects.

[ankneis]

We wanted to provide more details on why we removed this from the roadmap. This work will continue on with the addition of new enterprise roles, permissions, apps, and teams features. Please keep an eye on public roadmap issues starting with #793 and #1059.