made some minor fixes in the markdown files
This commit is contained in:
parent
f246cf0b93
commit
b4df1e01f3
9
API.md
9
API.md
|
@ -9,7 +9,7 @@ Bootstrap Initialization
|
||||||
|
|
||||||
Before walnut is configured it starts up in a bootstrap mode with a single API exposed to set its primary domain.
|
Before walnut is configured it starts up in a bootstrap mode with a single API exposed to set its primary domain.
|
||||||
|
|
||||||
```
|
```bash
|
||||||
# Set up with example.com as the primary domain
|
# Set up with example.com as the primary domain
|
||||||
curl -X POST http://api.localhost.daplie.me:3000/api/walnut@daplie.com/init \
|
curl -X POST http://api.localhost.daplie.me:3000/api/walnut@daplie.com/init \
|
||||||
-H 'X-Forwarded-Proto: https' \
|
-H 'X-Forwarded-Proto: https' \
|
||||||
|
@ -51,6 +51,7 @@ where more information about a package can be found.
|
||||||
Template variables
|
Template variables
|
||||||
```
|
```
|
||||||
:package_name
|
:package_name
|
||||||
|
:package_version
|
||||||
```
|
```
|
||||||
|
|
||||||
```json
|
```json
|
||||||
|
@ -133,7 +134,7 @@ a matter of not putting ourselves in a box and finding out later that it's very,
|
||||||
very, very hard to open the box back up.
|
very, very hard to open the box back up.
|
||||||
|
|
||||||
`rest.js`:
|
`rest.js`:
|
||||||
```
|
```js
|
||||||
module.exports.create = function (conf, deps, app) {
|
module.exports.create = function (conf, deps, app) {
|
||||||
var API = require('./api.js');
|
var API = require('./api.js');
|
||||||
var REST = {
|
var REST = {
|
||||||
|
@ -148,7 +149,7 @@ module.exports.create = function (conf, deps, app) {
|
||||||
|
|
||||||
### Special methods for `app`:
|
### Special methods for `app`:
|
||||||
|
|
||||||
```
|
```js
|
||||||
app.handlePromise(request, response, promise, message);
|
app.handlePromise(request, response, promise, message);
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -183,7 +184,7 @@ req.oauth3.accountIdx // The system id of the account represented
|
||||||
|
|
||||||
Internal (and/or deprecated) APIs that you will very likely encounter
|
Internal (and/or deprecated) APIs that you will very likely encounter
|
||||||
|
|
||||||
```
|
```js
|
||||||
req.getSiteStore().then(function (models) {
|
req.getSiteStore().then(function (models) {
|
||||||
req.Models = models;
|
req.Models = models;
|
||||||
});
|
});
|
||||||
|
|
16
INSTALL.md
16
INSTALL.md
|
@ -35,7 +35,7 @@ my_domain=example.com
|
||||||
|
|
||||||
You can purchase a domain with daplie tools
|
You can purchase a domain with daplie tools
|
||||||
|
|
||||||
```
|
```bash
|
||||||
npm install -g git+https://git.daplie.com/Daplie/daplie-tools.git
|
npm install -g git+https://git.daplie.com/Daplie/daplie-tools.git
|
||||||
|
|
||||||
daplie domains:search -n $my_domain
|
daplie domains:search -n $my_domain
|
||||||
|
@ -91,7 +91,7 @@ Walnut must sit behind a proxy that properly terminates https and sets the `X-Fo
|
||||||
|
|
||||||
Goldilocks can do this, as well as manage daplie domains, tunneling, etc.
|
Goldilocks can do this, as well as manage daplie domains, tunneling, etc.
|
||||||
|
|
||||||
```
|
```bash
|
||||||
curl https://daplie.me/install-scripts | bash
|
curl https://daplie.me/install-scripts | bash
|
||||||
|
|
||||||
daplie-install-goldilocks
|
daplie-install-goldilocks
|
||||||
|
@ -186,7 +186,7 @@ We need to have a local login system.
|
||||||
|
|
||||||
For the APIs for that we`ll install the `issuer@oauth3.org` API package and enable it for `api.provider.example.com`:
|
For the APIs for that we`ll install the `issuer@oauth3.org` API package and enable it for `api.provider.example.com`:
|
||||||
|
|
||||||
```
|
```bash
|
||||||
# API packaged for walnut
|
# API packaged for walnut
|
||||||
git clone https://git.daplie.com/OAuth3/org.oauth3.provider.git /srv/walnut/packages/rest/issuer@oauth3.org
|
git clone https://git.daplie.com/OAuth3/org.oauth3.provider.git /srv/walnut/packages/rest/issuer@oauth3.org
|
||||||
pushd /srv/walnut/packages/rest/issuer@oauth3.org/
|
pushd /srv/walnut/packages/rest/issuer@oauth3.org/
|
||||||
|
@ -205,7 +205,7 @@ echo "issuer@oauth3.org" >> /srv/walnut/packages/client-api-grants/provider.$my_
|
||||||
|
|
||||||
For the user interface for that we'll install the `issuer@oauth3.org` site package and enable it
|
For the user interface for that we'll install the `issuer@oauth3.org` site package and enable it
|
||||||
|
|
||||||
```
|
```bash
|
||||||
# Frontend
|
# Frontend
|
||||||
git clone https://git.daplie.com/OAuth3/org.oauth3.git /srv/walnut/packages/pages/issuer@oauth3.org
|
git clone https://git.daplie.com/OAuth3/org.oauth3.git /srv/walnut/packages/pages/issuer@oauth3.org
|
||||||
pushd /srv/walnut/packages/pages/issuer@oauth3.org
|
pushd /srv/walnut/packages/pages/issuer@oauth3.org
|
||||||
|
@ -223,11 +223,11 @@ OAuth3 is currently configured to use mailgun for sending verification emails.
|
||||||
It is intended to provide a way to use various mail services in the future,
|
It is intended to provide a way to use various mail services in the future,
|
||||||
just bear with us for the time being (or open a Merge Request).
|
just bear with us for the time being (or open a Merge Request).
|
||||||
|
|
||||||
```
|
```bash
|
||||||
vim /srv/walnut/var/$my_domain/config.json
|
vim /srv/walnut/var/$my_domain/config.json
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
```json
|
||||||
{ "mailgun.org": {
|
{ "mailgun.org": {
|
||||||
"apiKey": "key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
"apiKey": "key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
||||||
, "apiPublicKey": "pubkey-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
, "apiPublicKey": "pubkey-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
||||||
|
@ -296,11 +296,11 @@ popd
|
||||||
|
|
||||||
You will need to change the authenication provider/issuer URL from `oauth3.org` to the domain you've selected (i.e. `provider.example.com`)
|
You will need to change the authenication provider/issuer URL from `oauth3.org` to the domain you've selected (i.e. `provider.example.com`)
|
||||||
|
|
||||||
```
|
```bash
|
||||||
vim /srv/walnut/packages/pages/seed@example.com/js/config.js
|
vim /srv/walnut/packages/pages/seed@example.com/js/config.js
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
```js
|
||||||
{ "azp@oauth3.org": { issuer_uri: 'provider.example.com', client_uri: 'example.com' } }
|
{ "azp@oauth3.org": { issuer_uri: 'provider.example.com', client_uri: 'example.com' } }
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
10
README.md
10
README.md
|
@ -19,7 +19,7 @@ Security Features
|
||||||
* disallows cookies, except for protected static assets
|
* disallows cookies, except for protected static assets
|
||||||
* api.* subdomain for apis
|
* api.* subdomain for apis
|
||||||
* assets.* subdomain for protected assets
|
* assets.* subdomain for protected assets
|
||||||
* *must* sit behind a trusted https proxy (such as [Goldilocks](https://git.daplie.com/Daplie/goldilocks.js)
|
* *must* sit behind a trusted https proxy (such as [Goldilocks](https://git.daplie.com/Daplie/goldilocks.js))
|
||||||
* HTTPS-only (checks for X-Forwarded-For)
|
* HTTPS-only (checks for X-Forwarded-For)
|
||||||
* AES, RSA, and ECDSA encryption and signing
|
* AES, RSA, and ECDSA encryption and signing
|
||||||
* Safe against CSRF, XSS, and SQL injection
|
* Safe against CSRF, XSS, and SQL injection
|
||||||
|
@ -53,14 +53,14 @@ Installation
|
||||||
|
|
||||||
We're still in a stage where the installation generally requires many manual steps.
|
We're still in a stage where the installation generally requires many manual steps.
|
||||||
|
|
||||||
See [INSTALL.md](https://git.daplie.com/Daplie/walnut.js/blob/master/INSTALL.md)
|
See [INSTALL.md](/INSTALL.md)
|
||||||
|
|
||||||
API
|
API
|
||||||
---
|
---
|
||||||
|
|
||||||
The API is still in flux, but you can take a peek anyway.
|
The API is still in flux, but you can take a peek anyway.
|
||||||
|
|
||||||
See [API.md](https://git.daplie.com/Daplie/walnut.js/blob/master/API.md)
|
See [API.md](/API.md)
|
||||||
|
|
||||||
Understanding Walnut
|
Understanding Walnut
|
||||||
====================
|
====================
|
||||||
|
@ -77,8 +77,8 @@ Understanding Walnut
|
||||||
├── node_modules
|
├── node_modules
|
||||||
├── packages
|
├── packages
|
||||||
│ ├── apis
|
│ ├── apis
|
||||||
| ├── pages
|
│ ├── pages
|
||||||
| ├── rest
|
│ ├── rest
|
||||||
│ └── services
|
│ └── services
|
||||||
└── var
|
└── var
|
||||||
└── sites
|
└── sites
|
||||||
|
|
Loading…
Reference in New Issue