Mac checksum failures

[mattheworiordan]

There are a multitude of reasons why these fail, but we should help users debug these issues:

• Ensure a URL to the help article is included in the error message (covered in https://github.com/ably/wiki/issues/142)
• Add more debugging hints to https://support.ably.io/solution/articles/3000067415-40101-request-mac-does-not-match
• Consider adding a token generation tool to the website for testing perhaps?

@SimonWoolf thoughts?

┆Issue is synchronized with this Jira Task by Unito

[paddybyers]

Do we know that people are doing home-grown token request generation? If so, do we know why?

[mattheworiordan]

Do we know that people are doing home-grown token request generation?

No, I don't think they are. But we've had a few people with Mac issues now... This last one turned out to be an Ably IOS bug though, but I believe @SimonWoolf was talking to a customer yesterday who had a different issue.

[SimonWoolf]

Was talking to two customers yesterday with token request issues --

• this guy why had the iOS bug (I was just waiting for him to confirm that the workaround of specifying a ttl when creating the token request fixed it before filing an ios bug, but then Matt beat me to it :) ) and
• this guy who somehow has the ttl in his token request disappear at some point between creating it with php and it being received by ably-js. This one I'm puzzled by -- afaics there's no room for it to go wrong on the php side, or the ably-js side, and it's hard to imagine a json serializer removing a ttl value from an object. Have filed ttl seems to be set to null in a created token request? ably-php#46 to keep track, but am not sure it's an ably-php issue.

Consider adding a token generation tool to the website for testing perhaps?

if we can fix the causes other than the secret being wrong, that'd probably be overkill. Agree with the other two.