Update Test Drive docs with Identity

This commit is contained in:
Jessica Parsons 2017-09-22 09:27:26 -07:00
parent 1f06885a69
commit a890e0da29
3 changed files with 18 additions and 19 deletions

View File

@ -1,29 +1,28 @@
# Take a test drive # Take a test drive
You can easily try out Netlify CMS by running it on a pre-configured starter site. Our example in the [intro](/docs/intro) is the [Kaldi small business Hugo template](https://github.com/netlify-templates/kaldi-hugo-cms-template). Use the deploy button below to build and deploy your own copy of the repository: Netlify CMS can run in any frontend web environment, but the quickest way to try it out is by running it on a pre-configured starter site with Netlify. Our example here is the [Kaldi coffee company template](https://github.com/netlify-templates/one-click-hugo-cms). Use the button below to build and deploy your own copy of the repository:
[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/netlify-templates/kaldi-hugo-cms-template) [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/netlify-templates/one-click-hugo-cms&stack=cms)
## Authenticate with GitHub After clicking that button, youll authenticate with GitHub and choose a repository name, then Netlify will automatically clone the template and deploy it, bringing you to the site dashboard when the build is complete. Next, youll need to set up Netlify's [Identity](https://www.netlify.com/docs/identity) service to authorize users to log in to the CMS.
When the deploy completes, you can see your site, but in order to use the CMS, you'll need to set up authentication with GitHub. ## Adding users
First, register the site CMS as an authorized application with your GitHub account: 1. From the Netlify site dashboard, select the **Identity** tab, and you'll find that there are no users yet. By default, this site is set to accept users by invitation only, and even the site owner needs to be invited.
2. Select **Invite users**, enter your email address, and select Send.
3. Check your email for the invitation. It will be sent from `no-reply@netlify.com`.
1. Go to your account **Settings** page on GitHub, and click **Oauth Applications** under **Developer Settings** (or use [this shortcut](https://github.com/settings/developers)). ![Sample email subject line: You've been invited to join radiologist-amanda-53841.netlify.com](/img/email-subject.png?raw=true)
2. Click **Register a new application**.
3. For the **Authorization callback URL**, enter `https://api.netlify.com/auth/done`. The other fields can contain anything you want.
![GitHub Oauth Application setup example](/img/github-oauth.png?raw=true) 4. Click the link to accept the invite, and youll be directed to your new site, with a prompt to create a password.
When you complete the registration, you'll be given a **Client ID** and a **Client Secret** for the app. You'll need to add these to your Netlify project: !["Complete your signup" modal on the Kaldi coffee site](/img/create-password.png?raw=true)
1. Go to your [**Netlify dashboard**](https://app.netlify.com/) and click on your project. 5. Enter a password, sign in, and youll be directed straight to the CMS!
2. Click the **Settings** tab.
3. Click on the **Access control** tab, then scroll down to **OAuth**.
4. Under **Authentication providers**, click **Install Provider**.
5. Select GitHub and enter the **Client ID** and **Client Secret**, then save.
## Access the CMS Try adding and editing posts, or changing the content of the Products page. When you save, the changes will be pushed immediately to GitHub, triggering a build on Netlify, and updating the content on your site.
With the site deployed and authentication in place, you'll be able to enter the CMS by going to the URL of your new site and appending `/admin`. ## More paths to explore
- If youd like to learn more about how it all works, check out the [Intro](/docs/intro).
- To see how to integrate Netlify CMS into an existing project, go to the [Quick Start](/docs/quick-start).
- If youd like to change how users log in to your site, read up on [Netlify Identity service](https://www.netlify.com/docs/identity).

BIN
img/create-password.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 392 KiB

BIN
img/email-subject.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB