Požadavek reload-ssl

Důležité upozornění – neaktivní zpracování

Zpracování tohoto uzlu není v aktuální verzi serveru dostupné. Požadavek se nezpracuje a neprovede opětovné načtení SSL; jde o historickou, nedokončenou nebo odstraněnou funkci, ne jen o dočasně vypnutou možnost.

Popis níže („Zamýšlené chování“) proto popisuje, co by uzel dělal, kdyby byl blok aktivní – pro historickou návaznost na starší dokumentaci. Skutečné chování serveru je popsáno v sekcích „Zpracování a vedlejší účinky“ a „XML odpověď“.

Účel a dopady

Zamýšleným účelem bylo vyžádat u webového serveru novou inicializaci SSL (opětovné načtení certifikátu) bez restartu procesu. Vzhledem k výše popsanému stavu kódu nemá aktuálně tento požadavek žádný ze zamýšlených účinků.

Dostupnost, kontext, oprávnění apod.

Zamýšleno pro uživatele s r_admin. Protože je zpracování vyřazené, toto omezení se reálně neuplatňuje – požadavek se ke kontrole oprávnění vůbec nedostane.

XML požadavek (syntax + popis)

  <request>
   <reload-ssl/>
  </request>

Uzel nemá žádné atributy ani potomky.

Parametry a pravidla (atributy, potomci)

Žádné – uzel reload-ssl nenese žádné atributy ani potomky (a to jak v zamýšleném, tak ve skutečném chování).

Příklady požadavku

(Zatím bez ověřeného příkladu.)

Zpracování a vedlejší účinky

Protože dispatcher požadavků nemá pro reload-ssl žádnou aktivní větev, uplatní se obecné zpracování neznámého uzlu: požadavek se nezamítne jako chyba, ale server jej ani nijak nezpracuje – do odpovědi vloží obecný zástupný uzel s echem názvu odeslaného uzlu.

XML odpověď (syntax + popis)

Skutečná odpověď na <reload-ssl/> v aktuální verzi serveru:

  <response>
   <unknown-request-response
    name="reload-ssl"
    />
  </response>

Zamýšlená, ale neaktivní odpověď by měla tvar:

  <response>
   <reload-ssl
    type="ok|error"
    detail="{string}"
    />
  </response>

Příklady odpovědi

(Zatím bez ověřeného příkladu.)

Chyby a reakce

• Skutečné chování negeneruje žádnou specifickou chybu pro reload-ssl – viz unknown-request-response výše. Toto se stejně chová pro libovolný neznámý/neimplementovaný uzel požadavku.
• Zamýšlené, ale neaktivní chybové větve: type="error" detail="Nemate opravneni" (bez r_admin), type="error" detail="Webovy server nepodporuje SSL" (web server neběží v SSL režimu), type="error" detail="Webovy server je vypnuty" (webový server vůbec neběží). Tyto větve se v aktuální verzi serveru nikdy nespustí.
• Tvrzení starší dokumentace o automatickém opětovném načtení certifikátu počínaje 30. dnem před vypršením se nepodařilo potvrdit. Toto tvrzení bylo proto ze stránky odstraněno jako neověřené.

Související požadavky

Žádné ověřené související požadavky v rámci skupiny other.