Skip to content

Commit 7ad9081

Browse files
SagarGiSagarGi
committed
Added manaul installation of external app as openproject
Signed-off-by: Sagar <sagargurung1001@gmail.com>
1 parent 2958a3a commit 7ad9081

File tree

3 files changed

+287
-17
lines changed

3 files changed

+287
-17
lines changed

‎README.md‎

Lines changed: 107 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,107 @@
1-
# Nextcloud-OpenProject-App repository
1+
# OpenProject as Nextcloud's External App
2+
3+
## Manual Installation
4+
For the manual installation of `OpenProject` as an external application of `Nextcloud`, make sure that your `Nextcloud` as well as `OpenProject` instance is up and running.
5+
6+
### 1. Install `app_api` application
7+
8+
Assuming you’re in the apps folder of Nextcloud with command git:
9+
10+
- Clone
11+
```bash
12+
https://github.com/cloud-py-api/app_api.git
13+
```
14+
- build
15+
```bash
16+
cd app_api
17+
npm ci && npm run dev
18+
```
19+
- Enable the `app_api`
20+
21+
```bash
22+
# Assuming you’re in nextcloud server root directory
23+
sudo -u www-data php occ a:e app_api
24+
```
25+
26+
### 2. Register deploy daemons (In Nextcloud)
27+
28+
- Navigate to `Administration Settings > AppAPI`
29+
- Click register daemons
30+
- Select `Manual Install` for Daemon configuration template
31+
- Put `manual_install` for name and display name
32+
- Deployment method as `manual-install`
33+
- Daemon host as `localhost`
34+
- Click Register
35+
36+
### 3. Running OpenProject locally
37+
Set up and build `OpenProject` locally following [OpenProject Development Setup](https://www.openproject.org/docs/development/development-environment/)
38+
After the setup, run `OpenProject` locally with the given command line.
39+
40+
>NOTE: while running the below bash command line for `NC_SUB_FOLDER` put the sub folder path if you are running nextcloud in a sub folder else do remove it.
41+
42+
```bash
43+
OPENPROJECT_AUTHENTICATION_GLOBAL__BASIC__AUTH_USER=apiadmin \
44+
OPENPROJECT_AUTHENTICATION_GLOBAL__BASIC__AUTH_PASSWORD=apiadmin \
45+
OPENPROJECT_RAILS__RELATIVE__URL__ROOT=/<NC_SUB_FOLDER>/index.php/apps/app_api/proxy/openproject-nextcloud-app \
46+
OPENPROJECT_2FA_DISABLED=false \
47+
foreman start -f Procfile.dev
48+
```
49+
50+
### 4. Configure and Run External `openproject-nextcloud-app` application
51+
Assuming you’re in the apps folder of Nextcloud with command git:
52+
53+
- Clone
54+
```bash
55+
https://github.com/JankariTech/openproject-nextcloud-app.git
56+
```
57+
- Configure script before running external app
58+
```bash
59+
cd openproject-nextcloud-app
60+
cp ex_app_run_script.sh.example ex_app_run_script.sh
61+
```
62+
Once you have copied the script to run the external application, configure the following environments
63+
64+
- APP_ID is the application id of the external app
65+
- APP_PORT is port for the external app
66+
- APP_HOST is the host for the external app
67+
- APP_SECRET is the secret required for the communication between external app and nextcloud
68+
- APP_VERSION is the version of external app
69+
- AA_VERSION is the app_api version used
70+
- EX_APP_VERSION is the version of external app
71+
- EX_APP_ID is the application id of the external app
72+
- NC_SUB_FOLDER is the subfolder in which nextcloud is running (make sure to use same in OPENPROJECT_RAILS__RELATIVE__URL__ROOT while running openproject)
73+
- OP_BACKEND_URL is the url in which `OpenProject` is up and running
74+
- NEXTCLOUD_URL the url in which `Nextcloud` is up and running
75+
76+
- Run external application with the script
77+
```bash
78+
bash ex_app_run_script.sh
79+
```
80+
81+
### 2. Register and deploy external application `openproject-nextcloud-app` in Nextcloud's external apps
82+
83+
Assuming you’re in nextcloud server root directory
84+
85+
- Register and deploy external application `openproject-nextcloud-app`
86+
```bash
87+
sudo -u www-data php occ app_api:app:register openproject-nextcloud-app manual_install --json-info \
88+
"{\"id\":\"<EX_APP_ID>\",
89+
\"name\":\"<EX_APP_ID>\",
90+
\"daemon_config_name\":\"manual_install\",
91+
\"version\":\"<EX_APP_VERSION>\",
92+
\"secret\":\"<APP_SECRET>\",
93+
\"scopes\":[\"ALL\"],
94+
\"port\":<APP_PORT>,
95+
\"routes\": [{\"url\":\".*\",\"verb\":\"GET, POST, PUT, DELETE, HEAD, PATCH, OPTIONS, TRACE\",
96+
\"access_level\":1,
97+
\"headers_to_exclude\":[]}]}" \
98+
--force-scopes --wait-finish
99+
```
100+
In the above bash command use the same value for `EX_APP_ID`, `EX_APP_VERSION`, `APP_SECRET`, and `APP_PORT` used while running external applicaiton `openproject-nextcloud-app`
101+
102+
103+
Upon successful running , register and deploy of the external application `openproject-nextcloud-app`, the external application can be accessed with the url:
104+
```bash
105+
http://${APP_HOST}/${NC_SUB_FOLDER}/index.php/apps/app_api/proxy/openproject-nextcloud-app
106+
```
107+

‎ex_app_run_script.sh.example‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
#!/bin/bash
2+
3+
export APP_ID="openproject-nextcloud-app"
4+
export APP_PORT="9030"
5+
export APP_HOST="localhost"
6+
export APP_SECRET="<app-secret>"
7+
export APP_VERSION="<ex-app-version>"
8+
export AA_VERSION="<app-api-version>"
9+
export EX_APP_VERSION="<ex-app-version>"
10+
export EX_APP_ID="openproject-nextcloud-app"
11+
export NC_SUB_FOLDER="<nc-sub-folder-path>"
12+
export OP_BACKEND_URL="http://<openproject-host>:<openproject-port>/${NC_SUB_FOLDER}/index.php/apps/app_api/proxy/openproject-nextcloud-app"
13+
export NEXTCLOUD_URL="http://${APP_HOST}/${NC_SUB_FOLDER}/index.php"
14+
15+
python3.10 lib/main.py

‎lib/main.py‎

Lines changed: 165 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,184 @@
1-
"""Simplest example."""
2-
1+
import typing
2+
import httpx
3+
import os
4+
from urllib.parse import urlparse, parse_qs
5+
import urllib.parse
6+
from urllib.parse import urlencode
7+
import json
8+
from starlette.responses import Response, JSONResponse
39
from contextlib import asynccontextmanager
4-
5-
from fastapi import FastAPI
10+
from fastapi import FastAPI, Request, BackgroundTasks, Depends
11+
from fastapi.middleware.cors import CORSMiddleware
612
from nc_py_api import NextcloudApp
7-
from nc_py_api.ex_app import AppAPIAuthMiddleware, LogLvl, run_app, set_handlers
13+
from nc_py_api.ex_app import AppAPIAuthMiddleware, LogLvl, run_app, nc_app
14+
from nc_py_api.ex_app.integration_fastapi import fetch_models_task
815

916

1017
@asynccontextmanager
1118
async def lifespan(app: FastAPI):
12-
set_handlers(app, enabled_handler)
1319
yield
1420

1521

1622
APP = FastAPI(lifespan=lifespan)
17-
APP.add_middleware(AppAPIAuthMiddleware) # set global AppAPI authentication middleware
23+
APP.add_middleware(AppAPIAuthMiddleware)
24+
APP.add_middleware(
25+
CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"]
26+
)
1827

1928

2029
def enabled_handler(enabled: bool, nc: NextcloudApp) -> str:
21-
# This will be called each time application is `enabled` or `disabled`
22-
# NOTE: `user` is unavailable on this step, so all NC API calls that require it will fail as unauthorized.
23-
print(f"enabled={enabled}")
30+
print(f"{nc.app_cfg.app_name}={enabled}")
2431
if enabled:
25-
nc.log(LogLvl.WARNING, f"Hello from {nc.app_cfg.app_name} :)")
32+
nc.log(LogLvl.INFO, f"{nc.app_cfg.app_name} is enabled")
2633
else:
27-
nc.log(LogLvl.WARNING, f"Bye bye from {nc.app_cfg.app_name} :(")
28-
# In case of an error, a non-empty short string should be returned, which will be shown to the NC administrator.
34+
nc.log(LogLvl.INFO, f"{nc.app_cfg.app_name} is disabled")
2935
return ""
3036

3137

38+
@APP.get("/heartbeat")
39+
async def heartbeat_callback():
40+
return JSONResponse(content={"status": "ok"})
41+
42+
43+
@APP.post("/init")
44+
async def init_callback(
45+
b_tasks: BackgroundTasks, nc: typing.Annotated[NextcloudApp, Depends(nc_app)]
46+
):
47+
b_tasks.add_task(fetch_models_task, nc, {}, 0)
48+
return JSONResponse(content={})
49+
50+
51+
@APP.put("/enabled")
52+
async def enabled_callback(
53+
enabled: bool, nc: typing.Annotated[NextcloudApp, Depends(nc_app)]
54+
):
55+
return JSONResponse(content={"error": enabled_handler(enabled, nc)})
56+
57+
58+
@APP.api_route(
59+
"/{path:path}", methods=["GET", "POST", "PUT", "DELETE", "HEAD", "PATCH", "OPTIONS"]
60+
)
61+
async def proxy_Requests(_request: Request, path: str):
62+
response = await proxy_request_to_server(_request, path)
63+
64+
headers = dict(response.headers)
65+
headers.pop("transfer-encoding", None)
66+
headers.pop("content-encoding", None)
67+
headers["content-length"] = str(response.content.__len__())
68+
headers["content-security-policy"] = (
69+
"default-src * 'unsafe-inline' 'unsafe-eval' data: blob:;"
70+
)
71+
72+
return Response(
73+
content=response.content,
74+
status_code=response.status_code,
75+
headers=headers,
76+
)
77+
78+
79+
async def proxy_request_to_server(request: Request, path: str):
80+
async with httpx.AsyncClient(follow_redirects=False) as client:
81+
backend_url = get_backend_url()
82+
url = f"{backend_url}/{path}"
83+
headers = {}
84+
for k, v in request.headers.items():
85+
# NOTE:
86+
# - remove 'host' to make op routes work
87+
# - remove 'origin' to validate csrf
88+
if k == "host" or k == "origin":
89+
continue
90+
headers[k] = v
91+
92+
if request.method == "GET":
93+
params=request.query_params
94+
# A referrer header is required when we request to '/work_packages/menu' enpoint
95+
# Currently the browser does not provide the referer header so it has been put through proxy
96+
# Also it works even referrer is empty
97+
if url.endswith("/work_packages/menu"):
98+
headers.update({'referer': ''})
99+
100+
if "/project_storages/new" in url :
101+
# when requesting the storate_id is stripped in the proxy (issue: https://github.com/cloud-py-api/app_api/issues/384).
102+
# This piece of code modifies the query param to add missing storage_id.
103+
query_params = dict(params)
104+
if 'storages_project_storage[]' in query_params:
105+
value = query_params['storages_project_storage[]']
106+
new_key = 'storages_project_storage[storage_id]'
107+
query_params[new_key] = value
108+
del query_params['storages_project_storage[]']
109+
params = urlencode(query_params, doseq=True)
110+
response = await client.get(
111+
url,
112+
params=params,
113+
headers=headers,
114+
)
115+
else:
116+
# for getting oauth token the content-type 'application/x-www-form-urlencoded' sems to be required
117+
if request.method == 'POST' and "/oauth/token" in url:
118+
headers.update({'content-type': 'application/x-www-form-urlencoded'})
119+
response = await client.request(
120+
method=request.method,
121+
url=url,
122+
params=request.query_params,
123+
headers=headers,
124+
content=await request.body(),
125+
)
126+
127+
128+
if response.is_redirect and not response.status_code == 304:
129+
if "location" in response.headers and "proxy/openproject-nextcloud-app" in response.headers["location"]:
130+
redirect_path = urlparse(response.headers["location"]).path
131+
redirect_url = get_nc_url() + redirect_path
132+
response.headers["location"] = redirect_url
133+
response.status_code = 200
134+
elif "oauth/authorize" in url:
135+
response.headers["location"] = response.headers["location"]
136+
elif "apps/oauth2/authorize" in response.headers["location"]:
137+
response.headers["location"] = response.headers["location"]
138+
response.status_code = 200
139+
else:
140+
headers["content-length"] = "0"
141+
response = await handle_redirects(
142+
client,
143+
request.method if response.status_code == 307 else "GET",
144+
response.headers["location"],
145+
headers,
146+
)
147+
return response
148+
149+
150+
async def handle_redirects(
151+
client: httpx.AsyncClient,
152+
method: str,
153+
url: str,
154+
headers: dict,
155+
):
156+
response = await client.request(
157+
method=method,
158+
url=url,
159+
headers=headers,
160+
)
161+
162+
if response.is_redirect:
163+
return await handle_redirects(
164+
client,
165+
method if response.status_code == 307 else "GET",
166+
response.headers["location"],
167+
headers,
168+
)
169+
170+
return response
171+
172+
173+
def get_backend_url():
174+
return os.getenv("OP_BACKEND_URL", "http://localhost:3000")
175+
176+
177+
def get_nc_url():
178+
nc_url = os.getenv("NEXTCLOUD_URL", "http://localhost/index.php")
179+
url = urlparse(nc_url)
180+
return f"{url.scheme}://{url.netloc}"
181+
182+
32183
if __name__ == "__main__":
33-
# Wrapper around `uvicorn.run`.
34-
# You are free to call it directly, with just using the `APP_HOST` and `APP_PORT` variables from the environment.
35-
run_app("main:APP", log_level="trace")
184+
run_app("main:APP", log_level="trace")

0 commit comments

Comments
 (0)