diff options
author | Achilleas Pipinellis <axil@gitlab.com> | 2018-03-26 17:48:12 +0200 |
---|---|---|
committer | Achilleas Pipinellis <axil@gitlab.com> | 2018-03-26 17:48:12 +0200 |
commit | d2608d36e47a1527aa44ae0d4b19a97683ece092 (patch) | |
tree | 4ceb136a74bcd6ca25cf12c8321e137dc5b8af6e /doc/integration | |
parent | fe82ef0c013a266f59b84d924f6269d8ea6ed792 (diff) | |
download | gitlab-ce-d2608d36e47a1527aa44ae0d4b19a97683ece092.tar.gz |
Copyedit JWT docs
Diffstat (limited to 'doc/integration')
-rw-r--r-- | doc/integration/jwt.md | 74 | ||||
-rw-r--r-- | doc/integration/omniauth.md | 2 |
2 files changed, 1 insertions, 75 deletions
diff --git a/doc/integration/jwt.md b/doc/integration/jwt.md deleted file mode 100644 index 765b7098b81..00000000000 --- a/doc/integration/jwt.md +++ /dev/null @@ -1,74 +0,0 @@ -# Integrate your server with JWT - -To enable the JWT OmniAuth provider you must register your application with JWT. -JWT will provide you with a secret key for you to use. - -1. On your GitLab server, open the configuration file. - - For omnibus package: - - ```sh - sudo editor /etc/gitlab/gitlab.rb - ``` - - For installations from source: - - ```sh - cd /home/git/gitlab - - sudo -u git -H editor config/gitlab.yml - ``` - -1. See [Initial OmniAuth Configuration](omniauth.md#initial-omniauth-configuration) for initial settings. - -1. Add the provider configuration: - - For omnibus package: - - ```ruby - gitlab_rails['omniauth_providers'] = [ - { name: 'jwt', - app_secret: 'YOUR_APP_SECRET', - args: { - algorithm: 'HS256', - uid_claim: 'email', - required_claims: ["name", "email"], - info_maps: { name: "name", email: "email" }, - auth_url: 'https://example.com/', - valid_within: nil, - } - } - ] - ``` - - For installation from source: - - ``` - - { name: 'jwt', - app_secret: 'YOUR_APP_SECRET', - args: { - algorithm: 'HS256', - uid_claim: 'email', - required_claims: ["name", "email"], - info_map: { name: "name", email: "email" }, - auth_url: 'https://example.com/', - valid_within: nil, - } - } - ``` - - __For more information on each configuration option refer to the [OmniAuth JWT usage documentation](https://github.com/mbleigh/omniauth-jwt#usage).__ - -1. Change 'YOUR_APP_SECRET' to the client secret. - -1. Save the configuration file. - -1. [Reconfigure GitLab][] or [restart GitLab][] for the changes to take effect if you - installed GitLab via Omnibus or from source respectively. - -On the sign in page there should now be a JWT icon below the regular sign in form. -Click the icon to begin the authentication process. JWT will ask the user to sign in and authorize the GitLab application. -If everything goes well the user will be returned to GitLab and will be signed in. - -[reconfigure GitLab]: ../administration/restart_gitlab.md#omnibus-gitlab-reconfigure -[restart GitLab]: ../administration/restart_gitlab.md#installations-from-source diff --git a/doc/integration/omniauth.md b/doc/integration/omniauth.md index c6cc023d7bf..3edde3de83d 100644 --- a/doc/integration/omniauth.md +++ b/doc/integration/omniauth.md @@ -32,7 +32,7 @@ contains some settings that are common for all providers. - [Auth0](auth0.md) - [Authentiq](../administration/auth/authentiq.md) - [OAuth2Generic](oauth2_generic.md) -- [JWT](jwt.md) +- [JWT](../administration/auth/jwt.md) ## Initial OmniAuth Configuration |