Add Oauth and Graphql sections
This commit is contained in:
@@ -24,6 +24,16 @@
|
|||||||
* [Overwritting](customization/overwritting.md)
|
* [Overwritting](customization/overwritting.md)
|
||||||
* [Adding new features](customization/new_features.md)
|
* [Adding new features](customization/new_features.md)
|
||||||
|
|
||||||
|
### Features
|
||||||
|
* [OAuth](features/oauth.md)
|
||||||
|
* [GraphQL](features/graphql.md)
|
||||||
|
|
||||||
|
* [Templating](customization/templating.md)
|
||||||
|
* [Texts & Translations](customization/translations.md)
|
||||||
|
* [Images](customization/images.md)
|
||||||
|
* [Overwritting](customization/overwritting.md)
|
||||||
|
* [Adding new features](customization/new_features.md)
|
||||||
|
|
||||||
### Open Source project
|
### Open Source project
|
||||||
* [Code of conduct](open_source/code_of_conduct.md)
|
* [Code of conduct](open_source/code_of_conduct.md)
|
||||||
* [Contributing](open_source/contributing.md)
|
* [Contributing](open_source/contributing.md)
|
||||||
|
|||||||
3
docs/en/features/graphql.md
Normal file
3
docs/en/features/graphql.md
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
# GraphQL
|
||||||
|
|
||||||
|
Until we move the documentation to here, you can check https://github.com/consul/consul/blob/master/doc/api/api_en.md
|
||||||
30
docs/en/features/oauth.md
Normal file
30
docs/en/features/oauth.md
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
# OAuth
|
||||||
|
|
||||||
|
You can configure authentication services with external OAuth suppliers, right now Twitter, Facebook and Google are supported.
|
||||||
|
|
||||||
|
## 1. Create an App on the platform
|
||||||
|
For each platform, go to their developers section and follow their guides to create an app.
|
||||||
|
|
||||||
|
## 2. Set your CONSUL's url
|
||||||
|
|
||||||
|
They'll ask you for your CONSUL's auth URL, and as you can see running `rake routes` at your CONSUL repo locally:
|
||||||
|
```bash
|
||||||
|
user_omniauth_authorize GET|POST /users/auth/:provider(.:format) users/omniauth_callbacks#passthru {:provider=>/twitter|facebook|google_oauth2/}
|
||||||
|
```
|
||||||
|
|
||||||
|
So for example the URL for facebook application would be `yourdomain.com/users/auth/facebook.json`
|
||||||
|
|
||||||
|
## 3. Set key & secret values
|
||||||
|
|
||||||
|
When you complete the application registration you'll get a *key* and *secret* values, those need to be stored at your `config/secrets.yml` file:
|
||||||
|
|
||||||
|
```yml
|
||||||
|
twitter_key: ""
|
||||||
|
twitter_secret: ""
|
||||||
|
facebook_key: ""
|
||||||
|
facebook_secret: ""
|
||||||
|
google_oauth2_key: ""
|
||||||
|
google_oauth2_secret: ""
|
||||||
|
```
|
||||||
|
|
||||||
|
*NOTE:* Also in the case of Google, verify that the APIs *Contacts API* and *Google+ API* are enabled for the application.
|
||||||
@@ -24,6 +24,10 @@
|
|||||||
* [Adaptar la aplicación](customization/overwritting.md)
|
* [Adaptar la aplicación](customization/overwritting.md)
|
||||||
* [Añadir nuevas funcionalidades](customization/new_features.md)
|
* [Añadir nuevas funcionalidades](customization/new_features.md)
|
||||||
|
|
||||||
|
### Funcionalidades
|
||||||
|
* [OAuth](features/oauth.md)
|
||||||
|
* [GraphQL](features/graphql.md)
|
||||||
|
|
||||||
### Proyecto Open Source
|
### Proyecto Open Source
|
||||||
* [Código de conducta](open_source/code_of_conduct.md)
|
* [Código de conducta](open_source/code_of_conduct.md)
|
||||||
* [Contribuciones](open_source/contributing.md)
|
* [Contribuciones](open_source/contributing.md)
|
||||||
|
|||||||
3
docs/es/features/graphql.md
Normal file
3
docs/es/features/graphql.md
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
# GraphQL
|
||||||
|
|
||||||
|
Hasta que movamos al documentación aquí, puedes usar https://github.com/consul/consul/blob/master/doc/api/api_es.md
|
||||||
31
docs/es/features/oauth.md
Normal file
31
docs/es/features/oauth.md
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
# OAuth
|
||||||
|
|
||||||
|
Puedes configurar la autenticación con servicios externos usando OAuth, por ahora están soportados Twitter, Facebook y Google.
|
||||||
|
|
||||||
|
## 1. Crea una aplicación en la plataforma
|
||||||
|
Para cada plataforma, sigue las instrucciones en la sección de desarrolladores de su página web.
|
||||||
|
|
||||||
|
## 2. Establece la url de tu CONSUL
|
||||||
|
|
||||||
|
Te preguntarán por la URL de autenticación de tu instalación de CONSUL, y como podrás comprobar corriendo la tarea `rake routes` en tu repositorio local:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
user_omniauth_authorize GET|POST /users/auth/:provider(.:format) users/omniauth_callbacks#passthru {:provider=>/twitter|facebook|google_oauth2/}
|
||||||
|
```
|
||||||
|
|
||||||
|
Por ejemplo para facebook la URL sería `yourdomain.com/users/auth/facebook.json`
|
||||||
|
|
||||||
|
## 3. Establece la clave y secreto
|
||||||
|
|
||||||
|
Cuando completes el registro de la aplicación en su plataforma te darán un *key* y *secret*, estos deben ser almacenados en tu fichero `config/secrets.yml`:
|
||||||
|
|
||||||
|
```yml
|
||||||
|
twitter_key: ""
|
||||||
|
twitter_secret: ""
|
||||||
|
facebook_key: ""
|
||||||
|
facebook_secret: ""
|
||||||
|
google_oauth2_key: ""
|
||||||
|
google_oauth2_secret: ""
|
||||||
|
```
|
||||||
|
|
||||||
|
*NOTA:* Además en el caso de Google, verifica que las APIs de *Contacts API* y *Google+ API* están habilitadas para tu aplicación en su plataforma.
|
||||||
Reference in New Issue
Block a user