certbot/certbot-dns-google/docs/api.rst

=================
API Documentation
=================

Certbot plugins implement the Certbot plugins API, and do not otherwise have an external API.
Google Cloud DNS Authenticator (#4581) Implement an Authenticator which can fulfill a dns-01 challenge using the Google Cloud DNS API. Applicable only for domains using Google Cloud DNS for DNS. Testing Done: * `tox -e py27` * `tox -e lint` * Manual testing: * Used `certbot certonly --dns-google -d`, specifying a credentials file as a command line argument. Verified that a certificate was successfully obtained without user interaction. * Used `certbot certonly --dns-google -d`, without specifying a credentials file as a command line argument. Verified that the user was prompted and that a certificate was successfully obtained. * Used `certbot certonly -d`. Verified that the user was prompted for a credentials file after selecting google interactively and that a certificate was successfully obtained. * Used `certbot renew --force-renewal`. Verified that certificates were renewed without user interaction. * Negative testing: * Path to non-existent credentials file. * Credentials file with unsafe permissions (644). * Domain name not registered to Google Cloud Platform account. 2017-05-17 14:26:26 -04:00			`=================`
			`API Documentation`
			`=================`

Remove DNS plugin API docs. (#7578) Replace DNS plugins' API documentation with a note that plugins adhere to certbot's plugin interface. 2019-11-22 15:58:06 -05:00			`Certbot plugins implement the Certbot plugins API, and do not otherwise have an external API.`