tests: update smoke testing by nabim777 · Pull Request #1011 · nextcloud/integration_openproject

nabim777 · 2026-04-21T03:49:58Z

Description

This PR updates the smoke testing documents.

Related Issue or Workpackage

Fixes <issue_link>

Screenshots (if appropriate):

Types of changes

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)
Tests only (no source changes)

Checklist:

Code changes
Unit tests added
Acceptance tests added
Updated CHANGELOG.md file

Ashim-Stha · 2026-04-24T06:52:34Z

I think it would be good to mention realm-name example as opnc

Ashim-Stha · 2026-04-24T06:55:04Z

should we mention to check I have a discovery endpoint URL as I don't have this information is checked by default and it might be confusing where to put discovery endpoint

Ashim-Stha · 2026-04-24T07:21:05Z

we are following the sequential actions , so do we need to tell to complete those sequential steps?

Ashim-Stha · 2026-04-24T07:21:55Z

as an admin go to

Ashim-Stha · 2026-04-24T08:28:30Z

  - Client secret: Client secret of openproject from keycloak
 - [ ] Login as keycloak-created user in `Openproject`.
 - [ ] Log out, then Login as admin in `Openproject`.
 - [ ] As an `OpenProject` admin, add keycloak-created user as a member in one of the project.


i think we should also add a storage in the project settings -> files in later step

Ashim-Stha · 2026-04-28T06:05:16Z

what about going to the nextcloud, navigate to Administration settings> OpenProject , then put openproject url, select oauth (selected by default) first before copying the credentials

Ashim-Stha · 2026-04-28T06:16:50Z

 - [ ] In `Nextcloud`, navigate to `Personal Settings > Openproject` and click on `Connect to OpenProject` button.
 - [ ] `Nextcloud` admin should be connected as an `OpenProject` admin.
 - [ ] Also, create a user in both `Nextcloud` as well as `OpenProject`.
 - [ ] From the personal section of the created user in `Nextcloud`, connect to `OpenProject`.


login as created user and from the settings -> connect...

Why is it needed?

