RHIDP-9758: Enable GitLab authentication by deerskindoll · Pull Request #1798 · redhat-developer/red-hat-developers-documentation-rhdh

deerskindoll · 2026-02-17T12:48:19Z

IMPORTANT: Do Not Merge - To be merged by Docs Team Only

Version(s):

main, 1.9

Issue:

https://issues.redhat.com/browse/RHIDP-9758

Preview:

themr0c · 2026-02-17T14:18:09Z

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc

+The basic configuration in {product-very-short} requires only a few simple steps.
+
+.Prerequisites
+* You have configured link:https://docs.gitlab.com/api/oauth2/[GitLab OAuth application].


With:

Call back URL = ???

Permissions = ???

themr0c · 2026-02-17T14:20:38Z

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc

+* You have set up link:https://docs.gitlab.com/user/profile/personal_access_tokens/[GitLab personal access tokens].
+* You have set up a link:https://docs.gitlab.com/user/group/[GitLab parent group].
+
+.Procedure


Step 1: Create the Gitlab OAuth application with required parameters: callback URL + permissions.

Step 2: Create OpenShift secrets with the Gitlab related stuff: GITLAB_HOST, GITLAB_CLIENT_ID, GITLAB_CLIENT_SECRET,GITLAB_PARENT_ORG

themr0c · 2026-02-17T14:21:10Z

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc

+* You have set up a link:https://docs.gitlab.com/user/group/[GitLab parent group].
+
+.Procedure
+. Enable the `backstage-plugin-catalog-backend-module-gitlab-org-dynamic` plugin.


snippet explaining as in other authentication procedures

themr0c · 2026-02-17T14:21:40Z

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc

+integrations:
+  gitlab:
+    - host: ${GITLAB_HOST}
+      token: ${GITLAB_TOKEN}
+      apiBaseUrl: https://${GITLAB_HOST}/api/v4
+----


Consider moving it to the integration title.

(with the additional steps: create a PAT in GitLab, Create the Openshift secrets containing the PAT)

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc

themr0c · 2026-02-17T14:55:21Z

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc

+Enter `production` to disable the Guest login option in the {product-short} login page.
+
+`audience`::
+Enter your GitLab instance address: `https://${GITLAB_HOST}`.


Suggested change

Enter your GitLab instance address: `https://${GITLAB_HOST}`.

Enter your GitLab instance address: pass:c,a,q[`https://${GITLAB_HOST}`].

rhdh-bot · 2026-02-17T15:02:36Z

Updated preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-1798/ @ 02/19/26 10:50:44

albarbaro

Nothing wrong with the content itself, but I agree with Fabrice that it can be structured differently: his suggestions make perfect sense.
The moving parts (authentication, ingestion, gitlab app, integration) are mostly the same as Github, so using that same content structure we have for Github would make it more clear.
Details and permissions for the Gitlab App and Token should be in the notes doc attached to the Jira Feature, but if it's not enough or I missed something let me know and I can provide more.

deerskindoll · 2026-02-19T00:11:48Z

@themr0c @albarbaro thank you both! content updated according to your feedback, please take a look

sonarqubecloud · 2026-02-19T10:46:52Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

deerskindoll · 2026-02-19T18:32:34Z

/cherry-pick release-1.9

openshift-cherrypick-robot · 2026-02-19T18:32:37Z

@deerskindoll: once the present PR merges, I will cherry-pick it on top of release-1.9 in a new PR and assign it to you.

Details

In response to this:

/cherry-pick release-1.9

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

pabel-rh · 2026-02-26T05:14:02Z

Created #1839 to make updates in Jana's absence. Hence, closing this PR for now.

deerskindoll added 2 commits February 17, 2026 13:46

RHIDP-9758

65a4a93

RHIDP-9758

482c849

deerskindoll added the Technical review needed 🔩 Test all the procedures label Feb 17, 2026

deerskindoll temporarily deployed to internal February 17, 2026 12:48 — with GitHub Actions Inactive

