debian-mirror-gitlab/doc/integration/google.md

115 lines
4 KiB
Markdown
Raw Normal View History

2014-09-02 18:07:02 +05:30
# Google OAuth2 OmniAuth Provider
2018-03-17 18:26:18 +05:30
To enable the Google OAuth2 OmniAuth provider you must register your application
with Google. Google will generate a client ID and secret key for you to use.
## Enabling Google OAuth
In Google's side:
1. Navigate to the [cloud resource manager](https://console.cloud.google.com/cloud-resource-manager) page
1. Select **Create Project**
1. Provide the project information:
- **Project name** - "GitLab" works just fine here.
- **Project ID** - Must be unique to all Google Developer registered applications.
Google provides a randomly generated Project ID by default. You can use
the randomly generated ID or choose a new one.
1. Refresh the page and you should see your new project in the list
1. Go to the [Google API Console](https://console.developers.google.com/apis/dashboard)
1. Select the previously created project form the upper left corner
1. Select **Credentials** from the sidebar
1. Select **OAuth consent screen** and fill the form with the required information
1. In the **Credentials** tab, select **Create credentials > OAuth client ID**
1. Fill in the required information
- **Application type** - Choose "Web Application"
- **Name** - Use the default one or provide your own
- **Authorized JavaScript origins** -This isn't really used by GitLab but go
ahead and put `https://gitlab.example.com`
- **Authorized redirect URIs** - Enter your domain name followed by the
callback URIs one at a time:
2014-09-02 18:07:02 +05:30
2018-03-17 18:26:18 +05:30
```
https://gitlab.example.com/users/auth/google_oauth2/callback
2018-11-08 19:23:39 +05:30
https://gitlab.example.com/-/google_api/auth/callback
2018-03-17 18:26:18 +05:30
```
2014-09-02 18:07:02 +05:30
2018-03-17 18:26:18 +05:30
1. You should now be able to see a Client ID and Client secret. Note them down
or keep this page open as you will need them later.
2018-11-08 19:23:39 +05:30
1. From the **Dashboard** select **ENABLE APIS AND SERVICES > Compute > Google+ API > Enable**
1. To enable projects to access [Google Kubernetes Engine](../user/project/clusters/index.md), you must also
enable these APIs:
- Google Kubernetes Engine API
- Cloud Resource Manager API
- Cloud Billing API
2014-09-02 18:07:02 +05:30
2018-03-17 18:26:18 +05:30
On your GitLab server:
2014-09-02 18:07:02 +05:30
2018-03-17 18:26:18 +05:30
1. Open the configuration file.
2015-04-26 12:48:37 +05:30
2018-03-17 18:26:18 +05:30
For Omnibus GitLab:
2015-04-26 12:48:37 +05:30
```sh
2018-03-17 18:26:18 +05:30
sudo editor /etc/gitlab/gitlab.rb
2015-04-26 12:48:37 +05:30
```
2015-12-23 02:04:40 +05:30
For installations from source:
2014-09-02 18:07:02 +05:30
```sh
2018-03-17 18:26:18 +05:30
cd /home/git/gitlab
sudo -u git -H editor config/gitlab.yml
2014-09-02 18:07:02 +05:30
```
2018-03-17 18:26:18 +05:30
1. See [Initial OmniAuth Configuration](omniauth.md#initial-omniauth-configuration) for initial settings.
1. Add the provider configuration:
2015-04-26 12:48:37 +05:30
2018-03-17 18:26:18 +05:30
For Omnibus GitLab:
2015-04-26 12:48:37 +05:30
```ruby
2018-03-17 18:26:18 +05:30
gitlab_rails['omniauth_providers'] = [
{
"name" => "google_oauth2",
"app_id" => "YOUR_APP_ID",
"app_secret" => "YOUR_APP_SECRET",
"args" => { "access_type" => "offline", "approval_prompt" => '' }
}
]
2015-04-26 12:48:37 +05:30
```
2014-09-02 18:07:02 +05:30
2015-04-26 12:48:37 +05:30
For installations from source:
2014-09-02 18:07:02 +05:30
2018-11-08 19:23:39 +05:30
```yaml
2018-03-17 18:26:18 +05:30
- { name: 'google_oauth2', app_id: 'YOUR_APP_ID',
app_secret: 'YOUR_APP_SECRET',
args: { access_type: 'offline', approval_prompt: '' } }
2014-09-02 18:07:02 +05:30
```
2018-03-17 18:26:18 +05:30
1. Change `YOUR_APP_ID` to the client ID from the Google Developer page
1. Similarly, change `YOUR_APP_SECRET` to the client secret
1. Make sure that you configure GitLab to use an FQDN as Google will not accept
raw IP addresses.
2017-09-10 17:25:29 +05:30
For Omnibus packages:
```ruby
2018-03-17 18:26:18 +05:30
external_url 'https://gitlab.example.com'
2017-09-10 17:25:29 +05:30
```
For installations from source:
```yaml
gitlab:
host: https://gitlab.example.com
```
2014-09-02 18:07:02 +05:30
1. Save the configuration file.
2017-08-17 22:00:37 +05:30
1. [Reconfigure][] or [restart GitLab][] for the changes to take effect if you
installed GitLab via Omnibus or from source respectively.
2014-09-02 18:07:02 +05:30
2018-03-17 18:26:18 +05:30
On the sign in page there should now be a Google icon below the regular sign in
form. Click the icon to begin the authentication process. Google 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.
2017-08-17 22:00:37 +05:30
[reconfigure]: ../administration/restart_gitlab.md#omnibus-gitlab-reconfigure
[restart GitLab]: ../administration/restart_gitlab.md#installations-from-source