STIR M. Barnes Internet-Draft iconectiv Intended status: Informational July 01, 2018 Expires: January 2, 2019 Session Initiation Protocol (SIP) Call Flow Examples with PASSporT Diversion and History-Info draft-barnes-stir-passport-div-hi-callflows-01 Abstract This document focuses on use cases and call flows which include the History-Info header field and a SIP Identity header field with a PASSport with a "div" claim in cases of retargeting. These use cases are derived from those provided in the SIP History-Info call flows document. The objective is to describe the optimal way to correlate the History-Info header fields with a PASSporT with diversion information to increase the level of confidence in the History-Info header field by the terminating entity making use of the information. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on January 2, 2019. Copyright Notice Copyright (c) 2018 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect Barnes Expires January 2, 2019 [Page 1] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Conventions and Terminology . . . . . . . . . . . . . . . . . 2 3. Detailed call flows . . . . . . . . . . . . . . . . . . . . . 3 3.1. PBX Voicemail Example . . . . . . . . . . . . . . . . . . 3 3.2. Consumer Voicemail Example . . . . . . . . . . . . . . . 10 4. Security Considerations . . . . . . . . . . . . . . . . . . . 15 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 15 5.1. Acknowledgements . . . . . . . . . . . . . . . . . . . . 15 6. Informative References . . . . . . . . . . . . . . . . . . . 16 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 16 1. Overview Many services that use SIP require the ability to determine why and how the call arrived at a specific application. The use cases provided in [RFC7131] illustrate the use of the History-Info header field [RFC7044] for example applications and common scenarios. The document [I-D.ietf-stir-passport-divert] extends the PASSporT, defined in [RFC8225] to cryptographically-sign the calling party information, to include an indication that a call has been diverted from its original destination to a new one. This document discusses the applicability and use of this PASSporT extension for diverted calls in the context of scenarios for which use of the History-Info header field is essential for processing by the terminating entity. Descriptions of the example use cases, call flow diagrams and messaging details including both History-Info header field and a SIP Identity header field with a PASSport capturing the retargeted identity are provided. 2. Conventions and Terminology The term "retarget" is used as defined in [RFC7044]. The term "divert" refers to a specific type of retargeting and is used per the context in [I-D.ietf-stir-passport-divert]. The terms "location service", "redirect" and "address-of-record (AOR)" are used consistent with the terminology in [RFC3261]. Barnes Expires January 2, 2019 [Page 2] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 3. Detailed call flows The scenarios in this section provide sample use cases for the History-Info header along with a PASSporT(s) containing the retargeted identity for informational purposes only. They are not intended to be normative. In many cases, only the relevant messaging details are included in the body of the call flow. The current objective of these call flows is for discussion purposes to determine if the current set of information proposed to be captured in the PASSporT in cases of retargeting is sufficient. It is anticipated that the cases where a "div" PASSporT is added would be cases where the a History-Info header field has been added and tagged "mp", indicating the hi-targeted-to-URI represents a user other than the target user associated with the Request-URI in the incoming request that was retargeted. Given that the History-Info header field captures a full set of information as to why a request is retargeted, it might seem reasonable to just add the PASSporT to the History-Info header field as opposed to adding a new Identity header field in cases of retargeting. However, in that case, that would then require the terminating user to search the History-Info entries to determine if the request was "diverted" and whether the identity at the point of retargeting was authenticated. An alternative is that rather than just adding the retargeted destination, the complete History-Info header field could be added to the PASSporT. This could increase the confidence at the terminating user that all the information is valid. At a minimum the "index" should be included as it's possible to have entries containing the same target. For example, a proxy forwards a request in the case of loose routing and then the request is retargeted at the next hop. Also, there are cases whereby the first entry with a specific tag is most relevant. Thus, being able to at least correlate the contents of that entry with a PASSporT with diverted information could be quite useful. Editor's note: currently, there are only two examples - consumer and PBX voicemail. It's probably quite useful to document more of the flows once there is agreement on the best approach for correlating the information. 3.1. PBX Voicemail Example A typical use case for voicemail is one whereby the original called party is not reachable and the call arrives at a voicemail system. In some cases multiple alternate destinations may be tried without success. The voicemail system typically requires the original called party information to determine the appropriate mailbox so an Barnes Expires January 2, 2019 [Page 3] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 appropriate greeting can be provided and the appropriate party notified of the message. In this example, Alice calls Bob, whose SIP client is forwarded to Carol. Carol does not answer the call, thus it is forwarded to a VM (voicemail) server (VMS). In order to determine the appropriate mailbox to use for this call, the VMS needs the original target for the request. The original target is determined by finding the first hi-entry tagged with "rc" or "mp" and using the hi-entry referenced by the index of "rc" or "mp" header field parameter as the target for determining the appropriate mailbox. This first hi-entry is used to populate the "target" URI parameter as defined in [RFC4458]. If the SIP Identity header field with "div" claims has been added by the entities retargeting, it can be ascertained that the call should be forwarded to Bob's voicemail prior to forwarding the call to voicemail. The value of the "tn" in the "div" field of the claim should match the hi-targeted-to URI in the hi-entry with the hi-index matching the "hi" value in the "div" claim. The reason associated with the first hi-entry tagged with "rc" or "mp" (i.e., 302) could be used to provide a customized voicemail greeting and is used to populate the "cause" URI parameter as defined in [RFC4458]. Note that some VMSs may also (or instead) use the information available in the History-Info headers for custom handling of the VM based on how and why the call arrived at the VMS. Furthermore it is the proxy forwarding the call to VMS that determines the target of the voicemail, it is the proxy that sets the target of voicemail which is also the entity that utilizes [RFC7044] to find the target which is usually based on local policy installed by the user or an administrator. Alice example.com Bob Carol VM 12155551212 12155551213 | INVITE F1 | | | | |------------->| | | | | | INVITE F2 | | | | |------------->| | | | | | | | | 100 Trying | | | | |<-------------| 302 Moved Temporarily F3 | | | |<-------------| | | | | | | | | | ACK | | | | |------------->| | | | | | | | Barnes Expires January 2, 2019 [Page 4] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 | | INVITE F4 | | | | |--------------------------->| | | | | | | | | 180 Ringing F5 | | | |<---------------------------| | | | | | | | 180 Ringing | | | | |<-------------| | | | | | | | | | | (timeout) | | | | | | | | | INVITE F6 | | | | |-------------------------------------->| | | | | | | | 200 OK F7 | | |<--------------------------------------| | 200 OK | | | | |<-------------| | | | | | | | | | ACK | |----------------------------------------------------->| [Editor's note: call flows need revision to use TNs] F1 INVITE Alice -> Example.com INVITE sip:bob@example.com SIP/2.0 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 70 From: Alice ;tag=kkaz- To: Bob Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 Contact: Alice Content-Length: [SDP Not Shown] F2 INVITE Example.com -> Bob INVITE sip:12155551212@example.com;user=phone SIP/2.0 Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK12s4 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 69 Barnes Expires January 2, 2019 [Page 5] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 From: Alice ;tag=kkaz- To: Bob ;tag=1928301774> Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Contact: Alice Content-Type: application/sdp Content-Length: [SDP Not Shown] F3 302 Moved Temporarily Bob -> Example.com SIP/2.0 302 Moved Temporarily Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK12s4;\ received=192.0.2.101 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 From: Alice ;tag=kkaz- To: Bob ;tag=2g22d-lnf Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Contact: ;mp=1 Content-Type: application/sdp Content-Length: [SDP Not Shown] Barnes Expires January 2, 2019 [Page 6] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 F4 INVITE Example.com -> Carol INVITE sip:12155551213@example.com;user=phone SIP/2.0 Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK4522 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 69 From: Alice ;tag=kkaz- To: Bob Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 History-Info: ;index=1.2;mp=1 History-Info: ;\ index=1.2.1;rc=1.2 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Identity:..sv5CTo05KqpSmtHt3dcEiO/1CWTSZtnG3iV+1nmurLXV/HmtyNS7L eU7d7OV8HweTTDobV3itTmgPwCFjaEmMyEI3d7SyN21yNDo2ER/Ovgtw0Lu5csIp pPqOg1uXndzHbG7mR6Rl9BnUhHufVRbp51Mn3w0gfUs=; \ info=;alg=ES256; ppt=div Contact: Alice Content-Type: application/sdp Content-Length: [SDP Not Shown] F5 180 Ringing Carol -> Example.com SIP/2.0 180 Ringing Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK4522;\ received=192.0.2.101 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 From: Alice ;tag=kkaz- To: Bob ;tag=setss3x Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 Barnes Expires January 2, 2019 [Page 7] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 History-Info: ;\ index=1.1;rc=1 History-Info: ;index=1.2;mp=1 History-Info: ;index=1.2.1;rc=1.2 Contact: Content-Type: application/sdp Content-Length: [SDP Not Shown] F6 INVITE Example.com -> VM INVITE sip:vm@192.0.2.6;target=sip:bob%40example.com;cause=480\ SIP/2.0 Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK4523 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 69 From: Alice ;tag=kkaz- To: Bob Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 History-Info: ;\ index=1.2;mp=1 History-Info: ;\ index=1.2.1;rc=1.2 History-Info: ;\ index=1.3;mp=1 History-Info: ;\ index=1.3.1;rc=1.3 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Identity: ..sv5CTo05KqpSmtHt3dcEiO/1CWTSZtnG3iV+1nmurLXV/HmtyNS7L Barnes Expires January 2, 2019 [Page 8] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 eU7d7OV8HweTTDobV3itTmgPwCFjaEmMyEI3d7SyN21yNDo2ER/Ovgtw0Lu5csIp pPqOg1uXndzHbG7mR6Rl9BnUhHufVRbp51Mn3w0gfUs=; \ info=;alg=ES256;ppt=div Identity: ... L2V4YW1wbGUuY2VydCJ9eyJhdHRlc3QiOiJBIiwiZGVzdCI6 \ eyJ0biI6IisxMjE1NTU1MTIxMyJ9LCJpYXQiOiIxNDcxMzc1NDE4Iiwib3JpZyI \ 6eyJ0biI64oCdKzEyMTU1 NTUxMjEyIn0sIm9yaWdpZCI6IjEyM2U0NTY3LWU4O \ ;info =;alg=ES256; ppt=div Contact: Alice Content-Type: application/sdp Content-Length: [SDP Not Shown] F7 200 OK VM -> Example.com SIP/2.0 200 OK Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK4523;\ received=192.0.2.101 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 From: Alice ;tag=kkaz- To: Bob ;tag=3dweggs Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 History-Info: ;index=1.2;mp=1 History-Info: ;index=1.2.1;rc=1.2 History-Info: ;\ index=1.3;mp=1 History-Info: ;\ index=1.3.1;rc=1.3 Contact: Content-Type: application/sdp Content-Length: [SDP Not Shown] Figure 1: Enterprise Voicemail Example Barnes Expires January 2, 2019 [Page 9] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 The VMS can look at the last hi-entry and finds the target of the mailbox by looking at the URI entry in the "target" URI parameter in the hi-entry. 3.2. Consumer Voicemail Example In the case of a consumer, when the call is retargeted, it is usually to another administrative domain. The voicemail system in these environment typically requires the last called party information to determine the appropriate mailbox so an appropriate greeting can be provided and the appropriate party notified of the message. In this example, Alice calls Bob but Bob has temporarily forwarded his phone to Carol because she is his wife. Carol does not answer the call, thus it is forwarded to a VM (voicemail) server (VMS). In order to determine the appropriate mailbox to use for this call, the VMS needs the appropriate target for the request. The last target is determined by finding the hi-entry referenced by the index of last hi-entry tagged with "mp" for determining the appropriate mailbox. If the SIP Identity header field with "div" claims has been added by the entities retargeting, it can be ascertained that the call should be forwarded to Carol's voicemail prior to forwarding the call to voicemail. The value of the "tn" in the "div" field of the claim should match the hi-targeted-to URI in the hi-entry with the hi-index matching the "hi" value in the "div" field. This hi-entry is used to populate the "target" URI parameter as defined in [RFC4458]. Note that some VMSs may also (or instead) use the information available in the History-Info headers for custom handling of the VM in terms of how and why the called arrived at the VMS. Alice example.com Bob Carol VM | INVITE F1 | | | | |------------->| | | | | | INVITE F2 | | | | |------------->| | | | | | | | | 100 Trying | | | | |<-------------| 302 Moved Temporarily F3 | | | |<-------------| | | | | | | | | | ACK | | | | |------------->| | | Barnes Expires January 2, 2019 [Page 10] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 | | | | | | | INVITE F4 | | | | |--------------------------->| | | | | | | | | 180 Ringing F5 | | | |<---------------------------| | | | | | | | 180 Ringing | | | | |<-------------| | | | | | | | | | | (timeout) | | | | | | | | | INVITE F6 | | | | |-------------------------------------->| | | | | | | | 200 OK F7 | | |<--------------------------------------| | 200 OK | | | | |<-------------| | | | | | | | | | ACK | |----------------------------------------------------->| [Editor's note: call flows need revision to use TNs] F1 INVITE Alice -> Example.com INVITE sip:bob@example.com SIP/2.0 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 70 From: Alice ;tag=kkaz- To: Bob Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 Contact: Alice Content-Length: [SDP Not Shown] F2 INVITE Example.com -> Bob INVITE sip:bob@192.0.2.5 SIP/2.0 Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK12s4 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 69 Barnes Expires January 2, 2019 [Page 11] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 From: Alice ;tag=kkaz- To: Bob Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;index=1.1;rc=1 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Contact: Alice Content-Type: application/sdp Content-Length: [SDP Not Shown] F3 302 Moved Temporarily Bob -> Example.com SIP/2.0 302 Moved Temporarily Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK12s4;\ received=192.0.2.101 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 From: Alice ;tag=kkaz- To: Bob ;tag=224ls3s-t Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;index=1.1;rc=1 Contact: ;mp=1 Content-Type: application/sdp Content-Length: [SDP Not Shown] F4 INVITE Example.com -> Carol INVITE sip:carol@192.0.2.4 SIP/2.0 Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK24s5 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 69 From: Alice ;tag=kkaz- To: Bob Barnes Expires January 2, 2019 [Page 12] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: \ ;index=1.1;rc=1 History-Info: ;index=1.2;mp=1 History-Info: ;index=1.2.1;rc=1.2 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Identity:..sv5CTo05KqpSmtHt3dcEiO/1CWTSZtnG3iV+1nmurLXV/HmtyNS \ 7Ltrg9dlxkWzoeU7d7OV8HweTTDobV3itTmgPwCFjaEmMyEI3d7SyN21yNDo2\ EROvgtw0Lu5csIppPqOg1uXndzHbG7mR6Rl9BnUhHufVRbp51Mn3w0gfUs=; \ info=;alg=ES256;ppt=div Contact: Alice Content-Type: application/sdp Content-Length: [SDP Not Shown] F5 180 Ringing Carol -> Example.com SIP/2.0 180 Ringing Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bK24s5;\ received=192.0.2.101 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 From: Alice ;tag=kkaz- To: Bob ;tag=setss3x Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 History-Info: ;index=1.2;mp=1 History-Info: ;index=1.2.1;rc=1.2 Contact: Content-Type: application/sdp Content-Length: [SDP Not Shown] Barnes Expires January 2, 2019 [Page 13] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 F6 INVITE Example.com -> VM INVITE sip:vm@192.0.2.6;target=sip:carol%40example.com SIP/2.0 Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bKbbg4 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 Max-Forward: 69 From: Alice ;tag=kkaz- To: Bob Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 History-Info: ;\ index=1.2;mp=1 History-Info: ;\ index=1.2.1;rc=1.2 History-Info: ;index=1.2.2;mp=1.2 History-Info: ;index=1.2.2.1;rc=1.2.2 Identity: eyJhbGciOiJFUzI1NiIsInR5cCI6InBhc3Nwb3J0IiwieDV1I \ joiaHR0cHM6Ly9jZXJ0LmV4YW1wbGUub3JnL3Bhc3Nwb3J0LmNlciJ9.eyJ \ kZXN0Ijp7InVyaSI6WyJzaXA6YWxpY2VAZXhhbXBsZS5jb20iXX0sImlhdC \ I6IjE0NDMyMDgzNDUiLCJvcmlnIjp7InRuIjoiMTIxNTU1NTEyMTIifX0.r \ q3pjT1hoRwakEGjHCnWSwUnshd0-zJ6F1VOgFWSjHBr8Qjpjlk-cpFYpFYs \ ojNCpTzO3QfPOlckGaS6hEck7w;info=;alg=ES256 Identity:..sv5CTo05KqpSmtHt3dcEiO/1CWTSZtnG3iV+1nmurLXV/HmtyNS \ 7Ltrg9dlxkWzoeU7d7OV8HweTTDobV3itTmgPwCFjaEmMyEI3d7SyN21yNDo2\ EROvgtw0Lu5csIppPqOg1uXndzHbG7mR6Rl9BnUhHufVRbp51Mn3w0gfUs=; \ info=;alg=ES256;ppt=div Identity: ... L2V4YW1wbGUuY2VydCJ9eyJhdHRlc3QiOiJBIiwiZGVzdCI6 \ eyJ0biI6IisxMjE1NTU1MTIxMyJ9LCJpYXQiOiIxNDcxMzc1NDE4Iiwib3JpZyI \ 6eyJ0biI64oCdKzEyMTU1 NTUxMjEyIn0sIm9yaWdpZCI6IjEyM2U0NTY3LWU4O \ ;info =;alg=ES256; ppt=div Contact: Alice Content-Type: application/sdp Content-Length: [SDP Not Shown] F7 200 OK VM -> Example.com SIP/2.0 200 OK Via: SIP/2.0/TCP proxy.example.com:5060;branch=z9hG4bKbbg4 Barnes Expires January 2, 2019 [Page 14] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 Via: SIP/2.0/TCP 192.0.2.3:5060;branch=z9hG4bK42t2 From: Alice ;tag=kkaz- To: Bob ;tag=3dweggs Supported: histinfo Call-Id: 12345600@example.com CSeq: 1 INVITE History-Info: ;index=1 History-Info: ;\ index=1.1;rc=1 History-Info: ;\ index=1.2;mp=1 History-Info: ;\ index=1.2.1;rc=1.2 History-Info: ;index=1.2.2;mp=1.2 History-Info: ;index=1.2.2.1;rc=1.2.2 Contact: Content-Type: application/sdp Content-Length: [SDP Not Shown] Figure 2: Consumer Voivemail Example The VMS can look at the last hi-entry and find the target of the mailbox by looking for the "target" URI parameter in the hi-entry and the reason by the "cause" URI parameter in the same hi-entry. 4. Security Considerations This document adds no new security considerations beyond those specified in [RFC7044] for the History-Info header field and [RFC8224] for the Identity header field. 5. IANA Considerations This document has no IANA considerations. 5.1. Acknowledgements Barnes Expires January 2, 2019 [Page 15] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 6. Informative References [RFC3261] Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A., Peterson, J., Sparks, R., Handley, M., and E. Schooler, "SIP: Session Initiation Protocol", RFC 3261, DOI 10.17487/RFC3261, June 2002, . [RFC4458] Jennings, C., Audet, F., and J. Elwell, "Session Initiation Protocol (SIP) URIs for Applications such as Voicemail and Interactive Voice Response (IVR)", RFC 4458, DOI 10.17487/RFC4458, April 2006, . [RFC7044] Barnes, M., Audet, F., Schubert, S., van Elburg, J., and C. Holmberg, "An Extension to the Session Initiation Protocol (SIP) for Request History Information", RFC 7044, DOI 10.17487/RFC7044, February 2014, . [RFC7131] Barnes, M., Audet, F., Schubert, S., van Elburg, H., and C. Holmberg, "Session Initiation Protocol (SIP) History- Info Header Call Flow Examples", RFC 7131, DOI 10.17487/RFC7131, March 2014, . [RFC8224] Peterson, J., Jennings, C., Rescorla, E., and C. Wendt, "Authenticated Identity Management in the Session Initiation Protocol (SIP)", RFC 8224, DOI 10.17487/RFC8224, February 2018, . [RFC8225] Wendt, C. and J. Peterson, "PASSporT: Personal Assertion Token", RFC 8225, DOI 10.17487/RFC8225, February 2018, . [I-D.ietf-stir-passport-divert] Peterson, J., "PASSporT Extension for Diverted Calls", draft-ietf-stir-passport-divert-02 (work in progress), March 2018. Author's Address Barnes Expires January 2, 2019 [Page 16] Internet-DrafPASSporT Diversion and History-Info Call Flows July 2018 Mary Barnes iconectiv TX US Email: mary.ietf.barnes@gmail.com Barnes Expires January 2, 2019 [Page 17]