summaryrefslogtreecommitdiff
path: root/doc/integration/crowd.md
diff options
context:
space:
mode:
authorValery Sizov <vsv2711@gmail.com>2015-08-31 13:59:52 +0300
committerValery Sizov <vsv2711@gmail.com>2015-09-02 12:42:01 +0300
commit3700e5a9607ba9980940a29d275e22034538473d (patch)
treee781dc06aba5c73b979295eb124b1ef68c1f20aa /doc/integration/crowd.md
parent6f19e8799e4c8233b01068bf6b5406b0ba1d1105 (diff)
downloadgitlab-ce-3700e5a9607ba9980940a29d275e22034538473d.tar.gz
Crowd integration
Diffstat (limited to 'doc/integration/crowd.md')
-rw-r--r--doc/integration/crowd.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/doc/integration/crowd.md b/doc/integration/crowd.md
new file mode 100644
index 00000000000..2ecc8795ac1
--- /dev/null
+++ b/doc/integration/crowd.md
@@ -0,0 +1,58 @@
+# Crowd OmniAuth Provider
+
+To enable the Crowd OmniAuth provider you must register your application with Crowd. To configure Crowd integration you need an application name and password.
+
+1. On your GitLab server, open the configuration file.
+
+ For omnibus package:
+
+ ```sh
+ sudo editor /etc/gitlab/gitlab.rb
+ ```
+
+ For instalations 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" => "crowd",
+ "args" => {
+ "crowd_server_url" => "CROWD",
+ "application_name" => "YOUR_APP_NAME",
+ "application_password" => "YOUR_APP_PASSWORD"
+ }
+ }
+ ]
+ ```
+
+ For installations from source:
+
+ ```
+ - { name: 'crowd',
+ args: {
+ crowd_server_url: 'CROWD SERVER URL',
+ application_name: 'YOUR_APP_NAME',
+ application_password: 'YOUR_APP_PASSWORD' } }
+ ```
+
+1. Change 'YOUR_APP_NAME' to the application name from Crowd applications page.
+
+1. Change 'YOUR_APP_PASSWORD' to the application password you've set.
+
+1. Save the configuration file.
+
+1. Restart GitLab for the changes to take effect.
+
+On the sign in page there should now be a Crowd tab in the sign in form. \ No newline at end of file