website/integrations: Added GitHub Enterprise Server (#4591)

This commit is contained in:
Oliver Møller 2023-02-01 18:22:53 +00:00 committed by GitHub
parent 98b7597fde
commit dbd324f202
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 49 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 622 KiB

View File

@ -0,0 +1,48 @@
---
title: GitHub Enterprise Server
---
<span class="badge badge--secondary">Support level: Community</span>
## What is GitHub Enterprise Server
From https://docs.github.com/en/enterprise-server@3.5/admin/overview/about-github-enterprise-server
:::note
GitHub Enterprise Server is a self-hosted platform for software development within your enterprise. Your team can use GitHub Enterprise Server to build and ship software using Git version control, powerful APIs, productivity and collaboration tools, and integrations. Developers familiar with GitHub.com can onboard and contribute seamlessly using familiar features and workflows.
:::
## Preparation
The following placeholders will be used:
- `https://github.company` is your GitHub Enterprise Server installation
- `authentik.company` is the FQDN of the authentik Install
Create an application in authentik and note the slug, as this will be used later. Create a SAML provider with the following parameters:
- ACS URL: `https://github.company/saml/consume`
- Audience: `https://github.company`
- Issuer: `https://github.company`
- Binding: `Post`
Under _Advanced protocol settings_, set a certificate for _Signing Certificate_.
Once the provider is created, it is advised to download the signing certificate as you will need it later.
## GitHub Configuration
Navigate to your appliance maintenance settings. These are found at `https://github.company:8443`. Here, sign in with an administrator user and go to the Authentication section.
On this page:
- Select the `SAML` option.
- In `Sign on URL`, type `https://authentik.company/application/saml/<authentik application slug>/sso/binding/redirect/` (This is your `SSO URL (Redirect)` in Authentik)
- For `Issuer`, type `https://github.company` or the `Audience` you set in authentik
- Verify that the `Signature method` and `Digest method` match your SAML provider settings in authentik.
- For `Validation certificate`, upload the signing certificate you downloaded after creating the provider.
- Press Save settings on the left-hand side and wait for the changes to apply.
![Screenshot showing populated GitHub Enterprise Server SAML settings](ghes_saml_settings.png)
Once the appliance has saved the settings and reloaded the services, you should be able to navigate to your instance URL at `https://github.company` and sign in with SAML.

View File

@ -111,6 +111,7 @@ module.exports = {
items: [
"services/gitea/index",
"services/github-enterprise-cloud/index",
"services/github-enterprise-server/index",
"services/github-organization/index",
"services/gitlab/index",
],