Home
Welcome to the vscode-pull-request-github wiki!
The authentication workflow is OAuth based, where GitHub Pull Requests initially makes a request to a new Auth endpoint, which then triggers a traditional OAuth flow to GitHub. Once the OAuth flow is completed, the token is returned to VS Code, and stored in an encrypted store (KeyChain or alike) locally on your computer.
See https://github.com/Microsoft/vscode-pull-request-github/issues/93 for details
As of version 0.16.0 of the extension, we are discontinuing support for GitHub Enterprise. At the beginning of this project, we had resources to test against Enterprise, but we have now been without that for quite some time. Thank you to all of the community members that have helped fill these gaps. As we continue to add features to the extension, it's become increasingly difficult to maintain Enterprise support. This iteration we moved to a new method of authentication built into VSCode in an effort to unify authentication and account management, and this API currently doesn't support Enterprise accounts.
If you would still like to use the extension, you can use the "Install Another Version" option from the extensions viewlet to download version 0.15.0: https://github.com/Microsoft/vscode/issues/12764#issuecomment-442370545
If your GitHub Enterprise is version 2.14.5 and above, you can authenticate in the same way as you would on GitHub, by clicking on the Sign In button when the dialog asking you to sign in shows up on the bottom right corner.
That means your server doesn't supported integrated sign in. See below for an alternate way of authenticating.
If the integrated sign in process fails, you can create a personal access token to use as your password.
- Go to https://github.com/settings/tokens
- Generate a token with the the following scopes:
repo,read:user, anduser:email(see this guide on how to create a PAT for more details). - In VS Code, start the sign in process by clicking on the "Sign in" button in the GitHub viewlet, and then use the "Signing into GitHub..." status bar item to surface an input box to enter the token.
If your GitHub Enterprise is running with a self-signed certificate, VSCode will not be able to make requests to it, for security purposes, because the OS doesn't trust your server. You can check whether this is the case by browsing to your server and checking the certificate information shown in the lock icon.
In order to connect to a server like this, you'll need to import the certificate into your machine and trust it. You can export the certificate from your browser by clicking on the lock icon (in chrome, for example), clicking on Certificate, Details, Open File, and exporting the certificate as PKCS #7 (.p7b extension), including all the certificates in the path:
You can then double click on the exported file and import it into your user trust store
Restart vscode, and you'll be able to connect to your server.
If you're using an OSS build of Visual Studio Code (for example, the archlinux community build), the extension will fail to activate unless you launch with the flag --enable-proposed-api GitHub.vscode-pull-request-github. In the official build of VSCode, we have a product.json file that has a list of extensions that are allowed to use the proposed APIs. Since this is absent in the OSS build, the flag is needed to enable the proposed api for this extension.
To build this extension, we introduced a new proposed api for adding comments that is meant to be generic (in the release notes here: https://code.visualstudio.com/updates/v1_27#_comment-providers). This extension is meant only to add support for GitHub pull requests - trying to make it integrate with other git providers would make it bloated.
Instead our intent is to have a separate extension for each Pull Request provider. We encourage the community to look into this.
GitLab support, https://github.com/Microsoft/vscode-pull-request-github/issues/356
The roadmap for this extension is still in the making. Next steps for us is to graduate out of public preview.