diff --git a/assemblies/assembly-authenticating-with-github.adoc b/assemblies/assembly-authenticating-with-github.adoc index 70d1c5a361..4d30cd3d36 100644 --- a/assemblies/assembly-authenticating-with-github.adoc +++ b/assemblies/assembly-authenticating-with-github.adoc @@ -1,5 +1,5 @@ -[id="assembly-auth-provider-github"] -= Enabling the GitHub authentication provider +[id="authenticating-with-github"] += Authenticating with GitHub To authenticate users with GitHub or GitHub Enterprise: diff --git a/modules/authentication/proc-enabling-authentication-with-github.adoc b/modules/authentication/proc-enabling-authentication-with-github.adoc index b4157bdec0..df2911af57 100644 --- a/modules/authentication/proc-enabling-authentication-with-github.adoc +++ b/modules/authentication/proc-enabling-authentication-with-github.adoc @@ -159,6 +159,39 @@ auth: enterpriseInstanceUrl: ${GITHUB_HOST_DOMAIN} ---- +[TIP] +==== +To enable GitHub integration with a different authentication provider, complete the following configurations: + +* Add the GitHub provider to the existing `auth` section. +* Keep the `signInPage` section from your authentication provider configuration. + +.`app-config-rhdh.yaml` fragment with mandatory fields to enable GitHub integration and use a different authentication provider +[source,yaml,subs="+quotes"] +---- +auth: + environment: production + providers: + github: + production: + clientId: ${AUTH_GITHUB_CLIENT_ID} + clientSecret: ${AUTH_GITHUB_CLIENT_SECRET} + ____ +integrations: + github: + - host: ${GITHUB_HOST_DOMAIN} + apps: + - appId: ${AUTH_GITHUB_APP_ID} + clientId: ${AUTH_GITHUB_CLIENT_ID} + clientSecret: ${GITHUB_CLIENT_SECRET} + webhookUrl: ${GITHUB_WEBHOOK_URL} + webhookSecret: ${GITHUB_WEBHOOK_SECRET} + privateKey: | + ${GITHUB_PRIVATE_KEY_FILE} +signInPage: ____ +---- +==== + -- .Verification diff --git a/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc b/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc index b2f05fd5bd..e76f86c0a0 100644 --- a/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc +++ b/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc @@ -3,7 +3,7 @@ You can enable the Bulk Import feature for users and give them the necessary permissions to access it. .Prerequisites -* You have link:{authentication-book-url}#enabling-authentication-with-github[configured GitHub authentication and integration]. +* You have link:{authentication-book-url}#enabling-authentication-with-github[configured GitHub integration]. .Procedure diff --git a/modules/importing-repositories/procedure-importing-multiple-repositories-from-github.adoc b/modules/importing-repositories/procedure-importing-multiple-repositories-from-github.adoc index b0c38724ff..ac241bfad5 100644 --- a/modules/importing-repositories/procedure-importing-multiple-repositories-from-github.adoc +++ b/modules/importing-repositories/procedure-importing-multiple-repositories-from-github.adoc @@ -4,7 +4,6 @@ In {product}, you can select your GitHub repositories and automate their onboarding to the {product-short} catalog. .Prerequisites -* You have link:{authentication-book-url}#enabling-authentication-with-github[configured GitHub authentication and integration]. * You have xref:enabling-and-giving-access-to-the-bulk-import-feature[enabled the Bulk Import feature and gave access to it]. .Procedure