Api referece - documentation about jwt-cpp HOT 7 CLOSED

Currently the only documentation are the example in README.md and the various testcases in *Test.cpp

from jwt-cpp.

:(

from jwt-cpp.

I almost forgot about it, but most of the methods are commented with doxygen comments and there is a doxygen config in the root. It's not really a complete documentation, but it might help.

from jwt-cpp.

Hello Thalhammer,

I have seen on several sites about the header "typ" parameter that must be configured as JWT.
For example: "typ" : "JWT"
But on RFC says:
"The "typ" (type) Header Parameter defined by [JWS] and [JWE] is used
by JWT applications" and " If present, it is RECOMMENDED that
its value be "JWT" to indicate that this object is a JWT."

In your examples you use "typ" : "JWS".

What would be the difference? What would be the correct use?

Thanks.

Best Regards

Paulo

from jwt-cpp.

@paulotovo According to the rfc that part is optional and should not be used by the jwt library.
It defines the media type and could be used to disabiguate if you expect not only jwt tokens to hit your app. JWT stands for Json Web Tokens and JWS for Json Web Signature which is a different, but very similar rfc. In 99% of cases it does not matter and the reason my test token uses JWS is simply a coincidence.

from jwt-cpp.

Continuing with the theme of API documentation/examples, the example given shows get_payload_claims() in this context:

      std::string token = "eyJhbGciOiJIUzI1...OkEE";
      auto decoded = jwt::decode(token);

      for( auto& e : decoded.get_payload_claims() )
          std::cout << e.first << " = " << e.second.to_json() << std::endl;

but, I don't find any definition of get_payload_claims() in class jwt::decoded_jwt<jwt::picojson_traits> or otherwise...

What am I missing here?

Thanks,

from jwt-cpp.

The current master is a getting ready for an release candidate, and rightfully so because it seem like get_payload_claims got removed during #71 by accident 😨

I would strongly recommend using the v0.4.0 release while the last few details get ironed out. ( I am using that in production code ) The method in question is available there.

Sorry for the inconvience!

from jwt-cpp.