GitLab ile Tek Oturum Açma
Bakiye gerekir HTTP tünelleri
Bu sayfada 4 bölüm
Ziyaretçilerin bir HTTP tünelini açmadan önce GitLab hesaplarıyla oturum açmasını sağlayın. GitLab.com ile ve kendi barındırdığınız bir GitLab örneğiyle çalışır. GitLab'da bir OAuth uygulaması oluşturur, onu Localtonet'e sağlayıcı olarak ekler, ardından tünel için açarsınız.
Başlamadan önce #
- Bir HTTP tüneli ve hesabınızda bakiye. Tek Oturum Açma genel bakışına bakın.
- GitLab.com'da veya kendi örneğinizde bir GitLab hesabı.
- Kendi barındırdığınız bir örnek için: adresine internetten ulaşılabilmelidir. Ziyaretçilerinizin tarayıcıları oturum açma sayfasını açar ve Localtonet'in oturum açma ana bilgisayarı token ve kullanıcı uç noktalarını doğrudan çağırır.
Adımlar #
-
GitLab'da bir OAuth uygulaması oluşturun #
GitLab'ın kendi kılavuzu Configure GitLab as an OAuth 2.0 authentication identity provider sayfasıdır. Bir uygulama bir kullanıcıya, bir gruba veya tüm örneğe ait olabilir:
Sahip Nerede oluşturulur Kullanıcınız Avatarınızı, ardından Edit profile, sonra Access › Applications ve Add new application seçeneğini seçin. Bir grup Grubu açın, ardından Settings › Applications seçeneğini seçin. Örnek (kendi barındırdığınız, yalnızca yöneticiler) Admin › Applications ve New application. Formu doldurun ve Save application düğmesini seçin:
GitLab alanı Değer Name Ziyaretçilerinizin tanıyacağı bir ad. GitLab, onlardan yetki vermelerini isterken bu adı gösterir. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Seçili bırakın. Scopes read_userGitLab ardından Application ID ve Secret değerlerini gösterir. İkisini de hemen kopyalayın: GitLab secret değerini yalnızca uygulama oluşturulduktan hemen sonra gösterir.
read_userkapsamı, oturum açmış kullanıcının profiline/api/v4/useruç noktası üzerinden okuma erişimi verir; bu uç nokta Localtonet'in doldurduğu Kullanıcı bilgisi uç noktasıdır. Oturum açma işleminin istediği tek kapsam budur; bu yüzden uygulamanın başka bir kapsama ihtiyacı yoktur. -
Sağlayıcıyı Localtonet'e ekleyin #
Tünellerim › HTTP sayfasını açın ve sayfanın üstünde SSO düğmesini seçin. SSO sağlayıcıları penceresinde Sağlayıcı ekle düğmesini seçin.
Alan Değer Sağlayıcı adı Herhangi bir ad; örneğin Company GitLab. Onu tünel ayarlarında görürsünüz.Sağlayıcı türü GitLab. Kayıtlı bir sağlayıcının türünü değiştirmek Client ID alanını boşaltır; bu yüzden client ID ve client secret değerlerini yeniden girin. Aktif Açık Client ID GitLab'daki Application ID değeri. Client Secret GitLab'daki Secret değeri. Kaydedildikten sonra asla gösterilmez. Uç noktalar ve callback bölümünü açın. GitLab.com adresleri otomatik olarak doldurulur. Kendi barındırdığınız bir örnek için ilk üç alanda
gitlab.comyerine örneğinizin ana bilgisayar adını yazın.GitLab.com
Alan Doldurulan değer Yetkilendirme uç noktası https://gitlab.com/oauth/authorizeToken uç noktası https://gitlab.com/oauth/tokenKullanıcı bilgisi uç noktası https://gitlab.com/api/v4/userCallback yolu /auth/callback/gitlabKendi barındırdığınız
Alan Girilecek değer Yetkilendirme uç noktası https://<YOUR_GITLAB_HOST>/oauth/authorizeToken uç noktası https://<YOUR_GITLAB_HOST>/oauth/tokenKullanıcı bilgisi uç noktası https://<YOUR_GITLAB_HOST>/api/v4/userCallback yolu /auth/callback/gitlab(değişmez)GitLab uygulamasındaki Redirect URI, 1. adımdaki Localtonet adresi olarak kalır. GitLab ana bilgisayarınızı içermez.
İsterseniz E-posta erişim kuralları bölümünü doldurun, ardından Sağlayıcıyı kaydet düğmesini seçin.
-
Bir tünel için açın #
Tünelleriniz altında tünelde Ayarlar'ı, ardından SSO Sağlayıcıları yanındaki Yönet düğmesini seçin. Tek oturum açma (SSO) penceresinde Girişi zorunlu kıl anahtarını ve GitLab sağlayıcınızın anahtarını açın. Kaydet düğmesini seçin.
GitLab.com'da herkes hesap oluşturabilir. Bir kural olmadan, adresi bilen her GitLab.com kullanıcısı tüneli açabilir. Tünelde Kimler giriş yapabilir bölümünü veya sağlayıcıda İzin verilen e-posta alan adları bölümünü doldurun. Listeler genel bakışta açıklanır.
-
Deneyin #
Tünel URL'sini gizli bir tarayıcı penceresinde açın. Localtonet, sağlayıcınız için bir düğmeyle birlikte Sign in to continue sayfasını gösterir. GitLab ilk seferde sizden uygulamaya yetki vermenizi ister. Ardından tünele geri yönlendirilirsiniz ve hizmetiniz yüklenir.
Sorun giderme #
GitLab, eklenen yönlendirme URI'sinin geçerli olmadığını söylüyor
GitLab uygulamasının hiçbir Redirect URI değeri gönderilen adresle eşleşmiyor. Uygulamanın Redirect URI alanına tam olarak http://auth.localtonet.com/auth/callback girin.
GitLab, istenen kapsamın geçersiz, bilinmeyen veya hatalı biçimli olduğunu söylüyor
İstenen bir kapsam GitLab uygulamasında seçili değil. Uygulamayı düzenleyin ve read_user kapsamını seçin.
GitLab, istemci kimlik doğrulamasının başarısız olduğunu söylüyor
Localtonet'te kayıtlı Client ID veya Client Secret GitLab uygulamasıyla eşleşmiyor. Application ID ve Secret değerlerini yeniden yapıştırın ve Sağlayıcıyı kaydet düğmesini seçin. GitLab'da secret değerini yenilerseniz, yeni secret değerini Localtonet'e kaydedene kadar uygulama çalışmaz.
Kendi barındırdığım örnekle oturum açma hiç tamamlanmıyor
Üç uç noktada yazım hatası olup olmadığını kontrol edin ve örneğin internetten yanıt verdiğinden emin olun. HTTPS kullanıyorsa herkese açık istemcilerin güvendiği bir sertifikaya ihtiyacı vardır. Yalnızca ağınızın içinden erişilebilen bir örnek kullanılamaz.
Başarılı bir GitLab girişinden sonra "403 - Access Denied"
Bir Localtonet kuralı hesabı reddetti. Sağlayıcıdaki E-posta erişim kuralları bölümünü ve tüneldeki Kimler giriş yapabilir bölümünü kontrol edin. Bir kuralı düzelttikten sonra bir dakika bekleyip sayfayı yeniden yükleyin.
Oturum açma sayfasında GitLab düğmesi yok
Sağlayıcı bu tünel için açık değil veya pasif olarak ayarlanmış. İkisini de kontrol edin.