[Stox] STOX Error Condition/Response code translation

["De Vries, Michael [USA]" <[e-mail]>]

Hello Everyone,

The draft-ietf-stox-core-00 document specifies mappings between XMPP error conditions and SIP response codes, but does not specify any requirements/recommendations for handling the SIP "Reason-Phrase" in the "Status-Line" header or the XMPP <text/> entry in the <error/> block.  According to the SIP and XMPP RFCs, the Reason-Phrase and <error/> block appear to effectively serve the same purpose in conveying additional error information intended for the human user, so a direct translation between the two (when present) seems reasonable to me.  

Additionally, this could potentially help to distinguish errors which are currently mapped down from many possibilities into a single entry, such as SIP response codes 413-423 (and others) all being mapped to the <bad-request/> XMPP Error Condition, assuming that the SIP responses provide a Reason-Phrase.  Additionally, it may even be possible to provide the additional distinguishing information in the XMPP <text/> block even if the SIP response does not contain a Reason-Phrase for direct translation.

For example:  Assume the XMPP-SIP gateway receives a SIP 415 response code (Unsupported Media Type) in response to some gateway-mediated action between an XMPP user and SIP user. As per the draft-ieftf-stox-core-00 document, this response code should be translated and sent to the XMPP user effectively as:

  <error type='modify'>
    <bad-request xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
  </error>


If this 415 response contains a Reason-Phrase (though it does not appear to be mandated as per RFC3261), then the gateway could instead send to the XMPP user:

  <error type='modify'>
    <bad-request xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
    <text xml:lang='en' xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'>
      [ ... Reason-Phrase translated here ... ]
    </text>
  </error>


Additionally, if this 415 response does not contain a Reason-Phrase, then the gateway could send the following to the XMPP user as a means of distinguishing from other <bad-request/> errors:

  <error type='modify'>
    <bad-request xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
    <text xml:lang='en' xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'>
      Unsupported Media Type
    </text>
  </error>


Similarly, a 416 response (Unsupported URI Scheme) without a Reason-Phrase could be translated into:

  <error type='modify'>
    <bad-request xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
    <text xml:lang='en' xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'>
      Unsupported URI Scheme
    </text>
  </error>


thus distinguishing between the 415 and 416 responses for the XMPP human user, but effectively requiring some textual injection into the message stream by the gateway which would need to be specified in the document.  That said, as these fields are all optional and not related to actual SIP/XMPP application-level handling of messages, there is no reason that the XMPP-SIP gateway must perform such a translation, but I figured it might be worth exploring in this discussion group.


Thanks,
--Mike DeVries