Signing In
To begin using Quill, you need to sign in. This will grant Quill an access token that it will use when it creates posts on your website.
Authentication happens at a website that you choose, and you authorize Quill to be able to post on your website. If you are familiar with OAuth 2.0, you will recognize many of the concepts here.
When you sign in to Quill, you start by entering your URL. This URL delegates the various aspects of signing in and granting authorization to other services, which may or may not be part of your website.
Configuring Endpoints
To tell Quill where to find the endpoints it will need to log you in, you'll need to add some HTML tags to your home page.
Authorization Endpoint
The modern way to tell apps about your authorization endpoint is to publish an
IndieAuth Server Metadata
document and link to it from your home page. The metadata document declares your
authorization_endpoint and token_endpoint together, along with the
issuer that this app checks when you sign in.
<link rel="indieauth-metadata" href="https://example.com/.well-known/oauth-authorization-server">You can also declare the authorization endpoint on its own. You can create your own authorization endpoint, but it's easier to use an existing service such as IndieAuth.com. To delegate to IndieAuth.com, you can use the markup provided below.
<link rel="authorization_endpoint" href="https://indieauth.com/auth">Token Endpoint
If you publish an IndieAuth Server Metadata
document, your token_endpoint is declared there and you don't need a separate
<link> tag for it.
Otherwise, you can create your own token endpoint for your website which can issue access tokens when given an authorization code, but it's easier to use an existing service such as tokens.indieauth.com. To use this service as your token endpoint, use the markup provided below.
<link rel="token_endpoint" href="https://tokens.indieauth.com/token">Micropub Endpoint
You will need to create a Micropub endpoint for your website which can create posts on your site. Once you've created the Micropub endpoint, you can indicate its location using the markup below.
<link rel="micropub" href="https://example.com/micropub">The Creating a Micropub Endpoint tutorial will walk you through how to handle incoming POST requests from apps like this.
Continue to Creating Posts