RHIDP-9758

17ef6f2

deerskindoll temporarily deployed to internal February 17, 2026 12:51 — with GitHub Actions Inactive

RHIDP-9758

d81a042

deerskindoll temporarily deployed to internal February 17, 2026 13:03 — with GitHub Actions Inactive

RHIDP-9758

45f24ce

deerskindoll temporarily deployed to internal February 17, 2026 13:04 — with GitHub Actions Inactive

RHIDP-9758

2a87dc3

deerskindoll temporarily deployed to internal February 17, 2026 13:05 — with GitHub Actions Inactive

RHIDP-9758

40dce3f

deerskindoll temporarily deployed to internal February 17, 2026 13:15 — with GitHub Actions Inactive

RHIDP-9758

c93e1ab

deerskindoll temporarily deployed to internal February 17, 2026 13:33 — with GitHub Actions Inactive

RHIDP-9758

aeb1f7f

deerskindoll temporarily deployed to internal February 17, 2026 13:53 — with GitHub Actions Inactive

RHIDP-9758

c2a8061

deerskindoll temporarily deployed to internal February 17, 2026 14:15 — with GitHub Actions Inactive

themr0c reviewed Feb 17, 2026

View reviewed changes

Merge branch 'main' into RHIDP-9758

6ea1161

deerskindoll temporarily deployed to internal February 17, 2026 14:33 — with GitHub Actions Inactive

RHIDP-9758

2d5e574

deerskindoll temporarily deployed to internal February 17, 2026 14:49 — with GitHub Actions Inactive

themr0c reviewed Feb 17, 2026

View reviewed changes

modules/authentication/proc-enable-user-authentication-with-gitlab-basic.adoc Outdated Show resolved Hide resolved

RHIDP-9758

4ea93b5

deerskindoll temporarily deployed to internal February 17, 2026 14:51 — with GitHub Actions Inactive

themr0c reviewed Feb 17, 2026

View reviewed changes

RHIDP-9758

4431a70

deerskindoll temporarily deployed to internal February 17, 2026 14:59 — with GitHub Actions Inactive

albarbaro reviewed Feb 18, 2026

View reviewed changes

RHIDP-9758

183f2a0

deerskindoll temporarily deployed to internal February 19, 2026 00:11 — with GitHub Actions Inactive

Merge branch 'main' into RHIDP-9758

e2a2f89

deerskindoll temporarily deployed to internal February 19, 2026 00:12 — with GitHub Actions Inactive

Merge branch 'main' into RHIDP-9758

7f74699

deerskindoll temporarily deployed to internal February 19, 2026 10:34 — with GitHub Actions Inactive

deerskindoll added 2 commits February 19, 2026 11:46

RHIDP-9758

cea0af5

RHIDP-9758

83714be

deerskindoll temporarily deployed to internal February 19, 2026 10:46 — with GitHub Actions Inactive

pabel-rh mentioned this pull request Feb 26, 2026

Rhidp 9758: Enable GitLab authentication #1839

Merged

pabel-rh closed this Feb 26, 2026

	Enter your GitLab instance address: `https://${GITLAB_HOST}`.
	Enter your GitLab instance address: pass:c,a,q[`https://${GITLAB_HOST}`].

Conversation

deerskindoll commented Feb 17, 2026

Uh oh!

themr0c Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

themr0c Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

themr0c Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

themr0c Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

themr0c Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

themr0c Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

rhdh-bot commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

albarbaro left a comment

Choose a reason for hiding this comment

Uh oh!

deerskindoll commented Feb 19, 2026

Uh oh!

sonarqubecloud bot commented Feb 19, 2026

Quality Gate passed

Uh oh!

deerskindoll commented Feb 19, 2026

Uh oh!

openshift-cherrypick-robot commented Feb 19, 2026

Uh oh!

pabel-rh commented Feb 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

rhdh-bot commented Feb 17, 2026 •

edited

Loading