Création et téléchargement d'une carte routière

Vous pouvez télécharger un fichier de cartes routières personnalisées pour un contrôle granulaire des décisions de gestion du trafic. Les cartes de routage sont des fichiers JSON personnalisés qui mettent en correspondance des adresses IP (plages CIDR) avec des cibles de routage correspondant à des réponses dans des enregistrements DNS.

Étape 1 - Préparer le fichier de la feuille de route

Les cartes routières sont des fichiers JSON en texte brut créés localement avant d'être téléchargés sur IBM® NS1 Connect®. Notez que vous devez utiliser l'extension de fichier .json lorsque vous enregistrez vos fichiers.

Le fichier de la feuille de route utilise le format suivant. La version, les réseaux et les étiquettes sont nécessaires :

{
  "meta": {
    "version": 1
  },
  "map": [
    {
      "networks": [],
      "labels": []
    }
  ]
}
Zone Type de données Descriptif
meta objet Métadonnées
version entier (Obligatoire) Version du format de données de l'échange ; détermine la sémantique du reste de l'échange.
Note : La version 1 est la plus récente.
map tableau d'objets Chaque objet membre déclare un segment de la carte tel que défini par la liste des adresses réseau qu'il contient.
networks Tableau de chaînes (Obligatoire) IPv4 et/ou IPv6 adresses au format CIDR ; une définition de réseau unique peut inclure les adresses v4 et v6.
étiquettes Tableau de chaînes (Obligatoire) Tableau d'étiquettes associées aux réseaux. Il s'agit de chaînes arbitraires utilisées pour associer des réponses DNS à des segments de carte.
Remarque : l'ordre dans lequel vous énumérez les étiquettes est important, car il détermine l'ordre dans lequel les réponses sont émises. Par exemple, une liste ["b", "c", "a"] émet des réponses DNS pour "b" d'abord, puis "c", et enfin "a".
Exemple d'itinéraire

La carte suivante définit trois réseaux. Les étiquettes cibles hkg et sin sont appliquées au premier groupe de réseaux ( 192.168.10.0/24 à 192.168.60.0/24 ). L'utilisation de plusieurs étiquettes cibles permet d'appliquer les cartes d'itinéraires de manière plus large ; dans cet exemple, le premier groupe de réseaux s'applique aux régions géographiques de Hong Kong et de Singapour. L'étiquette cible nrt est appliquée au deuxième groupe de réseaux ( 192.168.132.0/24 à 192.168.144.0/24 ).

Draft comment: nadine.mootoo@ibm.com
update IPs https://ibmdocs-test.dcs.ibm.com/docs/en/ibm-style?topic=elements-web-ip-email-addresses#ipv4-addresses 

{
  "meta": {
    "version": 1
  },
  "map": [
    {
      "networks": [
        "192.168.10.0/24",
        "192.168.20.0/24",
        "192.168.40.0/24",
        "192.168.50.0/24",
        "192.168.60.0/24"
      ],
      "labels": ["hkg", "sin"]
    },
    {
      "networks": [
        "192.168.132.0/24",
        "192.168.133.0/24",
        "192.168.135.0/24",
        "192.168.144.0/20"
      ],
      "labels": ["nrt"]
    },
    {
      "networks": [
        "172.16.5.0/24",
        "172.16.1.0/24",
        "192.168.111.0/24",
        "fd0d:82a7:be8b:ae00::/56",
        "fde2:d85e:f372:7408::/64"
      ],
      "labels": ["syd"]
    }
  ]
}

Dans cet exemple, pour le premier groupe de réseaux, l'étiquette cible hkg est référencée en premier, car elle apparaît en premier dans le fichier cartographique. Si aucune réponse ne correspond aux métadonnées de hkg, l'étiquette suivante ( sin ) est référencée.

Étape 2 - Télécharger la carte de l'itinéraire

Suivez les instructions suivantes pour télécharger un fichier de carte routière à l'aide du portail NS1 Connect ou de l'API.

Téléchargement via le portail
  1. Dans le portail, naviguez jusqu'à la page Pulsar dans la navigation principale.
  2. Cliquez sur l'onglet Cartes d'itinéraires.
  3. Cliquez sur Ajouter un itinéraire.
  4. Saisissez un nom pour la feuille de route.
  5. Cliquez sur Parcourir et sélectionnez le fichier de la feuille de route.
  6. Cliquez sur Upload.
Remarque : le traitement du fichier de carte routière peut prendre quelques minutes.
Téléchargement via l'API

Si vous utilisez l'API, vous devez exécuter deux demandes d'API. La première demande crée les métadonnées de la carte routière en vue du téléchargement. La réponse contient des informations essentielles dont vous aurez besoin pour la deuxième demande, qui consiste à télécharger le fichier de la carte routière sur IBM NS1 Connect®.

Note : Vous avez besoin d'une clé API valide créée dans le portail NS1 Connect pour authentifier les requêtes API.

Tout d'abord, utilisez la requête GET ci-dessous pour créer les métadonnées de la feuille de route, en remplaçant <nom> par le nom de la feuille de route.

curl -X GET -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/pulsar/routemaps/create?name=<name>

Exemple de réponse :

{
  "customer": 0,
  "status": "uploading",
  "name": "example",
  "created": 0,
  "url": "https://s3.amazonaws.com/pulsar-routemap-uploads/example.json?...",
  "mapid": 0,
  "modified": 0
}
Attention : Enregistrez le site URL fourni dans la réponse ( https://s3.amazonaws.com/pulsar-routemap-uploads/... ) car vous en aurez besoin pour passer à l'étape suivante.

Deuxièmement, utilisez la demande suivante PUT pour télécharger le fichier de plan de route, en remplaçant <fileSize> par la taille du fichier de plan de route, <filePath> par le chemin d'accès au fichier de la feuille de route et <aws_url> par l'adresse unique URL fournie en réponse à la demande précédente.

curl -X PUT -L -H "Content-Length: <fileSize>" -H "Client-Encoding: UTF-8" -T "<filePath>" "<aws_url>"

Etapes suivantes

Configurez une adresse Filter Chain dans le(s) enregistrement(s) DNS concerné(s) en utilisant le filtre Route Map pour activer la configuration.