ToolJet/docs/versioned_docs/version-2.18.0/user-authentication/sso/github.md
Shubhendra Singh Chauhan 9f2ff94a12
[docs] platform 5.x (#7427)
* whtie label revamp

* minor changes

* updated beta info in copilot docs

* renamed gds to ds in overview doc of v2.15 onwards

* updated multienv: renamed gds to ds, updated screenshot

* updated multienv: app state description

* updated superadmin wrt new licensing updates

* licensing update: free trial

* updates in licensing

* changes after review

* [docs]updated restapi with bearer auth

* Update kubernetes-aks.md

* Update openshift.md

* Update ecs.md

* Update ecs.md

* Update kubernetes-gke.md

* Update kubernetes.md

* Update docker.md

* Update docker.md

* Update ecs.md

* Update google-cloud-run.md

* Update kubernetes-aks.md

* Update kubernetes-gke.md

* Update kubernetes.md

* Update openshift.md

* Update kubernetes-gke.md

* Update kubernetes-aks.md

* fixed ecs, removed heroku from 2.15 onwards

* updated digitalocean doc

* licensing doc changes and location

* Update digitalocean.md

* Update digitalocean.md

* added v2.18.0

---------

Co-authored-by: Adish M <44204658+adishM98@users.noreply.github.com>
2023-09-27 12:24:39 +05:30

2.5 KiB

id title
github GitHub

GitHub Single Sign-on

  • Go to the Workspace Settings (⚙️) from the left sidebar in the ToolJet dashboard

    General Settings: SSO
  • Select SSO from sidebar and then select GitHub. GitHub login will be disabled by default,

    General Settings: SSO
  • Enable GitHub. You can see Redirect URL generated

    General Settings: SSO
  • Go to GitHub Developer settings and navigate to OAuth Apps and create a project. Authorization callback URL should be the generated Redirect URL in Git manage SSO page.

    General Settings: SSO
  • Open the application details, and you can see the Client ID

    General Settings: SSO
  • Then create Client secrets by clicking Generate new client secret

    General Settings: SSO

Lastly, enter Client Id and Client Secret in GitHub manage SSO page and save.

The GitHub sign-in button will now be available in your ToolJet login screen.

:::info Should configure Host Name if you are using GitHub Enterprise self hosted. Host name should be a URL and should not ends with /, example: https://github.tooljet.com :::

Setting default SSO

To set GitHub as default SSO for the instance use environment variable.

variable description
SSO_GIT_OAUTH2_CLIENT_ID GitHub OAuth client id
SSO_GIT_OAUTH2_CLIENT_SECRET GitHub OAuth client secret
SSO_GIT_OAUTH2_HOST GitHub OAuth host name if GitHub is self hosted

Redirect URL should be <host>/sso/git