ServicesService· api-gatewayDraft

Verejné API (DMZ)

Jediná služba vystavená do internetu bez akýchkoľvek prihlasovacích údajov — preposiela dva overovacie dopyty na api-internal a nemá dosah na databázu ani na Adaptér.

Certificate Edit

Overview

Envelope identity and kind-specific facts from the entity's spec.

Id: api-public
Version: unversioned
Owners: TPSOFT
Hosting: self
Tags: nextjsdmzintegration
Stateless: yes — safe to reschedule

Neighborhood

This entity and its direct relation partners, as on the operational map.

Full map

Gordulitch Portal API (interné)API · openapi

Integračné API — overenie účastníkaAPI · rest

Interné API (dôveryhodný prijímač)Service · backend

Verejné API (DMZ)Service · api-gateway

Portál a API vrstvaSystem

api-public (Dokploy Compose)Workload

React Flow

Interfaces

This service's contract surface — what it serves, what it calls, and what it puts on the wire.

APIs exposed2

Integračné API — overenie účastníkaintegration-api Gordulitch Portal API (interné)gordulitch-openapi

Relations

Declared spec links and inverses derived from the graph.

Declared here

Callsdeclared1

Interné API (dôveryhodný prijímač)api-internalprotocolhttppaths/api/v1/integration/participants/check, /api/v1/integration/participants/check-batch, /api/v1/_s2s-ready

Exposesdeclared2

Part ofdeclared1

Portál a API vrstvaportal-system

Derived from the graph

Run byderived1

api-public (Dokploy Compose)api-public-compose

Documentation

Markdown texts from services/api-public/docs/ — edited via the CMS or git.

DMZ postoj

dmz.md

DMZ postoj

api-public je jediná služba vystavená do internetu a je zámerne postavená tak, aby jej kompromitácia nedala útočníkovi nič. Nemá prístup k databáze, nemá prístup k Adaptéru a nemá žiadne tajomstvo, ktorým by sa dalo vydávať za používateľa. Jej celý povrch sú štyri operácie a dve z nich len preposielajú dopyt na api-internal, podpísaný krátkodobým service-to-service tokenom.

Preto je to jediná služba v katalógu s stateless: true — nemá ani jeden vzťah k úložisku, čo je presne to, čo táto deklarácia znamená.

Integračné API je poradné, nie brána

Kontrakt integration-api overuje, či je odberateľ registrovaný v Peppole, aby účtovný program vedel, či má faktúru posielať elektronicky. Nie je to podmienka odoslania. Odosielacia cesta si registráciu aj tak dokazuje až pri AS4 skoku a odpoveď nikdy neobsahuje žiadne dáta nájomníka. Kto by z tejto odpovede spravil tvrdú bránu, postavil by rozhodovanie na poradnom údaji.

DMZ postoj

Preto je to jediná služba v katalógu s stateless: true — nemá ani jeden vzťah k úložisku, čo je presne to, čo táto deklarácia znamená.

Integračné API je poradné, nie brána