Skip to main content

Using Generic Security Service Application Program Interface (GSS-API) Mechanisms in Simple Authentication and Security Layer (SASL): The GS2 Mechanism Family
RFC 5801

Revision differences

Document history

Date Rev. By Action
2020-01-21
20 (System) Received changes through RFC Editor sync (added Verified Errata tag)
2015-10-14
20 (System) Notify list changed from sasl-chairs@ietf.org, simon@josefsson.org, alexey.melnikov@isode.com to alexey.melnikov@isode.com
2012-08-22
20 (System) post-migration administrative database adjustment to the No Objection position for Adrian Farrel
2010-07-13
20 Cindy Morgan State Changes to RFC Published from RFC Ed Queue by Cindy Morgan
2010-07-13
20 Cindy Morgan [Note]: 'RFC 5801' added by Cindy Morgan
2010-07-13
20 (System) IANA Action state changed to RFC-Ed-Ack from Waiting on RFC Editor
2010-07-12
20 (System) RFC published
2010-01-15
20 Cindy Morgan State Changes to RFC Ed Queue from Approved-announcement sent by Cindy Morgan
2010-01-15
20 (System) IANA Action state changed to Waiting on RFC Editor from In Progress
2010-01-15
20 (System) IANA Action state changed to In Progress from Waiting on Authors
2010-01-14
20 (System) IANA Action state changed to Waiting on Authors from In Progress
2010-01-13
20 (System) IANA Action state changed to In Progress
2010-01-12
20 Amy Vezza IESG state changed to Approved-announcement sent
2010-01-12
20 Amy Vezza IESG has approved the document
2010-01-12
20 Amy Vezza Closed "Approve" ballot
2010-01-11
20 (System) New version available: draft-ietf-sasl-gs2-20.txt
2010-01-08
19 (System) New version available: draft-ietf-sasl-gs2-19.txt
2009-12-04
20 (System) Removed from agenda for telechat - 2009-12-03
2009-12-03
20 Cindy Morgan State Changes to Approved-announcement sent::Point Raised - writeup needed from IESG Evaluation by Cindy Morgan
2009-12-03
20 Lisa Dusseault [Ballot Position Update] New position, No Objection, has been recorded by Lisa Dusseault
2009-12-03
20 Ross Callon [Ballot Position Update] New position, No Objection, has been recorded by Ross Callon
2009-12-03
20 Jari Arkko [Ballot Position Update] New position, No Objection, has been recorded by Jari Arkko
2009-12-03
20 Tim Polk [Ballot Position Update] New position, No Objection, has been recorded by Tim Polk
2009-12-02
20 Cullen Jennings [Ballot Position Update] New position, No Objection, has been recorded by Cullen Jennings
2009-12-02
20 Russ Housley [Ballot comment]
Several editorial improvements were suggested in the Gen-ART Review
  by Spencer Dawkins.  Please consider them.
2009-12-02
20 Russ Housley [Ballot Position Update] New position, No Objection, has been recorded by Russ Housley
2009-12-02
20 Ron Bonica [Ballot Position Update] New position, No Objection, has been recorded by Ron Bonica
2009-12-02
20 Alexey Melnikov
[Ballot comment]
I am agreeing with Adrian's comment.

From SecDir review:

OLD:
  GS2 does not use any GSS-API per-message tokens.  Therefore the
  setting …
[Ballot comment]
I am agreeing with Adrian's comment.

From SecDir review:

OLD:
  GS2 does not use any GSS-API per-message tokens.  Therefore the
  setting of req_flags related to per-message tokens is irrelevant.

NEW:
  GS2 does not use any GSS-API per-message tokens.  Therefore the
  per-message token ret_flags from GSS_Init_sec_context() and
  GSS_Accept_sec_context() are irrelevant; implementations SHOULD NOT
  set the per-message req_flags.


Nico has suggested to add:

    FLAG SERVER CB SUPPORT DISPOSITION
    ---- ----------------- -----------

    n Irrelevant If server disallows non-channel-
                                        bound authentication, then fail

    y CB not supported Authentication may succeed

    y CB supported Authentication must fail

    p CB supported Authentication may succeed, with
                                        CB used

    p CB not supported Authentication will fail

    CB not supported Client does not even try because
                                        it insists on CB
2009-12-02
20 Dan Romascanu [Ballot Position Update] New position, No Objection, has been recorded by Dan Romascanu
2009-12-01
20 Robert Sparks [Ballot comment]
Is [tls-unique] pointing to the IANA registry? If so, could it include a link?
2009-12-01
20 Robert Sparks [Ballot Position Update] New position, No Objection, has been recorded by Robert Sparks
2009-11-30
20 Magnus Westerlund [Ballot Position Update] New position, No Objection, has been recorded by Magnus Westerlund
2009-11-30
20 Ralph Droms [Ballot Position Update] New position, No Objection, has been recorded by Ralph Droms
2009-11-30
20 Ralph Droms [Ballot comment]
Nits:

The third para of the Introduction, s/The "Kerberos/the "Kerberos/

Section 3.2, s/obliterate/eliminates/

Section 5.1, s/takes a/take a/
2009-11-28
20 Samuel Weiler Request for Last Call review by SECDIR Completed. Reviewer: Glen Zorn.
2009-11-27
20 Adrian Farrel [Ballot Position Update] Position for Adrian Farrel has been changed to No Objection from Discuss by Adrian Farrel
2009-11-27
20 Adrian Farrel
[Ballot comment]
Section 10.1 - nit
      OM_uint32 gss_inquire_saslname_for_mech(
        OM_uint32    *minor_status,
        const gss_OID  desired_mech, …
[Ballot comment]
Section 10.1 - nit
      OM_uint32 gss_inquire_saslname_for_mech(
        OM_uint32    *minor_status,
        const gss_OID  desired_mech,
        gss_buffer_t  sasl_mech_name,
        gss_buffer_t  mech_name,
        gss_buffer_t  mech_description,
      );
Superfluous comma after mech_description.
2009-11-27
20 Adrian Farrel
[Ballot discuss]
Discuss-Discuss

I had formed the opinion that we frowned upon the inclusion of URLs in
general and specifically those that might not be …
[Ballot discuss]
Discuss-Discuss

I had formed the opinion that we frowned upon the inclusion of URLs in
general and specifically those that might not be stable.

This document includes such a URL in the Abstract

I'd like to hear the opinions of other ADs about whether this is a good
idea before clearing during the telechat.
2009-11-27
20 Adrian Farrel [Ballot Position Update] New position, Discuss, has been recorded by Adrian Farrel
2009-11-23
20 Alexey Melnikov [Ballot Position Update] New position, Recuse, has been recorded by Alexey Melnikov
2009-11-23
20 Pasi Eronen State Changes to IESG Evaluation from Waiting for AD Go-Ahead by Pasi Eronen
2009-11-23
20 Pasi Eronen Placed on agenda for telechat - 2009-12-03 by Pasi Eronen
2009-11-23
20 Pasi Eronen [Ballot Position Update] New position, Yes, has been recorded for Pasi Eronen
2009-11-23
20 Pasi Eronen Ballot has been issued by Pasi Eronen
2009-11-23
20 Pasi Eronen Created "Approve" ballot
2009-11-19
18 (System) New version available: draft-ietf-sasl-gs2-18.txt
2009-11-18
20 Amanda Baber
IANA questions/comments:


- Are you requesting that GS2-KRB5 and GS2-KRB5-PLUS be registered?

- Are you asking us to register SPNEGO somewhere?

Upon approval of this …
IANA questions/comments:


- Are you requesting that GS2-KRB5 and GS2-KRB5-PLUS be registered?

- Are you asking us to register SPNEGO somewhere?

Upon approval of this document, IANA will make the following
assignment in the "SIMPLE AUTHENTICATION AND SECURITY LAYER (SASL)
MECHANISMS" registry 1t
http://www.iana.org/assignments/sasl-mechanisms

MECHANISMS USAGE REFERENCE OWNER
---------- ----- --------- -----
GS2-* COMMON [RFC-ietf-sasl-gs2-17] iesg@ietf.org
2009-11-18
20 (System) State has been changed to Waiting for AD Go-Ahead from Revised ID Needed by system
2009-11-02
20 Samuel Weiler Request for Last Call review by SECDIR is assigned to Glen Zorn
2009-11-02
20 Samuel Weiler Request for Last Call review by SECDIR is assigned to Glen Zorn
2009-10-30
20 Pasi Eronen State Changes to In Last Call::Revised ID Needed from In Last Call by Pasi Eronen
2009-10-30
20 Pasi Eronen
Although the IETF last call doesn't end until 2009-11-18, I'm
hoping the authors submit a revised ID during the IETF week
to address the comments …
Although the IETF last call doesn't end until 2009-11-18, I'm
hoping the authors submit a revised ID during the IETF week
to address the comments received at that point.
2009-10-26
20 Amy Vezza Last call sent
2009-10-26
20 Amy Vezza State Changes to In Last Call from Last Call Requested by Amy Vezza
2009-10-26
20 Amy Vezza State Changes to Last Call Requested from AD Evaluation by Amy Vezza
2009-10-26
20 Amy Vezza Last Call was requested by Amy Vezza
2009-10-26
20 (System) Ballot writeup text was added
2009-10-26
20 (System) Last call text was added
2009-10-26
20 (System) Ballot approval text was added
2009-10-16
20 Pasi Eronen State Changes to AD Evaluation from Publication Requested by Pasi Eronen
2009-10-16
20 Pasi Eronen [Note]: 'Alexey Melnikov (alexey.melnikov@isode.com) is the document shepherd' added by Pasi Eronen
2009-10-02
20 Cindy Morgan State Changes to Publication Requested from AD is watching by Cindy Morgan
2009-10-02
20 Cindy Morgan
(1.a) Who is the Document Shepherd for this document? Has the
Document Shepherd personally reviewed this version of the
document and, in particular, does he …
(1.a) Who is the Document Shepherd for this document? Has the
Document Shepherd personally reviewed this version of the
document and, in particular, does he or she believe this
version is ready for forwarding to the IESG for publication?

Alexey Melnikov  is the document shepherd
for this document.
The document is ready for publication.

(1.b) Has the document had adequate review both from key WG members
and from key non-WG members? Does the Document Shepherd have
any concerns about the depth or breadth of the reviews that
have been performed?

This document was reviewed by several active and experienced SASL WG members.
So there are no concerns about the depth of the reviews.

(1.c) Does the Document Shepherd have concerns that the document
needs more review from a particular or broader perspective,
e.g., security, operational complexity, someone familiar with
AAA, internationalization or XML?

No concerns.

(1.d) Does the Document Shepherd have any specific concerns or
issues with this document that the Responsible Area Director
and/or the IESG should be aware of? For example, perhaps he
or she is uncomfortable with certain parts of the document, or
has concerns whether there really is a need for it. In any
event, if the WG has discussed those issues and has indicated
that it still wishes to advance the document, detail those
concerns here. Has an IPR disclosure related to this document
been filed? If so, please include a reference to the
disclosure and summarize the WG discussion and conclusion on
this issue.

No specific concerns. No IPR disclosure was filed for this document.

(1.e) How solid is the WG consensus behind this document? Does it
represent the strong concurrence of a few individuals, with
others being silent, or does the WG as a whole understand and
agree with it?

There is solid WG consensus behind the document.

(1.f) Has anyone threatened an appeal or otherwise indicated extreme
discontent? If so, please summarise the areas of conflict in
separate email messages to the Responsible Area Director. (It
should be in a separate email because this questionnaire is
entered into the ID Tracker.)
No.

(1.g) Has the Document Shepherd personally verified that the
document satisfies all ID nits? (See
http://www.ietf.org/ID-Checklist.html and
http://tools.ietf.org/tools/idnits/). Boilerplate checks are
not enough; this check needs to be thorough. Has the document
met all formal review criteria it needs to, such as the MIB
Doctor, media type and URI type reviews?

idnits 2.11.14 was used to verify the document.
It reported 1 obsolete informational reference which is intentional.
(It also reported an outdated reference to draft-ietf-sasl-scram,
which can be fixed by RFC Editor.)

(1.h) Has the document split its references into normative and
informative? Are there normative references to documents that
are not ready for advancement or are otherwise in an unclear
state? If such normative references exist, what is the
strategy for their completion? Are there normative references
that are downward references, as described in [RFC3967]? If
so, list these downward references to support the Area
Director in the Last Call procedure for them [RFC3967].

There is one downward normative reference in the document ([tls-unique])
that points to an IANA registration.

(1.i) Has the Document Shepherd verified that the document IANA
consideration section exists and is consistent with the body
of the document? If the document specifies protocol
extensions, are reservations requested in appropriate IANA
registries? Are the IANA registries clearly identified? If
the document creates a new registry, does it define the
proposed initial contents of the registry and an allocation
procedure for future registrations? Does it suggest a
reasonable name for the new registry? See [RFC2434]. If the
document describes an Expert Review process has Shepherd
conferred with the Responsible Area Director so that the IESG
can appoint the needed Expert during the IESG Evaluation?

IANA considerations section exists, it adds 4 SASL mechanism registrations,
as well as puts some restrictions on registrations ending with "-PLUS" or
starting with "GS2-".

(1.j) Has the Document Shepherd verified that sections of the
document that are written in a formal language, such as XML
code, BNF rules, MIB definitions, etc., validate correctly in
an automated checker?

ABNF in the document was verified by BAP. It reported no errors.

(1.k) The IESG approval announcement includes a Document
Announcement Write-Up. Please provide such a Document
Announcement Write-Up? Recent examples can be found in the
"Action" announcements for approved documents. The approval
announcement contains the following sections:

Technical Summary
Relevant content can frequently be found in the abstract
and/or introduction of the document. If not, this may be
an indication that there are deficiencies in the abstract
or introduction.

This document describes how to use a Generic Security Service
Application Program Interface (GSS-API) mechanism in the the Simple
Authentication and Security Layer (SASL) framework. This is done by
defining a new SASL mechanism family, called GS2. This mechanism
family offers a number of improvements over the previous "SASL/
GSSAPI" mechanism: it is more general, uses fewer messages for the
authentication phase in some cases, and supports negotiable use of
channel binding. Only GSS-API mechanisms that support channel
binding are supported.


Working Group Summary
Was there anything in WG process that is worth noting? For
example, was there controversy about particular points or
were there decisions where the consensus was particularly
rough?

The document went through several redesign phases, which resulted in
drastic change in on the wire representation.
However it represents strong WG consensus.

There were significant and long discussions over channel binding type
negotiation.
After long considerations, it
was decided to leave channel binding type negotiation external to
GS2- and to provide a default of tls-unique. This simplify the
design and makes it easy to implement in popular configurations (i.e.,
together with TLS). I believe that today this has strong support in
the WG.

There was also a recent discussion about IANA registration procedure
for SASL mechanisms starting with GS2- prefix. The discussion resulted
in consensus that the document is correct as written.

Document Quality
Are there existing implementations of the protocol? Have a
significant number of vendors indicated their plan to
implement the specification? Are there any reviewers that
merit special mention as having done a thorough review,
e.g., one that resulted in important changes or a
conclusion that the document had no substantive issues? If
there was a MIB Doctor, Media Type or other expert review,
what was its course (briefly)? In the case of a Media Type
review, on what date was the request posted?

At least a couple (both clients and server) implementations of the
document are planned.

Personnel
Who is the Document Shepherd for this document? Who is the
Responsible Area Director?

Alexey Melnikov  is the document shepherd
for this document.
2009-10-02
20 Cindy Morgan State Change Notice email list have been change to sasl-chairs@tools.ietf.org, simon@josefsson.org, alexey.melnikov@isode.com from sasl-chairs@tools.ietf.org, simon@josefsson.org
2009-10-02
20 Cindy Morgan [Note]: 'Alexey Melnikov (alexey.melnikov@isode.com) is the document shepherd' added by Cindy Morgan
2009-09-09
17 (System) New version available: draft-ietf-sasl-gs2-17.txt
2009-08-04
16 (System) New version available: draft-ietf-sasl-gs2-16.txt
2009-07-31
15 (System) New version available: draft-ietf-sasl-gs2-15.txt
2009-06-27
14 (System) New version available: draft-ietf-sasl-gs2-14.txt
2009-05-26
13 (System) New version available: draft-ietf-sasl-gs2-13.txt
2009-04-23
20 Pasi Eronen State Changes to AD is watching from Dead by Pasi Eronen
2009-04-18
12 (System) New version available: draft-ietf-sasl-gs2-12.txt
2009-03-23
11 (System) New version available: draft-ietf-sasl-gs2-11.txt
2009-01-14
20 (System) State Changes to Dead from AD is watching by system
2009-01-14
20 (System) Document has expired
2008-07-22
20 Pasi Eronen State Changes to AD is watching from Dead by Pasi Eronen
2008-07-13
10 (System) New version available: draft-ietf-sasl-gs2-10.txt
2008-04-11
20 (System) State Changes to Dead from AD is watching by system
2008-04-11
20 (System) Document has expired
2008-03-27
20 Pasi Eronen State Changes to AD is watching from AD Evaluation::Revised ID Needed by Pasi Eronen
2008-03-27
20 Pasi Eronen Sent back to WG at chairs' request
2008-03-18
20 Pasi Eronen Responsible AD has been changed to Pasi Eronen from Sam Hartman
2007-11-29
20 Sam Hartman State Changes to AD Evaluation::Revised ID Needed from AD Evaluation::AD Followup by Sam Hartman
2007-10-09
20 (System) Sub state has been changed to AD Follow up from New Id Needed
2007-10-09
09 (System) New version available: draft-ietf-sasl-gs2-09.txt
2007-09-06
20 Sam Hartman State Changes to AD Evaluation::Revised ID Needed from Publication Requested by Sam Hartman
2007-07-25
20 Sam Hartman [Note]: 'proto shepherd: Kurt.Zeilenga@Isode.com' added by Sam Hartman
2007-07-25
20 Sam Hartman


  (1.a)  Who is the Document Shepherd for this document?  Has the
          Document Shepherd personally reviewed this version of the …


  (1.a)  Who is the Document Shepherd for this document?  Has the
          Document Shepherd personally reviewed this version of the
          document and, in particular, does he or she believe this
          version is ready for forwarding to the IESG for publication?

        Kurt Zeilenga
        Yes.

  (1.b)  Has the document had adequate review both from key WG members
          and from key non-WG members?  Does the Document Shepherd have
          any concerns about the depth or breadth of the reviews that
          have been performed?

        Yes.  Yes.  As the SASL and GSSAPI communities are relatively small,
        I tend to have some concerns with any document produced by these
        communities.  However, though small, the communities level of
        expertise is strong and broad.

  (1.c)  Does the Document Shepherd have concerns that the document
          needs more review from a particular or broader perspective,
          e.g., security, operational complexity, someone familiar with
          AAA, internationalization, or XML?

        The document would likely benefit from secdir and genart reviews.

  (1.d)  Does the Document Shepherd have any specific concerns or
          issues with this document that the Responsible Area Director
          and/or the IESG should be aware of?  For example, perhaps he
          or she is uncomfortable with certain parts of the document,
or
          has concerns whether there really is a need for it.  In any
          event, if the WG has discussed those issues and has indicated
          that it still wishes to advance the document, detail those
          concerns here.  Has an IPR disclosure related to this
document
          been filed?  If so, please include a reference to the
          disclosure and summarize the WG discussion and conclusion on
          this issue.

        No.

  (1.e)  How solid is the WG consensus behind this document?  Does it
          represent the strong concurrence of a few individuals, with
          others being silent, or does the WG as a whole understand and
          agree with it?

        Strong.

  (1.f)  Has anyone threatened an appeal or otherwise indicated
extreme
          discontent?  If so, please summarize the areas of conflict in
          separate email messages to the Responsible Area Director.
(It
          should be in a separate email because this questionnaire is
          entered into the ID Tracker.)

        No.

  (1.g)  Has the Document Shepherd personally verified that the
          document satisfies all ID nits?  (See
          http://www.ietf.org/ID-Checklist.html and
          http://tools.ietf.org/tools/idnits/.)  Boilerplate checks are
          not enough; this check needs to be thorough.  Has the
document
          met all formal review criteria it needs to, such as the MIB
          Doctor, media type, and URI type reviews?  If the document
          does not already indicate its intended status at the top of
          the first page, please indicate the intended status here.

        Yes.

  (1.h)  Has the document split its references into normative and
          informative?  Are there normative references to documents
that
          are not ready for advancement or are otherwise in an unclear
          state?  If such normative references exist, what is the
          strategy for their completion?  Are there normative
references
          that are downward references, as described in [RFC3967]?  If
          so, list these downward references to support the Area
          Director in the Last Call procedure for them [RFC3967].

        References are okay.

  (1.i)  Has the Document Shepherd verified that the document's IANA
          Considerations section exists and is consistent with the body
          of the document?  If the document specifies protocol
          extensions, are reservations requested in appropriate IANA
          registries?  Are the IANA registries clearly identified?  If
          the document creates a new registry, does it define the
          proposed initial contents of the registry and an allocation
          procedure for future registrations?  Does it suggest a
          reasonable name for the new registry?  See [RFC2434].  If the
          document describes an Expert Review process, has the Document
          Shepherd conferred with the Responsible Area Director so that
          the IESG can appoint the needed Expert during IESG
Evaluation?

        IANA considerations section is okay.

        Registration of GS2- does requires expert review.  I'm willing to serve
        as the expert.

  (1.j)  Has the Document Shepherd verified that sections of the
          document that are written in a formal language, such as XML
          code, BNF rules, MIB definitions, etc., validate correctly in
          an automated checker?

        N/A

  (1.k)  The IESG approval announcement includes a Document
          Announcement Write-Up.  Please provide such a Document
          Announcement Write-Up.  Recent examples can be found in the
          "Action" announcements for approved documents.  The approval
          announcement contains the following sections:

          Technical Summary
                This document describes how to use GSS-API mechanisms
                in SASL.  The document specifies a family of SASL
                mechanisms, GS2, which each GSS-API is mapped into.
                The mechanisms of the GS2 family replace previously
                defined SASL mechanisms for particular GSS-API mechanisms,
                including the Kerberos V "GSSAPI" mechanism.

          Working Group Summary
                The SASL WG has strong consensus that the GS2 is the
                right approach moving forward.  The WG worked closely
                with members of the GSS-API and Kerberos communities
                to ensure the approach is technically sound.

          Document Quality
                Multiple vendors have indicated they plan to implement
                this specification.  The document has been reviewed by
                lead developers for commonly used SASL framework products.

          Personnel
                Shepherd: Kurt Zeilenga
                Responsible AD: Sam Hartman

                IANA expert required for registration of GS2-*.  I am
                willing to serve as the expert.
2007-07-25
20 Sam Hartman Draft Added by Sam Hartman in state Publication Requested
2007-03-29
08 (System) New version available: draft-ietf-sasl-gs2-08.txt
2007-03-01
07 (System) New version available: draft-ietf-sasl-gs2-07.txt
2007-02-09
06 (System) New version available: draft-ietf-sasl-gs2-06.txt
2007-01-09
05 (System) New version available: draft-ietf-sasl-gs2-05.txt
2006-12-07
04 (System) New version available: draft-ietf-sasl-gs2-04.txt
2006-10-25
03 (System) New version available: draft-ietf-sasl-gs2-03.txt
2006-07-13
02 (System) New version available: draft-ietf-sasl-gs2-02.txt
2006-06-28
01 (System) New version available: draft-ietf-sasl-gs2-01.txt
2006-02-14
00 (System) New version available: draft-ietf-sasl-gs2-00.txt