Access to sni-endpoints API

[maxehmookau]

The new sni-endpoints API appears to be available (albeit in beta) and is being used by the production dashboard at heroku.com.

Is there a general policy against including beta endpoints in the ruby gem? If not, I'll happily put together a PR to add this functionality.

[jalada]

I've forked the code and re-ran the build against the beta schema: https://github.com/jalada/platform-api

[geemus]

Historically we have left out non-GA stuff from the gem (as it isn't in the core schema yet). I wouldn't go so far to say that this was a policy, so much as coincidence of tooling. I don't think we could really automate this reasonably, since some variants actually change behavior of existing endpoints it would be weird trying to merge them. That said, this may be reflective of it just being about time for us to bring this out of variant and into the main schema. Does that help/make sense?

[maxehmookau]

@geemus Seems fair. Yep, it makes sense. I'm also an idiot because I didn't realise you could pass custom headers using this gem.

Thanks!

[geemus]

@maxehmookau hey, there are many parts of this gem that are (unfortunately) less than obvious right now. Definitely appreciate your understanding and definitely let us know (or PR) if there are some good fixes to docs or other things to improve the clarity. Thanks!

[chriso0710]

If I understand correctly: As long as the new features "http-sni" and "sni-endpoints" are in beta, they won't be implemented in the api?

So to use the new features I would do something like
letsencrypt-heroku does kind of "manually" with httparty:
https://github.com/substrakt/letsencrypt-heroku/blob/master/lib/certificate_generation.rb#L78

Thanks!

[maxehmookau]

@chriso0710, letsencrypt-heroku uses HTTParty although it probably shouldn't since you can set those manual headers using this gem anyway.

https://github.com/heroku/platform-api#passing-custom-headers

[jalada]

@maxehmookau yes, but that's not enough to access endpoints that aren't in the schema generated when packaging up this gem, because the method isn't defined, right?

[maxehmookau]

Ah yeah, you are right.

Then letsencrypt-heroku will have to remain using HTTParty for now then.

[chriso0710]

Thanks, guys!

IMHO the new SNI/SSL feature is really huge and could be worth implementing it as beta into the api.
For now I will use the same method which letsenrypt-heroku uses.
If the new features will become GA and supported by the platform-api, then I will (and should) probably switch.

[geemus]

For now, yes, you need in some capacity to explicitly set the headers. The method described should work, as would other http-libraries used directly (I'm partial to excon/excon), but unfortunately it lacks some of the convenience and syntactic sugar provided by platform-api.

[jalada]

Now that SNI-based SSL is out of beta will this be supported?

[dmathieu]

Yes. You can find it here: https://devcenter.heroku.com/articles/platform-api-reference#sni-endpoint