1334a33400db9de65e49295b9591fc021a7cadae
howto/GeoFeed.md
| ... | ... | @@ -22,7 +22,7 @@ A GeoFeed is especially useful in distributed networks like DN42, where many nod |
| 22 | 22 | A concrete operational example of GeoFeed publication and integration within the RIPE Database was presented at RIPE 82 (see presentation below): |
| 23 | 23 | https://ripe82.ripe.net/presentations/84-RIPE82_geofeed.pdf |
| 24 | 24 | |
| 25 | -## GeoFeed file formats |
|
| 25 | +## GeoFeed file format |
|
| 26 | 26 | |
| 27 | 27 | **CSV Example**: |
| 28 | 28 | ```csv |
| ... | ... | @@ -32,39 +32,16 @@ fd42:1234::/48,FR,,, |
| 32 | 32 | ... |
| 33 | 33 | ``` |
| 34 | 34 | |
| 35 | -**JSON Example**: |
|
| 36 | -```json |
|
| 37 | -[ |
|
| 38 | - { |
|
| 39 | - "prefix": "172.20.0.0/24", |
|
| 40 | - "country_code": "FR", |
|
| 41 | - "region_code": "FR-ARA", |
|
| 42 | - "city": "LYON", |
|
| 43 | - "postal": 69123 |
|
| 44 | - }, |
|
| 45 | - { |
|
| 46 | - "prefix": "fd42:1234::/48", |
|
| 47 | - "country_code": "", |
|
| 48 | - "region_code": "", |
|
| 49 | - "city": "", |
|
| 50 | - "postal": 0 |
|
| 51 | - }, |
|
| 52 | - ... |
|
| 53 | -] |
|
| 54 | -``` |
|
| 55 | - |
|
| 56 | -> GeoFeed files can also be TXT or other simple text formats, but CSV/JSON is recommended for ease of parsing in scripts and automation tools. |
|
| 57 | - |
|
| 58 | 35 | ## How to publish a GeoFeed on DN42 ? |
| 59 | 36 | |
| 60 | 37 | 1. **Host your GeoFeed file** |
| 61 | 38 | The file must be accessible via HTTP or HTTPS (IPv4 and/or IPv6), either on DN42 or on clearnet. |
| 62 | 39 | 2. **Reference in the Registry** |
| 63 | - Add a `remarks: Geofeed <url>` attribute in your `inet(6)num` object to point to your hosted GeoFeed. |
|
| 40 | + Add a `geofeed: <url>` attribute in your `inet(6)num` object to point to your hosted GeoFeed. |
|
| 64 | 41 | Example DN42 WHOIS snippet: |
| 65 | 42 | ```rpsl |
| 66 | 43 | inetnum: 0.0.0.0/0 |
| 67 | - remarks: Geofeed http://example.dn42/geofeed.csv |
|
| 44 | + geofeed: http://example.dn42/geofeed.csv |
|
| 68 | 45 | ``` |
| 69 | 46 | |
| 70 | 47 | ## Best Practices |