Differences

This shows you the differences between two versions of the page.

--- en:2.0:single_sign_on:saml_gitlab [2026/09/05 20:14] – [Prerequisites] kainhofer
+++ en:2.0:single_sign_on:saml_gitlab [2026/09/05 23:42] (current) – [Configuring the Service Provider (Gitlab)] kainhofer
@@ Line 15: / Line 15: @@
 The page https://admidio.local/adm_program/modules/preferences.php?panel=sso provides the link to the metadata xml, and the individual settings in case a client does not support auto-configuration via metadata.
-===== TL;DR; - Quick Overview =====
+===== Quick Overview =====
-Setting up a client (SAML "Service Provider" - short SP) to use Admidio's user accounts for logging in consists of two steps. If both the IdP (Admidio in our case) and the SP (Gitlab in this document) support metadata loading, the setup is very straightforward and easy. Otherwise, one has to copy URLs manually to the client, but Admidio already provides these in a single place, so this situation is not as bad, either.
+Setting up a client (SAML "Service Provider" = "SP") to use Admidio's user accounts for log-in consists of two steps. If both the IdP (Admidio in our case) and the SP (Gitlab in this document) support metadata loading, the setup is very straightforward and easy. Otherwise, one has to copy URLs manually to the client, but Admidio already provides these in a single place, so this case is also straightforward.
   * At the **Service Provider (SP)** - Gitlab in our case - **install the extension** to support SAML login.
@@ Line 23: / Line 23: @@
   * Choose whether sent messages **should be signed and/or encrypted** (these features require an additional private key and certificate for the SP!), and whether received messages are checked for signatures or encryption is expected.
   * In **Admidio**, **create a new SAML client**. If the SP provides a **metadata URL**, paste it and let Admidio automatically load the configuration from the SP. One can also manually paste these settings.
-    * Choose an easily understood **label for the client** (only used in Admidio's list of clients, but has no technical use)
+    * Choose an easily understood **label for the client** (only used in Admidio's list of clients as visual identifier, but has no technical use)
     * Enter the **ClientID from the SP**, as well as the ACS URL and the SLO response URL. These values must be provided by the client.
   * In Admidio, also choose whether sent messages should be **signed or encrypted**. The crypto key generated in the general SAML setup will be used.
@@ Line 34: / Line 34: @@
 Gitlab does not provide a graphic config interface to set up SAML. However, it is easy to set up SAML in the config file (gitlab.rb) as described in https://docs.gitlab.com/17.10/integration/saml/.
-An example would be as follows. The URLs and the certificate can again be copied from Admidios SSO preferences page.
+{{ :en:2.0:sso:sso_saml_05-00_gitlab_saml_preferences.png?400|}}An example would be as follows. The URLs and the certificate can again be copied from Admidios SSO preferences page.
 <code>
 gitlab_rails['omniauth_enabled'] = true