antony-cloud-office-n8n-nodes

Community node package for Antony Cloud Office.

English

Nodes

• Antony REST — typed operations for known REST endpoints, with form and JSON body modes.
• Antony GraphQL — raw GraphQL execution with schema introspection support.
• Antony Nextcloud — Nextcloud operations not covered by the built-in n8n Nextcloud node.

Authentication uses Keycloak username/password. The credential fetches a Bearer token and sends it with every API call.

Build

npm install
npm run build

Install locally (development)

Option A — pack and install:

npm run build && npm pack
cd ~/.n8n
npm install /path/to/antony-cloud-office-n8n-nodes-0.1.0.tgz

Restart n8n afterwards.

Option B — npm link (live rebuild):

npm run build
npm link

mkdir -p ~/.n8n/custom && cd ~/.n8n/custom
npm init -y
npm link --save antony-cloud-office-n8n-nodes

After each code change run npm run build and restart n8n.

Docker with npm link — the linked project directory must also be mounted into the container:

docker run -d --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -v /path/to/n8nnodes:/home/node/n8nnodes \
  -e N8N_COMMUNITY_PACKAGES_ENABLED=true \
  -e N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom \
  n8nio/n8n

Configure credentials

Create a credential of type Antony API and fill in:

Troubleshooting

• Nodes not showing: run npm run build, restart n8n, check N8N_COMMUNITY_PACKAGES_ENABLED=true.
• Login fails: no trailing slash in Base URL, verify realm/client ID and that password grant is allowed.
• GraphQL introspection fails: test the credential, check that the user has introspection access on /api/v2/graphql.

Deutsch

Nodes

• Antony REST — typisierte Operationen für bekannte REST-Endpunkte, mit Formular- und JSON-Body-Modus.
• Antony GraphQL — direkte GraphQL-Ausführung mit Schema-Introspection.
• Antony Nextcloud — Nextcloud-Operationen, die der eingebaute n8n-Nextcloud-Node nicht abdeckt.

Die Authentifizierung läuft über Keycloak (Benutzername/Passwort). Der Credential holt sich einen Bearer Token und sendet ihn bei jedem API-Aufruf mit.

Build

npm install
npm run build

Lokal installieren (Entwicklung)

Variante A — Pack und Install:

npm run build && npm pack
cd ~/.n8n
npm install /pfad/zu/antony-cloud-office-n8n-nodes-0.1.0.tgz

Danach n8n neu starten.

Variante B — npm link (Live-Rebuild):

npm run build
npm link

mkdir -p ~/.n8n/custom && cd ~/.n8n/custom
npm init -y
npm link --save antony-cloud-office-n8n-nodes

Nach jeder Code-Änderung npm run build ausführen und n8n neu starten.

Docker mit npm link — das verlinkte Projektverzeichnis muss zusätzlich in den Container gemountet werden:

docker run -d --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -v /pfad/zu/n8nnodes:/home/node/n8nnodes \
  -e N8N_COMMUNITY_PACKAGES_ENABLED=true \
  -e N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom \
  n8nio/n8n

Credentials konfigurieren

Credential vom Typ Antony API anlegen und ausfüllen:

Fehlerbehebung

• Nodes erscheinen nicht: npm run build ausführen, n8n neu starten, N8N_COMMUNITY_PACKAGES_ENABLED=true prüfen.
• Login schlägt fehl: Base URL ohne Slash am Ende, Realm und Client ID prüfen, Password Grant im Keycloak-Client aktivieren.
• GraphQL-Introspection schlägt fehl: Credential testen, prüfen ob der Benutzer Introspection-Zugriff auf /api/v2/graphql hat.