Logování a ladění Web API
Běh FLORES API je možné logovat. A to jednak jeho Java část pomocí konfiguračního souboru YAML, který používá daná instance, a pak dále na úrovni business logiky pomocí souboru NEXUS.CFG. Při spuštění se do logu zaznamená název instance a cesta k použitému konfiguračnímu souboru.
Součástí obou logů je tzv rid, generované pomocí hlavičky X-Request-ID, které umožňuje snadno identifikovat jak serverovou, tak BO část požadavku v obou takto vytvořených lozích.
Obecná konfigurace nastavení logování systému ABRA Flores viz kap. Logování běhu aplikace.
Doporučená konfigurace nastavení logování na úrovni v souboru NEXUS.CFG (od verze 22) je následující:
[Logs]
LogsDirectory=<lokální cesta, ideálně SSD>
Level=3
[Log.ExceptionHook]
Enabled=1
Level=6
ExcludedExceptionClasses=EAbort;NxHiddenError;EIdSocketError;EIdConnectTimeout;EIdNotASocket
ExcludedNxErrorCodes=
[Log.SysLog]
Enabled=1
Level=6
[Log.ProfilingSQL]
Enabled=0
Level=6
Threshold=1000
SQLOutputLength=0
[Log.WA~Monitoring]
Enabled=1
Level=6
[Log.WA/RESTApplication]
Enabled=1
Level=6
[Log.WA/RESTApplication/Security]
Enabled=1
Level=6
[Log.WA/RESTApplication/ProfilingRequest]
Enabled=1
Level=6
SQLText=1
SQLPlan=1
[Log.WA/RESTApplication/Pool]
Enabled=0
Level=6
[Log.WA/RESTApplication/Memory]
Enabled=0
Level=6
Log ExceptionHook slouží k logování výjimek, je jediný který stojí za to mít zapnutý pořád. Ostatní logy je z důvodu výkonu a rychle rostoucí velikosti souboru s logy mít během provozu vypnuté a zapnout je dle příkladu až při potřebě.
Pokud je třeba v logu výjimek vypsat všechny výjimky (včetně EAbort atd.), je nutné v sekci [Log.ExceptionHook] explicitně vyprázdnit seznamy vyloučených tříd a chybových kódů (jinak se použijí interní přednastavené hodnoty):
ExcludedNxErrorCodes=
ExcludedExceptionClasses=
Pokud je třeba omezit celé logování pouze na procesy provádějící API dotazy, doplňte do hlavní sekce [Logs] parametr AllowedApps:
AllowedApps=java.
Log SysLog loguje informace ze startu aplikace (tj. s jakými parametry byl program spuštěný, nastavení některých interních proměnný a pod.).
Log Profilingsql na aplikačním serveru loguje SQL dotazy, které překročí nastavený čas. Použitím tohoto logu se dá zjistit, jestli za případnou pomalostí API dotazů nestojí databáze. Threshold je čas v ms, při jehož překročení se dotaz zaloguje. SQLOutputLength je délka SQL dotazu, která se zaloguje, 0 znamená celý dotaz.
Log WA/RESTApplication/ProfilingRequest je nejdůležitější. Je v něm zahrnut buď obsah požadavku i odpověď (Level=6) nebo jen základní informace bez těla požadavku a odpovědi (Level=5). V případě, že provádění požadavku zamrzne, loguje se zde callstack threadu, který požadavek provádí a může napovědět, kde je problém. Od verze 24.1 je log WA/RESTApplication/ProfilingRequest upraven tak, že logování SQL generovaného API se provádí explicitním zapnutím přepínače SQLText=1 a nově je možné zalogovat i SQL plán pomocí SQLPlan=1. Obojí funguje pouze při nastavení Level=6. SQL plán se nebere přímo z prováděného dotazu, ale požádá se o něj databázový engine v separátním dotazu (implementování na základě informace z AbraBI). Při ladění problémů s rychlostí SQL je doporučeno logování zapnout a vyhodnotit, viz příklady níže.
Log WA/RESTApplication/Security umožňuje zjistit, které chráněné objekty byly použity pro získání dat požadavku a tudíž se hodí použít pro řešení problému s právy k objektům.
Příklad volání metody GET pro doklad faktury vydané: GET http://localhost/develop/issuedinvoices, uživatel nemá správně nastavena práva ke chráněným objektům
26.03.2025 11:57:42.847 [5] 00005CF0 (WAProfilingRequest) Request start(rid:API_b144e5342e5d46fe9049cb1494728cb2): GET http://localhost/develop/issuedinvoices
X-Request-ID=API_b144e5342e5d46fe9049cb1494728cb2
User-Agent=PostmanRuntime/7.43.2
Host=localhost
Connection=keep-alive
Accept=*/*
Accept-Encoding=gzip, deflate, br
Postman-Token=20da25f8-eaa4-40ea-b696-f7150f496ce7
26.03.2025 11:57:42.875 [5] 00005CF0 (WASecurity) Add security condition: Field IssuedInvoices.DocQueue_ID(Zdrojová řada)
Allowed IDs: 5600000101,
26.03.2025 11:57:42.877 [5] 00005CF0 (WASecurity) Add security condition: Field IssuedInvoices.AccDocQueue_ID(ÃšÄ etnà řada)
Allowed IDs: No ID is allowed !!!
26.03.2025 11:57:42.879 [5] 00005CF0 (WASecurity) Add security condition: Field IssuedInvoices.BankAccount_ID(VlastnÃ ÃºÄ et)
Allowed IDs: 2200000101,
26.03.2025 11:57:42.881 [5] 00005CF0 (WASecurity) Add security condition: Field Rows.Division_ID(Středisko)
Allowed IDs: 2100000101,1200000101,2200000101,1300000101,1400000101,2400000101,3400000101,
26.03.2025 11:57:42.884 [5] 00005CF0 (WASecurity) Add security condition: Field Rows.Store_ID(Sklad)
Allowed IDs: 2100000101,1500000101,2500000101,3500000101,
26.03.2025 11:57:42.886 [6] 00005CF0 (WAProfilingRequest)
Start read sql - InputParams: @{SelDocQueue_ID1Frag}=('5600000101');@{SelBankAccount_ID3Frag}=('2200000101');@{SelRowsDivision_ID4Frag}=('1300000101','1400000101','3400000101','2400000101','2200000101','1200000101','2100000101');@{SelRowsStore_ID5Frag}=('1500000101','2500000101','3500000101','2100000101');@{$IndexAndWhere}=;
select T_1.AccDocQueue_ID as F_1$REFERENCE, T_1.AccPresetDef_ID as F_2$REFERENCE, T_1.Address_ID as F_3$REFERENCE, T_1.BankAccount_ID as F_4$REFERENCE, T_1.ClosingPeriod_ID as F_5$REFERENCE, T_1.ConstSymbol_ID as F_6$REFERENCE, T_1.CorrectedBy_ID as F_7$REFERENCE, T_1.Country_ID as F_8$REFERENCE, T_1.CreatedBy_ID as F_9$REFERENCE, T_1.Currency_ID as F_10$REFERENCE, T_1.DealerCategory_ID as F_11$REFERENCE, T_1.DeliveryAddress_ID as F_12$REFERENCE, T_1.DeliveryFirm_ID as F_13$REFERENCE, T_1.DeliveryFirmOffice_ID as F_14$REFERENCE, T_1.DeliveryTerms_ID as F_15$REFERENCE, T_1.DocQueue_ID as F_16$REFERENCE, T_1.Firm_ID as F_17$REFERENCE, T_1.FirmOffice_ID as F_18$REFERENCE, T_1.ID as ID, T_1.IEState_ID as F_19$REFERENCE, T_1.IntrastatDeliveryTerm_ID as F_20$REFERENCE, T_1.IntrastatTransactionType_ID as F_21$REFERENCE, T_1.IntrastatTransportationType_ID as F_22$REFERENCE, T_1.LastPaymentPeriod_ID as F_23$REFERENCE, T_1.LocalZone_ID as F_24$REFERENCE, T_1.ObjVersion as ObjVersion, T_1.PaymentType_ID as F_25$REFERENCE, T_1.Period_ID as F_26$REFERENCE, T_1.Person_ID as F_27$REFERENCE, T_1.PostAddress_ID as F_28$REFERENCE, T_1.PostFirm_ID as F_29$REFERENCE, T_1.PostFirmOffice_ID as F_30$REFERENCE, T_1.TransportationType_ID as F_31$REFERENCE, T_1.VATCountry_ID as F_32$REFERENCE, T_1.Zone_ID as F_33$REFERENCE
from IssuedInvoices T_1
where ((T_1.DocQueue_ID IN {SelDocQueue_ID1Frag})) and (((T_1.AccDocQueue_ID IS NULL) OR (T_1.AccDocQueue_ID = '0000000000') OR (T_1.AccDocQueue_ID = ' '))) and ((T_1.BankAccount_ID IN {SelBankAccount_ID3Frag})) and ((EXISTS(SELECT 1 FROM IssuedInvoices2 T_2 WHERE T_2.Parent_ID =T_1.ID AND ((Division_ID IS NULL) OR (Division_ID = '0000000000') OR (Division_ID = ' ') OR (Division_ID IN {SelRowsDivision_ID4Frag})) AND ((Store_ID IS NULL) OR (Store_ID = '0000000000') OR (Store_ID = ' ') OR (Store_ID IN {SelRowsStore_ID5Frag}))) OR Not EXISTS(SELECT 1 FROM IssuedInvoices2 T_2 WHERE T_2.Parent_ID =T_1.ID)))
26.03.2025 11:57:42.892 [6] 00005CF0 (WAProfilingRequest) Stop read sql duration: 16 ms
26.03.2025 11:57:42.893 [5] 00005CF0 (WAProfilingRequest) Request stop(rid:API_b144e5342e5d46fe9049cb1494728cb2): status 200 time: 0 ms
Link=http://localhost:80/develop/api-docs/openapi#; rel="describedBy"
Content-Type=application/json
Access-Control-Allow-Credentials=true
Access-Control-Allow-Origin=*
Access-Control-Allow-Headers=Origin, X-Requested-With, Content-Type, Accept, Authorization, Cache-Control
Access-Control-Allow-Methods=GET,PUT,POST,DELETE
[]
Logy WA/RESTApplication/Pool a WA/RESTApplication/Memory jsou nízkoúrovňové a jejich zapnutí má smysl jen při řešení specifických problémů.
Při vyčerpání kapacity interního poolu API se do logu výjimek zapíše výjimka EPoolLimitExceeded. Hláška obsahuje název poolu a údaje, které pomáhají rozlišit nárazové zatížení od dlouho obsazených nebo neuvolněných prostředků.
Byla vyčerpána maximální kapacita poolu auth-connections (limit 200). Nejdelší obsazení: 8 s. Neuvolněných míst: 47.
-
Název poolu, například auth-connections, označuje část API, ve které k vyčerpání kapacity došlo.
-
Limit udává maximální počet současně obsazených míst v poolu.
-
Nejdelší obsazení udává, jak dlouho je obsazeno nejdéle používané aktivní místo.
-
Neuvolněných míst udává počet prostředků držených déle, než je povolená doba. Tato místa již nebrání vytvoření náhradních prostředků, jejich výskyt však může ukazovat na nedokončené nebo zablokované zpracování.
Krátká doba obsazení bez neuvolněných míst obvykle ukazuje na nárazové zatížení. Dlouhá doba obsazení nebo rostoucí počet neuvolněných míst může ukazovat na problém při zpracování požadavků.
Jak je popsáno výše v sekci o logu WA/RESTApplication/ProfilingRequest, od verze 24.1 je pro logování SQL dotazů a jejich plánů nutné explicitně zapnout parametry SQLText=1 a SQLPlan=1 (při Level=6):
[Log.WA/RESTApplication/ProfilingRequest]
Enabled=1
Level=6
SQLText=1
SQLPlan=1
Start read sql - InputParams: @{SelDivision_IDFrag}=('1300000101','1400000101','3400000101','2400000101','2200000101','1200000101','2100000101');@{SelStore_IDFrag}=('1300000101','2600000101','3400000101','1600000101','3200000101','4400000101','1500000101','2500000101','3500000101','2300000101','3300000101','2100000101');@{$IndexAndWhere}=;
select T_1.StoreCard_ID as F_1$REFERENCE, T_1.Store_ID as F_2$REFERENCE, sum(T_1.Quantity) as F_3, sum(T_1.DeliveredQuantity) as F_4, T_1.StoreCard_ID as F_5, T_1.Store_ID as F_6
from ReceivedOrders2 T_1
left join ReceivedOrders T_2 on T_2.ID = T_1.Parent_ID
where (T_1.Store_ID in ('2100000101', '2200000101') and T_1.RowType = 3 and T_2.Confirmed = 'A' and T_2.Closed = 'N' and T_1.Quantity > T_1.DeliveredQuantity) and (((T_1.Division_ID IS NULL) OR (T_1.Division_ID = '0000000000') OR (T_1.Division_ID = ' ') OR (T_1.Division_ID IN {SelDivision_IDFrag}))) and (((T_1.Store_ID IS NULL) OR (T_1.Store_ID = '0000000000') OR (T_1.Store_ID = ' ') OR (T_1.Store_ID IN {SelStore_IDFrag})))
group by F_5, F_6
SQL plan: PLAN JOIN (T_1 ORDER RECEIVEDORDERS2_SCARD INDEX (RECEIVEDORDERS2STOREFK, RECEIVEDORDERS2STOREFK), T_2 INDEX (RECEIVEDORDERSPK))
Start read sql - InputParams: @{SelDivision_IDFrag}=('1300000101','1400000101','3400000101','2400000101','2200000101','1200000101','2100000101');@{SelStore_IDFrag}=('1300000101','2600000101','1600000101','3400000101','3200000101','4400000101','1500000101','2500000101','3500000101','2300000101','3300000101','2100000101');@{$IndexAndWhere}=;
select T_1.StoreCard_ID as F_1$REFERENCE, T_1.Store_ID as F_2$REFERENCE, sum(T_1.Quantity) as F_3, sum(T_1.DeliveredQuantity) as F_4, T_1.StoreCard_ID as F_5, T_1.Store_ID as F_6
from ReceivedOrders2 T_1
join ReceivedOrders T_2 on T_2.ID = T_1.Parent_ID
where (T_1.Store_ID in ('2100000101', '2200000101') and T_1.RowType = 3 and T_2.Confirmed = 'A' and T_2.Closed = 'N' and T_1.Quantity > T_1.DeliveredQuantity) and (((T_1.Division_ID IS NULL) OR (T_1.Division_ID = '0000000000') OR (T_1.Division_ID = ' ') OR (T_1.Division_ID IN {SelDivision_IDFrag}))) and (((T_1.Store_ID IS NULL) OR (T_1.Store_ID = '0000000000') OR (T_1.Store_ID = ' ') OR (T_1.Store_ID IN {SelStore_IDFrag})))
group by T_1.StoreCard_ID, T_1.Store_ID
SQL plan: |--Stream Aggregate(GROUP BY:([T_1].[StoreCard_ID]) DEFINE:([Expr1002]=SUM([toho].[dbo].[ReceivedOrders2].[Quantity] as [T_1].[Quantity]), [Expr1003]=SUM([toho].[dbo].[ReceivedOrders2].[DeliveredQuantity] as [T_1].[DeliveredQuantity]), [T_1].[Store_ID]=ANY([toho].[dbo].[ReceivedOrders2].[Store_ID] as [T_1].[Store_ID])))
|--Sort(ORDER BY:([T_1].[StoreCard_ID] ASC))
|--Nested Loops(Inner Join, OUTER REFERENCES:([T_1].[Parent_ID]))
|--Clustered Index Scan(OBJECT:([toho].[dbo].[ReceivedOrders2].[ReceivedOrders2PK] AS [T_1]), WHERE:([toho].[dbo].[ReceivedOrders2].[RowType] as [T_1].[RowType]=(3) AND [toho].[dbo].[ReceivedOrders2].[Quantity] as [T_1].[Quantity]>[toho].[dbo].[ReceivedOrders2].[DeliveredQuantity] as [T_1].[DeliveredQuantity] AND [toho].[dbo].[ReceivedOrders2].[Store_ID] as [T_1].[Store_ID]='2100000101' AND ([toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]=' ' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='0000000000' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='1200000101' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='1300000101' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='1400000101' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='2100000101' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='2200000101' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='2400000101' OR [toho].[dbo].[ReceivedOrders2].[Division_ID] as [T_1].[Division_ID]='3400000101')))
|--Clustered Index Seek(OBJECT:([toho].[dbo].[ReceivedOrders].[ReceivedOrdersPK] AS [T_2]), SEEK:([T_2].[ID]=[toho].[dbo].[ReceivedOrders2].[Parent_ID] as [T_1].[Parent_ID]), WHERE:([toho].[dbo].[ReceivedOrders].[Confirmed] as [T_2].[Confirmed]='A' AND [toho].[dbo].[ReceivedOrders].[Closed] as [T_2].[Closed]='N') ORDERED FORWARD)
Start read sql - InputParams: @{SelDivision_IDFrag}=('1300000101','1400000101','3400000101','2400000101','2200000101','1200000101','1500000101','2100000101');@{SelStore_IDFrag}=('1620000101','1600000101','3200000101','4400000101','2300000101','3300000101','1300000101','2600000101','3400000101','1500000101','2500000101','3500000101','2100000101');@{$IndexAndWhere}=;
select T_1.StoreCard_ID as F_1$REFERENCE, T_1.Store_ID as F_2$REFERENCE, sum(T_1.Quantity) as F_3, sum(T_1.DeliveredQuantity) as F_4, T_1.StoreCard_ID as F_5, T_1.Store_ID as F_6
from ReceivedOrders2 T_1
join ReceivedOrders T_2 on T_2.ID = T_1.Parent_ID
where (T_1.Store_ID in ('2100000101', '2200000101') and T_1.RowType = 3 and T_2.Confirmed = 'A' and T_2.Closed = 'N' and T_1.Quantity > T_1.DeliveredQuantity) and (((T_1.Division_ID IS NULL) OR (T_1.Division_ID = '0000000000') OR (T_1.Division_ID = ' ') OR (T_1.Division_ID IN {SelDivision_IDFrag}))) and (((T_1.Store_ID IS NULL) OR (T_1.Store_ID = '0000000000') OR (T_1.Store_ID = ' ') OR (T_1.Store_ID IN {SelStore_IDFrag})))
group by T_1.StoreCard_ID, T_1.Store_ID
SQL plan: Plan hash value: 2830092148
---------------------------------------------------------------------------------------------------------------
| Id | Operation | Name | Rows | Bytes | Cost (%CPU)| Time |
---------------------------------------------------------------------------------------------------------------
| 0 | SELECT STATEMENT | | 1 | 64 | 6 (17)| 00:00:01 |
| 1 | HASH GROUP BY | | 1 | 64 | 6 (17)| 00:00:01 |
| 2 | NESTED LOOPS | | 1 | 64 | 5 (0)| 00:00:01 |
| 3 | NESTED LOOPS | | 4 | 64 | 5 (0)| 00:00:01 |
|* 4 | TABLE ACCESS FULL | RECEIVEDORDERS | 1 | 15 | 4 (0)| 00:00:01 |
|* 5 | INDEX RANGE SCAN | IX_WS4K5TC4FSM43JGFVBMIIWSEXK | 4 | | 0 (0)| 00:00:01 |
|* 6 | TABLE ACCESS BY INDEX ROWID| RECEIVEDORDERS2 | 2 | 98 | 1 (0)| 00:00:01 |
---------------------------------------------------------------------------------------------------------------
Predicate Information (identified by operation id):
---------------------------------------------------
4 - filter("T_2"."CONFIRMED"='A' AND "T_2"."CLOSED"='N')
5 - access("T_2"."ID"="T_1"."PARENT_ID")
6 - filter("T_1"."QUANTITY">"T_1"."DELIVEREDQUANTITY" AND "T_1"."ROWTYPE"=3 AND ("T_1"."STORE_ID"
IS NULL OR "T_1"."STORE_ID"='2100000101') AND ("T_1"."STORE_ID"='2100000101' OR
"T_1"."STORE_ID"='2200000101') AND ("T_1"."DIVISION_ID"=' ' OR "T_1"."DIVISION_ID"='0000000000' OR
"T_1"."DIVISION_ID"='1200000101' OR "T_1"."DIVISION_ID"='1300000101' OR
"T_1"."DIVISION_ID"='1400000101' OR "T_1"."DIVISION_ID"='1500000101' OR
"T_1"."DIVISION_ID"='2100000101' OR "T_1"."DIVISION_ID"='2200000101' OR
"T_1"."DIVISION_ID"='2400000101' OR "T_1"."DIVISION_ID"='3400000101'))
V levelu 3 se loguje odepřený přístup, v levelu 4 i povolený přístup.
Příklady pro Firebird:
Stránka načtená z http://toho-ntb3.local:8000/cors-demo.html
apiserver běží na http://localhost
browser je také na localhost
Protože pro origin adresu, odkud se spouští skripty (http://toho-ntb3.local:8000) nejsou nastavena v konfiguraci yaml žádná pravidla, je přístup k tomuto origin odepřen.
Log - Odepřený přístup:
[2025-05-27 17:13:52.560 [3] 00000021 (REQUESTSLOGGER) cors preflight on authorized path http://localhost/demo/countries - denied (origin: http://toho-ntb3.local:8000
Authorized path upozorňuje na to, že se jedná o cestu podléhající autorizaci a origin na místo, odkud pochází skript, který request spustil. U cest podléhajících autorizaci se případné povolení vykonání skriptu nastavuje v konfiguraci yaml v sekci allowedOrigins.
Pro vlastní udělení oprávnění rozhoduje celý origin včetně protokolu. Jako wildcard znak je možné použít * a to vícekrát. Typicky se používá na začátku pro filtrování celé domény, např. takto:
allowedOrigins:
- "*toho-ntb3.local:8000"
Po nastavení je třeba Web API server restartovat. Doporučujeme jej při ověřování spustit programem ApiServerCmd.exe, protože je v konzoli ihned vidět, zda se podařilo konfiguraci YAML načíst. Nezapomeňte, že se jedná o řetězce, a proto musí být v uvozovkách.
Log - Povolený přístup:
[2025-05-27 17:32:28.818 [4] 00000022 (REQUESTSLOGGER) cors preflight on authorized path http://localhost/demo/countries - allowed (origin: http://toho-ntb3.local:8000)
V tomto konkrétním případě uvidíte v prohlížečí pří sledování requestů chybu:
Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://localhost/demo/countries. (Reason: CORS header ‘Access-Control-Allow-Origin’ missing). Status code: 200.
To, že hlavička Access-Control-Allow-Origin chybí, je problém na server straně a vyřeší se konfigurací. Nicméně můžou nastat i jiné důvody. Např. pro dotazy na cestu, která nevyžaduje autorizaci(např. root), vrací apiserver standartně hlavičku Access-Control-Allow-Origin s hodnotou *. Hodnota * ale nesmí být použita současně s přihlašovacímí údaji. Pokud se tedy na root cestu pošlou i autorizační údaje, optins selže na tuto chybu:
[Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at ‘http://localhost/’. (Reason: Credential is not supported if the CORS header ‘Access-Control-Allow-Origin’ is ‘*’).
Pokud se pokoušíme poslat dotaz na neexistující api server dojde k následující chybě.
Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://localhost:6543/demo/countries. (Reason: CORS request did not succeed). Status code: (null)
V tomto případě je vodítkem status code null.
Stránka načtená z http://localhost/demo/script/eu.abra.toho/api/corsdemo
apiserver běží na http://localhost
Jedná se o stejný origin (místo localhost může být jakákoliv jiná doména). V tomto případě prohlížeč CORS preflight requesty nevkládá a vykonává je rovnou. Pokud by ale byly použity knihovny třetích stran stažených z jiných míst, tak už CORS zafunguje a správce bude muset rozhodnout jestli povolit nebo ne.
Je samozřejmě možné v konfiguraci použít * a tím efektivně anulovat jakoukoliv CORS ochranu. To ale není doporučeno.
Aktuálně se hlavička Access-Control-Allow-Private-Network neposílá v prohlížeči Firefox vůbec a na MS EDGE (a nejspíše u všech prohlížečů založené na Chromiu) jen v případě, že origin(tedy odkud pochází script provádějící request) je směřovaný z public adresy na private nebo local adresu. Toto se tedy bude měnit v čase a také je to závislé na konkrétním prohlížeči.
V případě, že tato hlavička existuje, tak ji server standardně zpracuje a do logu zapíše např.:
2025-05-28 08:13:54.204 [4] 00000022 (REQUESTSLOGGER) private network preflight allowed because cors preflight was allowed
Teoreticky se může hlavička Access-Control-Allow-Private-Network vyskytnout i v samostatném preflight requestu, ale musela by k tomu existovat speciální konfigurace. DNS by adresu musel interně mapovat na privátní rozsah adres, třeba www.nejakadomen.com a interně by resolve jména byl třeba na rozsah 192.168 …. Je možné, že se takové konfigurace vyskytují. V takovém případě se private network access řídí stejně jako CORS - v případě přístupu na cestu zadanou heslem se ověří, že pro tento origin je přístup povolený a informace v logu budou podobné. Připomínáme, že pro jeho fungování je třeba mít také nastaveno allowPrivateNetworkAccess na true(výchozí hodnota). Pokud by bylo nastaveno false, byla by v logu informace, že není povolen v konfiguraci.
Pro ladění například skriptů, které přímo volají API, jsou k dispozici query parametry. Níže uvádíme jejich seznam a krátký popis.
Parametry slouží jen pro ladění, jejich použití má rychlostní dopad na vykonání requestů.
[http://localhost:80/demo/script/api/testxy?executor=outprocess&debug-reload-scripts=true[http://localhost:80/demo/script/api/testxyqqq?debug-enforce-new-executor=true
-
debug-reload-scripts - na začátku requestu uvolní skripty z cache stejně, jako to dělá tlačítko Znovunačíst skripty v agendě Balíčky skriptů ve vizuálním prostředí ABRA Flores. Tzn projeví se jakákoliv mezitím udělaná změna ve skriptech.
-
debug-enforce-new-executor - způsobí, že se request vykoná vždy v novém executoru, tedy s novým připojením ke spojení a přihlášením uživatele. V případě session (u serverstate) se původní session uzavře a otevře se nová. Kromě změny ve skriptech se tu projeví všechny ostatní změny.