hyn / lets-encrypt

A php wrapper for the let's encrypt SSL certificate signing processes

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Documentation?

picrap opened this issue · comments

Hi,

I am quite new to let's encrypt; do you have any documentation regarding your project?

Thanks.

My apologies for the late reply @picrap ; Let's Encrypt information can be found on their website; they provide easy python based installers for installing free SSL certificates. My project does not rely on any other language than PHP and is meant as a generic wrapper.

Development seems a bit stale here on Github, but that's mainly due to being implemented into my Laravel multi tenancy installation for testing.

I know the original project, I was asking about what your project does, and how to use it. Is it supposed to replace the acme callback?

It calls the ACME server and allows solving the challenges returned by Let's Encrypt, after which the certificate can be immediately used.

In fact, I'm close to have it automate the whole process via PHP and writing a file in docroot on one project and set a dns record on another.

If you want to discuss this project further you can find me on gitter most of the time.

This looks good 😄

I know ;) If you're able to test it out on your project in development, that would be great. I think it's really close to being production ready.

If it is working (or supposed to), I can test it. However, I still need a little help to get started. After installing, what am I supposed to do to start the certificate process?

Call all functionality manually. If you're not up to that level, await the documentation which will follow the release.

To me, a good integration would encapsulate all plumbing: make certificates creation and renew requests, so the only job required from the developpers would be:

  • Install your library
  • Setup the web server to support https

This is a generic wrapper. The implementation of a solver (write file to docroot, set dns record etc) would be up to the developer. I do include some basic solvers to give a hint into the right direction. But an actual implementation is based on so many factors it's hard to support all of them in a generic wrapper.

I wouldn't be surprised if more specific implementation will follow though.

@picrap Just to let you know, the terminal command tool will help you with what you asked for. I'll try to complete that these coming days.

Tagged version 0.1.1 which has a global composer command. Please check the readme.

If you have more specific questions, please create a new issue.