Ashim-Stha · 2026-04-28T06:19:52Z

 ### A3. Add File storage (Nextcloud) to an OpenProject project
 - [ ] Complete step [Test No A1](#a1-oauth-configuration).
 - [ ] Select an `OpenProject` Project (for example, `Demo Project`) in `OpenProject`.
 - [ ] Navigate to `Project settings > Files` of `Demo Project`.
 - [ ] Add a file storage name `Nextcloud`( choose `No specific Folder` option ) for `Demo Project`.


this action is done by admin, its confusing as in the A2 section, created user is logged in, and this A3 section requires to be logged in as an admin

Ashim-Stha · 2026-04-28T06:20:54Z

@@ -53,5 +54,5 @@
 ### A3. Add File storage (Nextcloud) to an OpenProject project
 - [ ] Complete step [Test No A1](#a1-oauth-configuration).
 - [ ] Select an `OpenProject` Project (for example, `Demo Project`) in `OpenProject`.


Select any project

what is wrong here i don't understand?

Ashim-Stha · 2026-04-28T06:24:00Z

its good to mention in openproject and as an admin

Ashim-Stha · 2026-04-28T06:24:29Z

we have already created user created in above steps

Ashim-Stha · 2026-04-28T06:27:00Z

@@ -67,23 +68,8 @@
 - [ ] Try to connect the created `OpenProject` user as created `Nextcloud` user.


this action is done by created user, so we need to login as created user in both openproject and nextcloud first

The reader will understand that logging in is required to perform this test. So, I think it is clear

would be good to clarify we have to go to the nextcloud as an openproject user -> settings -> openproject -> connect to openproject (we need to be logged in as created user in openproject too)

Ashim-Stha · 2026-04-28T06:30:33Z

we can click on the respective ID rather than double click as double clicking around the text area selects the text which is annoying

Ashim-Stha · 2026-04-28T06:49:22Z

In nextcloud, not in openproject

Ashim-Stha · 2026-04-28T06:49:38Z

in openproject

Ashim-Stha · 2026-04-28T06:53:07Z

in openproject

Ashim-Stha · 2026-04-28T06:57:56Z

rather than saying open the form, search for work package -> create and link a new work package , in nextcloud

Ashim-Stha · 2026-04-28T08:19:22Z


-### 6. Check New folder with automatically managed permissions in OpenProject
+#### 6. Setup and check project folder in Nextcloud (with project folder setup)
+- [ ] Enable `groupfolders` application in `Nextcloud`.


would be good to mention how to enable it in short

Ashim-Stha · 2026-04-28T08:21:11Z

+- [ ] Enable `Automatically managed folders` switch in admin setting and set project folder.
+- [ ] Application password should be generated.


Then copy and paste the generated application password from nextcloud to openproject

Ashim-Stha · 2026-04-28T08:23:12Z


-### 6. Check New folder with automatically managed permissions in OpenProject
+#### 6. Setup and check project folder in Nextcloud (with project folder setup)
+- [ ] Enable `groupfolders` application in `Nextcloud`.


groupfolders or teamfolders?

Ashim-Stha · 2026-04-28T08:23:47Z

-### 6. Check New folder with automatically managed permissions in OpenProject
+#### 6. Setup and check project folder in Nextcloud (with project folder setup)
+- [ ] Enable `groupfolders` application in `Nextcloud`.
+- [ ] Enable `Automatically managed folders` switch in admin setting and set project folder.


in both nextcloud and openproject

Ashim-Stha · 2026-04-28T08:26:13Z

+- [ ] Enable `groupfolders` application in `Nextcloud`.
+- [ ] Enable `Automatically managed folders` switch in admin setting and set project folder.
+- [ ] Application password should be generated.
+- [ ] Verify that `OpenProject` user and group are created with user `OpenProject` as sub-admin of the group.


OpenProject user and OpenProject group

Ashim-Stha · 2026-04-28T08:27:01Z

+- [ ] Application password should be generated.
+- [ ] Verify that `OpenProject` user and group are created with user `OpenProject` as sub-admin of the group.
+- [ ] Verify that `OpenProjectNoAutomaticProjectFolders` group is also created with user `OpenProject` as sub-admin.
+- [ ] Try deleting `OpenProject` user and group, those should not be deleted.


https://github.com/nextcloud/integration_openproject/pull/1011/changes#r3152586787

Ashim-Stha · 2026-04-28T08:28:22Z

+- [ ] Enable `groupfolders` application in `Nextcloud`.
+- [ ] Enable `Automatically managed folders` switch in admin setting and set project folder.
+- [ ] Application password should be generated.
+- [ ] Verify that `OpenProject` user and group are created with user `OpenProject` as sub-admin of the group.


in nextcloud

#### 6. Setup and check project folder in Nextcloud (with project folder setup)

this step heading itself mentioned in nextcloud. so, i don't think we need to again mention here again.

Ashim-Stha · 2026-04-28T08:28:30Z

+- [ ] Enable `Automatically managed folders` switch in admin setting and set project folder.
+- [ ] Application password should be generated.
+- [ ] Verify that `OpenProject` user and group are created with user `OpenProject` as sub-admin of the group.
+- [ ] Verify that `OpenProjectNoAutomaticProjectFolders` group is also created with user `OpenProject` as sub-admin.


in nextcloud

same comment

#1011 (comment)

Ashim-Stha · 2026-04-28T11:25:25Z

these names OIDC Identity Provider and OpenID Connect user backend would be helpful

Ashim-Stha · 2026-04-28T11:26:56Z

+- [ ] Go to `Administation > OpenID Connect Provider`
+  - Click the button `+ Add client`:
+  - Add a client name (not an identifier) such as `openproject`
+  - Add a redirect URL (<openproject_host>/auth/oidc-<idp-displayname-from-OP>/callback)


Suggested change

- Add a redirect URL (<openproject_host>/auth/oidc-<idp-displayname-from-OP>/callback)

- Add a redirect URL (<openproject_host>/auth/oidc-<idp-displayname-from-openproject>/callback)

Ashim-Stha · 2026-04-28T11:31:02Z

 - [ ] Run following command:
  - `php occ config:system:set user_oidc --type boolean --value="true" oidc_provider_bearer_validation`


good to mention its needed for only local setup

may be sometime missing in other setup also

best would be to explain why this command is needed in the first place and what it does

added this:

- Note: This enables bearer token validation for `user_oidc`. Without it, login or connection may fail. This may also be missing during local setups.

Ashim-Stha · 2026-04-28T11:32:22Z


-####  B.1.2. Add Nextcloud IDP in OpenProject
+####  B.1.2. Add Nextcloud IDP in OpenProject (Without project folder setup)
 - [ ] In OpenProject, go to `Administration > Authentication > OpenID providers`


we need to add an Enterprise token before this step

Done! I have mentioned it before starting the sso tests

Ashim-Stha · 2026-04-28T11:48:51Z

 - [ ] In nextcloud, go to `Administration > OpenProject`.
 - [ ] Under `Authentication Method`, select `Single-Sign-On through OpenID Connect Identity Provider`.
 - [ ] In `Authentication settings`, select `provider Type` as `Nextcloud Hub`.
 - [ ] Set Openproject `client ID` by Client ID copied earlier in **Test No B1**.


also uncheck project folder (automatically managed folder).

Ashim-Stha · 2026-04-29T08:44:11Z

 - [ ] `OpenProject` admin is connected to `Nextcloud` as a `Nextcloud` admin.
- [ ] Also, create a user in both `Nextcloud` as well as `OpenProject`.
 - [ ] Add the created `OpenProject` user as the member of `Demo Project` project (admin can add members to a project).
 - [ ] Try to connect the created `OpenProject` user as created `Nextcloud` user.


Suggested change

- [ ] Try to connect the created `OpenProject` user as created `Nextcloud` user.

- [ ] Login as created user in both openproject and nextcloud

- [ ] Try to connect the created `OpenProject` user as created `Nextcloud` user.

Signed-off-by: nabim777 <nabinalemagar019@gmail.com>

github-actions · 2026-05-06T02:18:11Z

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)

Ashim-Stha reviewed Apr 24, 2026

View reviewed changes

Comment thread docs/testing/smoke_testing.md Outdated

Copy link
Copy Markdown

Ashim-Stha Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be good to mention realm-name example as opnc

Ashim-Stha reviewed Apr 24, 2026

View reviewed changes

Comment thread docs/testing/smoke_testing.md Outdated

Copy link
Copy Markdown

Ashim-Stha Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as an admin go to

nabim777 reacted with thumbs up emoji

Ashim-Stha reviewed Apr 24, 2026

View reviewed changes