<?xml version="1.0" encoding="UTF-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.0.36 -->

<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
]>

<?rfc toc="yes"?>
<?rfc sortrefs="yes"?>
<?rfc symrefs="yes"?>

<rfc ipr="trust200902" docName="draft-wendt-stir-passport-shaken-00" category="std">

  <front>
    <title abbrev="idreg">PASSporT SHAKEN Extension (SHAKEN)</title>

    <author initials="C." surname="Wendt" fullname="Chris Wendt">
      <organization>Comcast</organization>
      <address>
        <postal>
          <street>One Comcast Center</street>
          <city>Philadelphia, PA  19103</city>
          <country>USA</country>
        </postal>
        <email>chris-ietf@chriswendt.net</email>
      </address>
    </author>
    <author initials="M." surname="Barnes" fullname="Mary Barnes">
      <organization>MLB@Realtime Communications</organization>
      <address>
        <email>mary.ietf.barnes@gmail.com</email>
      </address>
    </author>

    <date year="2017" month="July" day="03"/>

    <area>ART</area>
    <workgroup>stir</workgroup>
    <keyword>Internet-Draft</keyword>

    <abstract>


<t>This document extends PASSporT, a token object that conveys cryptographically-signed information about the participants involved in personal communications, to include information defined as part of the SHAKEN <xref target="ATIS-1000074"/> specification for indicating an attestation level and originating ID.</t>



    </abstract>


  </front>

  <middle>


<section anchor="introduction" title="Introduction">

<t>The SHAKEN specification defines a framework for using STIR protocols including PASSporT and the STIR certificate framework for implementing the cryptographic validation of an authorized originator of telephone calls using SIP.  Because the current telephone network contains both VoIP and TDM/SS7 originated traffic, there is many scenarios that need to be accounted for where PASSporT signatures may represent either direct or indirect call origination scenarios.  The SHAKEN <xref target="ATIS-1000074"/> specification defines levels of attribution of the origination of the call as well as an origination identifier that can help create a unique association with the origination of calls from various parts of the VoIP or TDM telephone network.  This document specifies these indicators as a specified PASSporT extension.</t>

</section>
<section anchor="terminology" title="Terminology">

<t>The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this
document are to be interpreted as described in <xref target="RFC2119"/>.</t>

</section>
<section anchor="attest" title="PASSporT ‘attest’ Claim">

<t>This indicator allows for both identifying the service provider that is vouching for the call as well as a clearly indicating what information the service provider is attesting to.  The ‘attest’ claim can be one of the following three values, ‘A’, ‘B’, or ‘C’ as defined in <xref target="ATIS-1000074"/>.</t>

</section>
<section anchor="origid" title="PASSporT ‘origid’ Claim">

<t>The purpose of the unique origination identifier is to assign an opaque identifier corresponding to the service provider-initiated calls themselves, customers, classes of devices, or other groupings that a service provider might want to use for determining things like reputation or trace back identification of customers or gateways.  The value of ‘origid’ claim is a UUID as defined in <xref target="RFC4122"/>.</t>

</section>
<section anchor="example" title="Example">

<figure><artwork><![CDATA[
Protected Header
{
   "alg":"ES256",
   "typ":"passport",
   “ppt”:”shaken”,
   "x5u":"https://cert.example.org/passport.crt"
}
Payload
{
   “attest”:”A”
   "dest":{“uri”:"sip:alice@example.com"}
   "iat":"1443208345",
   "orig":{“tn”:"12155551212"},
   “origid”:”123e4567-e89b-12d3-a456-426655440000”
}
]]></artwork></figure>

</section>
<section anchor="using-shaken-in-sip" title="Using ‘shaken’ in SIP">

<t>The use of the ‘shaken’ PASSporT type and the claims ‘attest’ and ‘origid’ are formally defined in <xref target="ATIS-1000074"/> for usage in SIP <xref target="RFC3261"/> aligned with the use of the identity header defined in <xref target="I-D.ietf-stir-rfc4474bis"/>.  The carriage of the ‘attest’ and ‘origid’ values are in the full PASSporT token included in the identity header as specified in <xref target="ATIS-1000074"/>.</t>

</section>
<section anchor="iana-considerations" title="IANA Considerations">

