Add EKÁER test creds doc, SignalR connect hook
Expanded EKAER_INTERFACE.md with NAV test credential steps and usage. Refactored AcSignalRClientBase to add OnConnectionEstablished() hook for post-connect logic. Minor log formatting cleanup in AcBinaryHubProtocol.
This commit is contained in:
parent
93db288584
commit
3a9a8fa540
|
|
@ -82,6 +82,15 @@ A fenti `user` / `passwordHash` / `signingKey` az **ADÓZÓé** (a bejelentésre
|
||||||
|
|
||||||
> **Másik interfész (2024–25): a „NAV M2M általános gépi interfész"** — ÚJ, általánosabb beküldő-csatorna, ahol **a fejlesztő a kliensprogramot regisztrálja** a NAV-nál (a végfelhasználók is regisztrálnak + NAV-tól kapott titkos kódokat írnak be). Ez **NEM** a fenti klasszikus EKÁER 2.2 XML-interfész. Ha a NAV oda terel, ott VAN fejlesztői regisztráció — production előtt érdemes tisztázni, melyik a hatályos.
|
> **Másik interfész (2024–25): a „NAV M2M általános gépi interfész"** — ÚJ, általánosabb beküldő-csatorna, ahol **a fejlesztő a kliensprogramot regisztrálja** a NAV-nál (a végfelhasználók is regisztrálnak + NAV-tól kapott titkos kódokat írnak be). Ez **NEM** a fenti klasszikus EKÁER 2.2 XML-interfész. Ha a NAV oda terel, ott VAN fejlesztői regisztráció — production előtt érdemes tisztázni, melyik a hatályos.
|
||||||
|
|
||||||
|
### Teszt-környezet — külön belépés + technikai felhasználó (2026-07, gyakorlatból)
|
||||||
|
|
||||||
|
A **TESZT-rendszer credentialjai NEM a saját portál-belépési adatok** (a személyes Ügyfélkapu/EKÁER login a teszt-API-hoz `InvalidUserOrPassword`-öt ad). A menet:
|
||||||
|
1. **Teszt-hozzáférés igénylése** a NAV-nál (Kapcsolatfelvétel → „EKÁER, Informatikai problémák"; a levélben: cégnév, adószám, cím/telefon, e-mail) → a NAV e-mailben küld **kifejezetten generált teszt-belépést**.
|
||||||
|
2. A teszt-felületen a profilban **technikai felhasználó + kulcsok** generálása: `username` (technikai user, NEM a személyes login), `password`, **XML aláírókulcs** (`signingKey`).
|
||||||
|
3. A `taxNumber` a **teszthez regisztrált cég** adószámának első 8 jegye.
|
||||||
|
|
||||||
|
Ezek kerülnek az `INavCredentials`-be (a fogyasztónál: `Ekaer:Credentials`). A `BaseUrl` a teszt-hoszt (pl. `https://import-test.ekaer.nav.gov.hu`). **Endpoint:** `{BaseUrl}/TradeCardManagementService/customer/{művelet}` — a művelet-utat a kód fűzi.
|
||||||
|
|
||||||
## Műveletek (`tradeCardOperations` → `operation`)
|
## Műveletek (`tradeCardOperations` → `operation`)
|
||||||
|
|
||||||
| Operation | Jelentés |
|
| Operation | Jelentés |
|
||||||
|
|
|
||||||
|
|
@ -164,8 +164,7 @@ public class AcBinaryHubProtocol : IHubProtocol
|
||||||
|
|
||||||
_chunkStates = new ConditionalWeakTable<IInvocationBinder, AsyncChunkState>();
|
_chunkStates = new ConditionalWeakTable<IInvocationBinder, AsyncChunkState>();
|
||||||
|
|
||||||
_logger?.LogInformation(
|
_logger?.LogInformation("AcBinaryHubProtocol initialized name={Name} mode={ProtocolMode} isBrowser={IsBrowser} chunkSize={ChunkSize} initCap={InitCap} flushPolicy={FlushPolicy} flushTimeoutMs={FlushTimeoutMs} useGen={UseGen} wireMode={WireMode} interning={Interning} compression={Compression}",
|
||||||
"AcBinaryHubProtocol initialized name={Name} mode={ProtocolMode} isBrowser={IsBrowser} chunkSize={ChunkSize} initCap={InitCap} flushPolicy={FlushPolicy} flushTimeoutMs={FlushTimeoutMs} useGen={UseGen} wireMode={WireMode} interning={Interning} compression={Compression}",
|
|
||||||
Name, _protocolMode, IsBrowser, _options.BufferWriterChunkSize, _options.InitialBufferCapacity,
|
Name, _protocolMode, IsBrowser, _options.BufferWriterChunkSize, _options.InitialBufferCapacity,
|
||||||
_flushPolicy, _flushTimeout.TotalMilliseconds,
|
_flushPolicy, _flushTimeout.TotalMilliseconds,
|
||||||
_options.UseGeneratedCode, _options.WireMode, _options.UseStringInterning, _options.UseCompression);
|
_options.UseGeneratedCode, _options.WireMode, _options.UseStringInterning, _options.UseCompression);
|
||||||
|
|
|
||||||
|
|
@ -100,13 +100,28 @@ namespace AyCode.Services.SignalRs
|
||||||
|
|
||||||
public async Task StartConnection()
|
public async Task StartConnection()
|
||||||
{
|
{
|
||||||
|
var wasConnected = IsConnected();
|
||||||
|
|
||||||
if (GetConnectionState() == HubConnectionState.Disconnected)
|
if (GetConnectionState() == HubConnectionState.Disconnected)
|
||||||
await StartConnectionInternal();
|
await StartConnectionInternal();
|
||||||
|
|
||||||
if (!IsConnected())
|
if (!IsConnected())
|
||||||
await TaskHelper.WaitToAsync(IsConnected, ConnectionTimeout, 10, 25);
|
await TaskHelper.WaitToAsync(IsConnected, ConnectionTimeout, 10, 25);
|
||||||
|
|
||||||
|
// Átmenet-hook: csak TÉNYLEGES felépüléskor tüzel (a StartConnection minden küldés előtt lefut,
|
||||||
|
// már-kapcsolt állapotban nem hívjuk). Párhuzamos felépülésnél ritkán kétszer is tüzelhet —
|
||||||
|
// az override legyen idempotens.
|
||||||
|
if (!wasConnected && IsConnected())
|
||||||
|
await OnConnectionEstablished();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Kapcsolat-felépüléskor fut (első connect ÉS reconnectek után). A küldő-út várja meg —
|
||||||
|
/// hosszú munkát fire-and-forget taskként indítson, ne blokkolja az adatforgalmat.
|
||||||
|
/// Idempotensnek kell lennie (párhuzamos felépülésnél kétszer is tüzelhet).
|
||||||
|
/// </summary>
|
||||||
|
protected virtual Task OnConnectionEstablished() => Task.CompletedTask;
|
||||||
|
|
||||||
public async Task StopConnection()
|
public async Task StopConnection()
|
||||||
{
|
{
|
||||||
await StopConnectionInternal();
|
await StopConnectionInternal();
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue