Draft: draft-ietf-gnap-core-protocol

Commentary: Deploy Preview for gnap - core - protocol - editors - draft ready ! Built Explore the source changes : Inspect the deploy log : Browse the preview : 
 I do like that this requirement goes away . Now , assuming we do n't have it anymore ... why do n't make it available through the sever 's discovery information ? Furthermore , you might want to have all examples / references with to be consistent as right now it does n't appear to be true . 
 It is still allowed and even intended that you can return different management URIs per token , so putting it in the discovery document is not reasonable . The client needs to be ready to take any value handed back in this space at runtime , and that 's up to the AS 's discretion . 
 I understand that the AS can return different management URIs and the clients should " obey " that . Although , in the most simple use cases , you can definitely make a life a bit easier for certain types of clients and do n't require them to store somewhere an extra piece of the information along with ATs or even without them ... For example , for the latter , should be a client on an RS ' side be able to revoke ATs and if so , how would it know where their mngt endpoints ? 
 A client would only be able to revoke an access token if the AS provides a management URI with the access token . It 's a significantly simpler model for clients if the information can only show up in one place , instead of potentially being in one place ( discovery doc ) and maybe being overridden at runtime ( token response ) . Nothing requires the client to store the information if they do n't want to revoke or rotate the tokens . An RS revoking an access token is outside the scope of this draft , but could be discussed in the  draft . ( I have n't heard a call for that functionality before , though it 's interesting . ) 
 I would love you guys to take care of as this is something I was failed to understand before but never brought to the table before as always considered it to be a minor detail . 
 I filed a new issue for that at ietf - wg - gnap / gnap - resource - servers , please add comments about the use case and utility there . Thank you ! 
 thank you , I will do that . Regarding the clients who obtain , store and use ATs , or in other words , these clients that do n't reside on RS ' side ... all those clients need to store information about the mngt URI along with ATs they have . This is just a bit of extra work and is n't a big deal at the first glance but let 's consider that client is implemented and deployed as something like a service / lambda function in one of the cloud providers without the luxury to ( easily ) store something say on the filesystem and/or with a bunch of requirements or specific restrictions on where and how things should be stored . This is the first thing . It 's still solvable ... yes , I agree ... but there is also another thing ; you are n't a developer of the client and your goal is to explain what should happen to dozens of other teams who might have a little interest and tell you they we want to have / store only ATs and the location of the AS as they used to work this way before with OAuth 2 , etc . are working on the " generic " GNAP client library for your most liked programming language and you want to provide a convenient API for its consumers taking into account that your client in some cases knows what 's the location of the token mngr URI and in some cases , it simply does n't 
 the client in ( 1 ) still needs to store the access token , which is a dynamic value . This is another dynamic value next to it . Your proposed optimization makes that case much more difficult because now the code needs to be able to pull the value either from the previously - configured place or the dynamic place , instead of always in the dynamic place . For the library in ( 2 ) it 's even more simple : the client never " knows " ahead of time what the URI is , it 's always told by the protocol , so the library always just handles it directly . But that 's only if you want to do the revocation / rotation for the client . You can ignore it entirely if all you want to store is the AS 's base URI and the token value . In both ( 1 ) and ( 2 ) , if the client does n't know how to deal with dynamic management URI values then it simply does n't deal with them . Yes , this is a different model from OAuth 2 , but that 's on purpose . Several of the major attacks against OAuth 2 ( like AS mix - up ) stem from the discovery document containing a bunch of different URLs that the client needs to knit together to make a single picture of the AS . 
 Multiple Access Tokens : Editor 's note : Do we need to specify that the management URIs are different if we require the token to be presented ? 
 I think we can actually remove this requirement , or make this a MAY ; as long as the URI is required in the response , it 's up to the AS how to manage things ; we do want to say that it ca n't contain the access token value itself 
 Interacting with the User : Editor 's note : There need to be more examples ( Appendix C ) that knit together the interaction modes into common flows , like an authz - code equivalent . But it 's important for the protocol design that these are separate pieces to allow such knitting to take place . 
 There are actually more examples that have been documented ( sequences and appendix ) , seems enough for now .
Paragraph (version A):
If token-management is allowed, each access token SHOULD have
different "manage" URIs.
Paragraph (version B):
The "manage" URI MUST NOT contain the access token "value".