<section anchor="json-web-token-claims" title="JSON Web Token claims">

<t>This specification requests that the IANA add two new claims to the JSON
Web Token Claims registry as defined in <xref target="RFC7519"></xref>.</t>

<t>Claim Name: “attest”</t>

<t>Claim Description: Attestation level as defined in SHAKEN framework</t>

<t>Change Controller: IESG</t>

<t>Specification Document(s): [RFCThis]</t>

<t>Claim Name: “origid”</t>

<t>Claim Description: Originating Identifier as defined in SHAKEN framework</t>

<t>Change Controller: IESG</t>

<t>Specification Document(s): [RFCThis]</t>

</section>
<section anchor="passport-types" title="PASSporT Types">

<t>This specification requests that the IANA add a new entry to the PASSporT Types registry for the type “shaken” which is specified in [RFCThis].</t>

</section>
</section>
<section anchor="security_considerations" title="Security Considerations">

<t>TBD</t>

</section>
<section anchor="acknowledgements" title="Acknowledgements">

<t>TBD</t>

</section>


  </middle>

  <back>

    <references title='Normative References'>





<reference anchor='I-D.ietf-stir-passport'>
<front>
<title>Personal Assertion Token (PASSporT)</title>

<author initials='C' surname='Wendt' fullname='Chris Wendt'>
    <organization />
</author>

<author initials='J' surname='Peterson' fullname='Jon Peterson'>
    <organization />
</author>

<date month='February' day='9' year='2017' />

<abstract><t>This document defines a method for creating and validating a token that cryptographically verifies an originating identity, or more generally a URI or telephone number representing the originator of personal communications.  The PASSporT token is cryptographically signed to protect the integrity of the identity the originator and to verify the assertion of the identity information at the destination. The cryptographic signature is defined with the intention that it can confidently verify the originating persona even when the signature is sent to the destination party over an insecure channel.  PASSporT is particularly useful for many personal communications applications over IP networks and other multi-hop interconnection scenarios where the originating and destination parties may not have a direct trusted relationship.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-stir-passport-11' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-stir-passport-11.txt' />
</reference>



<reference anchor='I-D.ietf-stir-certificates'>
<front>
<title>Secure Telephone Identity Credentials: Certificates</title>

<author initials='J' surname='Peterson' fullname='Jon Peterson'>
    <organization />
</author>

<author initials='S' surname='Turner' fullname='Sean Turner'>
    <organization />
</author>

<date month='May' day='9' year='2017' />

<abstract><t>In order to prevent the impersonation of telephone numbers on the Internet, some kind of credential system needs to exist that cryptographically asserts authority over telephone numbers.  This document describes the use of certificates in establishing authority over telephone numbers, as a component of a broader architecture for managing telephone numbers as identities in protocols like SIP.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-stir-certificates-14' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-stir-certificates-14.txt' />
</reference>



<reference anchor='I-D.ietf-stir-rfc4474bis'>
<front>
<title>Authenticated Identity Management in the Session Initiation Protocol (SIP)</title>

<author initials='J' surname='Peterson' fullname='Jon Peterson'>
    <organization />
</author>

<author initials='C' surname='Jennings' fullname='Cullen Jennings'>
    <organization />
</author>

<author initials='E' surname='Rescorla' fullname='Eric Rescorla'>
    <organization />
</author>

<author initials='C' surname='Wendt' fullname='Chris Wendt'>
    <organization />
</author>

<date month='February' day='9' year='2017' />

<abstract><t>The baseline security mechanisms in the Session Initiation Protocol (SIP) are inadequate for cryptographically assuring the identity of the end users that originate SIP requests, especially in an interdomain context.  This document defines a mechanism for securely identifying originators of SIP requests.  It does so by defining a SIP header field for conveying a signature used for validating the identity, and for conveying a reference to the credentials of the signer.</t></abstract>

</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-stir-rfc4474bis-16' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-stir-rfc4474bis-16.txt' />
</reference>



