Skip to content

Commit

Permalink
Add IPLD gateway, pending spec review...
Browse files Browse the repository at this point in the history
...and some minor wording edits.

Ref #93
  • Loading branch information
EricLScace committed Apr 10, 2020
1 parent 0d7be91 commit 912d297
Showing 1 changed file with 3 additions and 17 deletions.
20 changes: 3 additions & 17 deletions content/guides/concepts/ipfs-gateway.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,25 +61,16 @@ The discussion above illustrated the use of read-only HTTP(S) gateways to fetch
| -----------: | :------- | :-- |
| HTTP | readable | Retrieve ipfs:// content (HTTP GET method) |
| | writeable | Write ipfs:// content (HTTP POST, PUT, DELETE methods) |
| IPNS | | Read/write ipns:// content |
| IPLD | | Read/write ipld:// content |
| IPNS | | Read/write ipns:// content |
| DWEB | | Read/write dweb:// content |


<!-- Explain exceptions in Limitations section -->



<!-- So far the above only describes HTTP gateways. Add material for custom URL protocols; e.g., ipns://{peerID}/{path} and dweb://{ipfs address}. See https://docs-beta.ipfs.io/how-to/address-ipfs-on-web/#dweb-addressing-in-brief -->

<!-- How does it relate to the rest of IPFS -->


## 4. When should a gateway be provided, where, and which type of gateway?

### 4.1 Firewalled networks
Running [IPFS Desktop](https://github.com/ipfs-shipyard/ipfs-desktop#ipfs-desktop) or a standalone IPFS node within a browser/tool triggers connection attempts to other IPFS peers.
Private network administrators may treat such connection attempts as potential security vulnerabilities.
IPFS gateway servers inside the private network and running a trusted code base provide an alternative architecture for read/write access to externally-hosted IPFS content.
IPFS gateway servers located inside the private network and running a trusted code base provide an alternative architecture for read/write access to externally-hosted IPFS content.

## 5. When not to employ a gateway

Expand All @@ -106,15 +97,10 @@ The public gateway ipfs.io serves as an independent reference for returned conte

Similarly, guarantee of proper behavior when writing content via a third-party HTTP(S) writable gateway requires a fetch of written content via a native IPFS node or the ipfs.io public gateway.


## 7. Implementation status
<!-- current state of technology -->
<!-- roadmap? -->

## 8. Use cases

## 9. Further details
<!-- where to learn more -->


<ContentStatus />

0 comments on commit 912d297

Please sign in to comment.