ondra/colnod-connector
1
0
Fork 1
mirror of https://gitlab.com/spaceti-app/integrations/acs/colnod-connector.git synced 2026-07-12 17:50:37 +02:00
Code Issues Projects Releases Wiki Activity
colnod-connector/README.md

3.9 KiB
Raw Blame History

colnod-connector

Acces Management System of Colsys: Product info

TODO

  • Debug Mode
  • Logs
    • Timestamp
    • Id of record
    • Destination
    • Report
      • Token action to subject_id
      • Sbject action
        • action - updated, deleted, added
  • App output
    • To Colnod
      • Number of tokens added/deleted/updated
    • To DB
      • Number of subjects added/deleted/updated
      • Number of tokens added/deleted/updated

Requirements

  • QPSQL driver must be installed (PostgreSQL)
  • running on Qt 5.9

Qt 5

sudo apt-get install -y build-essential
sudo apt-get install -y qt5-default

PostgreSQL ( devel libs )

sudo apt-get install -y libpq-dev
sudo apt install libqt5sql5-psql # psql driver for Qt

Endpoints

  • POST /AaaManager/authSession

    • Header: Authorization: Basic =4589022lj3.....
    • password: spaceti1 -> sha512 echo spaceti1 | sha512sum
    E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0
    • body:
    {
   "password": "E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0",
       "username": "spaceti"
}
  1. GET request - /SubjectManager/getSubjects - get subjects
  2. GET request - /TokenManager/getTokens - get tokens
  3. POST request - /TokenManager/setTokens - set tokens

RestAPI definitions

  • openapi.yaml ( editor VSCode with Swagger Viewer extension - ⌘+⇧+P Preview Swagger )

Colnod Test server

Colnod server: confluence

  • URL: 192.168.1.3:8843
  • !!! No license!!! - server will shutdown after 8 hours.
    • restart: sudo service cndserver start
    • check nmap -p8443 192.168.1.3 or nc -zvw3 192.168.1.3 8443
    • user: spaceti
    • password: ``
    • sha512: E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0
curl -k --user "spaceti:E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0" -d '{"password":"E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0","username":"spaceti"}' -H "Content-Type: application/json" https://192.168.1.3:8443/AaaManager/authSession

Colnod Penta server

  • Acces through: penta-master IP:172.16.3.4
  • URL: 192.168.254.11:8443
  • Port forwarding: ssh -L 8443:192.168.254.11:8443 penta-master
    • !!! does not work !!!
curl -k --user "spaceti:E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0" -d '{"password":"E7FEA07DBC82FB9BA34B2E453E2EFE89F0583E7187543507EF11E84726071FE428445372F2E46B455EB0C79747C51E362F403CE39473A2A8C2DFA0CE5C9826C0","username":"spaceti"}' -H "Content-Type: application/json" https://192.168.254.11:8443/AaaManager/authSession

Insomnia Rest client

Insomnia Rest

It is possible to chain requests: see doc

  • use token from login response as an Authorization header
  • use id from POST /item in PUT /items/
  • use entire body from one response to upload to another

Import workspace

  • import: Insomnia_2019_10_01.yaml

Testing Blueprint API

Snowboard

Necesarry to allow

  • Self signed certificate: Stack overflow
  • Enable CORS:
    • Safari: Develop->Disable cross origin restrictions

snowboard http -c snowboard.yml --playground colnod.apib

Colnod API snowboard documentation

Install snowboard

npm install -g snowboard