<reference  anchor='RFC4122' target='http://www.rfc-editor.org/info/rfc4122'>
<front>
<title>A Universally Unique IDentifier (UUID) URN Namespace</title>
<author initials='P.' surname='Leach' fullname='P. Leach'><organization /></author>
<author initials='M.' surname='Mealling' fullname='M. Mealling'><organization /></author>
<author initials='R.' surname='Salz' fullname='R. Salz'><organization /></author>
<date year='2005' month='July' />
<abstract><t>This specification defines a Uniform Resource Name namespace for UUIDs (Universally Unique IDentifier), also known as GUIDs (Globally Unique IDentifier).  A UUID is 128 bits long, and can guarantee uniqueness across space and time.  UUIDs were originally used in the Apollo Network Computing System and later in the Open Software Foundation\'s (OSF) Distributed Computing Environment (DCE), and then in Microsoft Windows platforms.</t><t>This specification is derived from the DCE specification with the kind permission of the OSF (now known as The Open Group).  Information from earlier versions of the DCE specification have been incorporated into this document.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='4122'/>
<seriesInfo name='DOI' value='10.17487/RFC4122'/>
</reference>



<reference  anchor='RFC7519' target='http://www.rfc-editor.org/info/rfc7519'>
<front>
<title>JSON Web Token (JWT)</title>
<author initials='M.' surname='Jones' fullname='M. Jones'><organization /></author>
<author initials='J.' surname='Bradley' fullname='J. Bradley'><organization /></author>
<author initials='N.' surname='Sakimura' fullname='N. Sakimura'><organization /></author>
<date year='2015' month='May' />
<abstract><t>JSON Web Token (JWT) is a compact, URL-safe means of representing claims to be transferred between two parties.  The claims in a JWT are encoded as a JSON object that is used as the payload of a JSON Web Signature (JWS) structure or as the plaintext of a JSON Web Encryption (JWE) structure, enabling the claims to be digitally signed or integrity protected with a Message Authentication Code (MAC) and/or encrypted.</t></abstract>
</front>
<seriesInfo name='RFC' value='7519'/>
<seriesInfo name='DOI' value='10.17487/RFC7519'/>
</reference>


<reference anchor="ATIS-1000074" >
  <front>
    <title>Signature-based Handling of Asserted information using toKENs (SHAKEN)</title>
    <author >
      <organization>ATIS/SIP Forum NNI Task Group</organization>
    </author>
    <date year="2017" month="January"/>
  </front>
</reference>


    </references>

    <references title='Informative References'>





<reference  anchor='RFC2119' target='http://www.rfc-editor.org/info/rfc2119'>
<front>
<title>Key words for use in RFCs to Indicate Requirement Levels</title>
<author initials='S.' surname='Bradner' fullname='S. Bradner'><organization /></author>
<date year='1997' month='March' />
<abstract><t>In many standards track documents several words are used to signify the requirements in the specification.  These words are often capitalized. This document defines these words as they should be interpreted in IETF documents.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t></abstract>
</front>
<seriesInfo name='BCP' value='14'/>
<seriesInfo name='RFC' value='2119'/>
<seriesInfo name='DOI' value='10.17487/RFC2119'/>
</reference>



<reference  anchor='RFC3261' target='http://www.rfc-editor.org/info/rfc3261'>
<front>
<title>SIP: Session Initiation Protocol</title>
<author initials='J.' surname='Rosenberg' fullname='J. Rosenberg'><organization /></author>
<author initials='H.' surname='Schulzrinne' fullname='H. Schulzrinne'><organization /></author>
<author initials='G.' surname='Camarillo' fullname='G. Camarillo'><organization /></author>
<author initials='A.' surname='Johnston' fullname='A. Johnston'><organization /></author>
<author initials='J.' surname='Peterson' fullname='J. Peterson'><organization /></author>
<author initials='R.' surname='Sparks' fullname='R. Sparks'><organization /></author>
<author initials='M.' surname='Handley' fullname='M. Handley'><organization /></author>
<author initials='E.' surname='Schooler' fullname='E. Schooler'><organization /></author>
<date year='2002' month='June' />
<abstract><t>This document describes Session Initiation Protocol (SIP), an application-layer control (signaling) protocol for creating, modifying, and terminating sessions with one or more participants.  These sessions include Internet telephone calls, multimedia distribution, and multimedia conferences.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='3261'/>
<seriesInfo name='DOI' value='10.17487/RFC3261'/>
</reference>




    </references>



  </back>
</rfc>

