Gestion des réseaux permis

Gérez les réseaux autorisés pour votre instance IBM Cloud® DNS Services à l'aide de l'interface utilisateur, du CLI ou de l'API.

Ajout de réseaux autorisés dans la console

DNS Services est un service mondial. Vous pouvez donc ajouter des réseaux permis (par exemple, un VPC) de n'importe quelle région IBM Cloud®. Cette demande ajoute le réseau à la zone DNS, ce qui lui donne accès à celle-ci. Vous pouvez ajouter jusqu'à 10 réseaux permis à une même zone DNS.

Les instances de serveur virtuel récemment créées sont automatiquement configurées pour utiliser des programmes de résolution DNS privés (161.26.0.7 et 161.26.0.8). La configuration des instances de serveur virtuel existantes de sorte à utiliser des programmes de résolution DNS privés peut prendre jusqu'à 3 minutes.

  1. Sélectionnez la zone voulue dans la table de la page Zones DNS.
  2. Sélectionnez l'onglet Réseaux permis.
  3. Cliquez sur Ajouter un réseau.
  4. Dans le menu Région du réseau du panneau qui apparaît, sélectionnez la région de votre réseau.
  5. Dans le menu Réseau qui apparaît, sélectionnez le réseau voulu.
  6. Cliquez sur Ajouter un réseau.

L'ajout du même VPC à deux zones DNS portant le même nom n'est pas autorisé.

Vous pouvez accéder à la page de présentation d'un VPC à partir de la section Permitted networks en cliquant sur le nom du VPC. Par exemple, dans l'image suivante, un clic sur demo-vpc permet d'accéder à la page d'aperçu du VPC nommé demo-vpc.

Lien du réseau autorisé vers la page de présentation du
vers un IBM VPC à partir de la section
réseaux autorisés*

Liste des réseaux autorisés dans la console

  1. Sélectionnez la zone voulue dans la table de la page Zones DNS.
  2. Sélectionnez l'onglet Réseaux permis.

Exemple de filtre
par
de compte ACL inter-comptes* Par défaut, la liste contient les réseaux autorisés qui ont été ajoutés à partir de votre compte en tant que propriétaire. Pour afficher les réseaux autorisés ajoutés par les utilisateurs de la liste de contrôle d'accès inter-comptes, vous pouvez utiliser un filtre en sélectionnant les ID de compte.

Vous pouvez sélectionner jusqu'à 5 ID de compte croisé.

Suppression d'un réseau autorisé dans la console

Dans la table des réseaux permis, cliquez sur l'icône Supprimer. Confirmez la suppression dans la boîte de dialogue qui apparaît.

Tant qu'un réseau permis existe dans une zone, vous ne pouvez pas supprimer celle-ci.

Gestion des réseaux autorisés à partir de l'interface de ligne de commande

Utilisez d'abord la commande ibmcloud dns instance-target pour définir l'instance DNS Services opérationnelle de la cible.

$ ibmcloud dns instances
Retrieving service instances for service 'dns-svcs' ...
OK

Name                 ID                                     Location   State    Service Name
DNS Services-km      ffffffff-b042-41fd-885e-000000000000   global     active   dns-svcs

$ ibmcloud dns instance-target "DNS Services-km"

Stockez l'ID de la zone dans une variable afin de pouvoir l'utiliser dans les commandes suivantes sans avoir à le saisir à chaque fois. Par exemple, pour stocker l'ID de zone dans une variable, exécutez cette commande :

DNS_ZONE_ID="example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae"

Ajout de réseaux autorisés à partir de l'interface de ligne de commande

Utilisez la commande ibmcloud dns permitted-network-add suivie de l'ID de zone pour ajouter un VPC aux réseaux permis de la zone. Suivez la procédure utilisée pour sélectionner une instance VPC pour l'ajouter aux réseaux permis.

$ ibmcloud dns permitted-network-add $DNS_ZONE_ID
Select Network Region
1. au-syd
2. br-sao
3. ca-tor
4. eu-de
5. eu-gb
6. jp-osa
7. jp-tok
8. us-east
9. us-south
Enter a number> 1
Network Region: US South
Select VPC Network
1. vpc-cli-example
2. vpc-g1-dal-pdns-datapath-test-not-delete
6. vpc-g2-dal-pdns-datapath-test-not-delete
Enter a number> 1
Adding permitted network for zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Name          vpc-cli-example
ID            ffffffff-f7c9-49ff-a8ca-000000000000
Type          vpc
VPC_CRN       crn:v1:bluemix:public:is:us-south:a/bcf1865e991345daf4d5f24ea90a5497::vpc:ffffffff-f7c9-49ff-a8ca-000000000000
State         ACTIVE
Created On    2020-04-10 10:06:24.99659547 +0000 UTC
Modified On   2020-04-10 10:06:24.99659547 +0000 UTC

Pour les futures demandes, l'ID obtenu dans la sortie est référencé en tant que PERMITTED_NETWORK_ID.

Récupérer un réseau autorisé à partir de la CLI

Utilisez la commande ibmcloud dns permitted-network suivie de l'ID de zone et de l'ID du réseau permis pour extraire les détails d'un réseau permis.

$ ibmcloud dns permitted-network $DNS_ZONE_ID $PERMITTED_NETWORK_ID
Getting permitted network 'ffffffff-f7c9-49ff-a8ca-000000000000' for zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Name          vpc-gen1-for-pdns-e2e-test01-do-not-delete
ID            ffffffff-f7c9-49ff-a8ca-000000000000
Type          vpc
VPC_CRN       crn:v1:bluemix:public:is:us-south:a/bcf1865e991345daf4d5f24ea90a5497::vpc:ffffffff-f7c9-49ff-a8ca-000000000000
State         ACTIVE
Created On    2020-04-10 10:06:24.99659547 +0000 UTC
Modified On   2020-04-10 10:06:24.99659547 +0000 UTC

Liste des réseaux autorisés à partir de l'interface de ligne de commande

Utilisez la commande ibmcloud dns permitted-networks suivie de l'ID de zone pour répertorier tous les réseaux permis.

$ ibmcloud dns permitted-networks $DNS_ZONE_ID
Listing permitted networks for zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Name                                         ID                                     Type   VPC_CRN                                                                                                          State
vpc-gen1-for-pdns-e2e-test01-do-not-delete   ffffffff-f7c9-49ff-a8ca-000000000000   vpc    crn:v1:bluemix:public:is:us-south:a/bcf1865e991345daf4d5f24ea90a5497::vpc:ffffffff-f7c9-49ff-a8ca-000000000000   ACTIVE

Suppression d'un réseau autorisé dans le CLI

Utilisez la commande ibmcloud dns permitted-network-remove suivie de l'ID de zone et de l'ID du réseau permis pour détacher le VPC de la zone.

$ ibmcloud dns permitted-network-remove $DNS_ZONE_ID $PERMITTED_NETWORK_ID
Really remove permitted network 'ffffffff-f7c9-49ff-a8ca-000000000000' from zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ? [y/N]> y
Removing permitted network 'ffffffff-f7c9-49ff-a8ca-000000000000' from zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Le retrait d'un réseau permis peut prendre jusqu'à 5 minutes. Si vous changez d'avis et souhaitez le rajouter à la liste des réseaux permis de la zone DNS, vous devez attendre que son retrait soit complet.

Gestion des réseaux autorisés avec l'API

Stockez d'abord le point d'extrémité de l'API dans une variable afin de pouvoir l'utiliser dans les demandes d'API sans avoir à taper à chaque fois l'URL complète. Par exemple, pour stocker le point d'extrémité de production dans une variable, exécutez cette commande :

DNSSVCS_ENDPOINT=https://api.dns-svcs.cloud.ibm.com

Pour vérifier que cette variable a été enregistrée, exécutez echo $DNSSVCS_ENDPOINT et assurez-vous que la réponse n'est pas vide.

Ajout de réseaux autorisés avec l'API

L'état initial d'une zone DNS est PENDING_NETWORK_ADD (en attente d'ajout de réseaux), car sa liste de réseaux permis est vide lorsqu'elle vient d'être créée. Son état passe à ACTIVE dès qu'un réseau permis est ajouté à sa liste.

Paramètres

  • DNSZONE_ID : lorsque vous créez une zone, son DNSZONE_ID est retourné dans la réponse en tant que valeur de l'attribut id.

Demande

curl -X POST \
         $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/permitted_networks \
         -H "Authorization: $TOKEN" \
         -d '{
             "type": "vpc",
             "permitted_network":{
                 "vpc_crn":"crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
             }
         }'

Réponse

{
    "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
    "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "permitted_network": {
        "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
    },
    "type": "vpc",
    "state": "ACTIVE"
}

Pour les futures demandes, l'ID obtenu dans la réponse plus haut sera référencé en tant que PERMITTED_NETWORK_ID.

Récupérer un réseau autorisé avec l'API

Obtenir les détails d'un réseau permis spécifique de votre instance en utilisant son ID.

Demande

curl -X GET \
         $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/permitted_networks/$PERMITTED_NETWORK_ID \
         -H "Authorization: $TOKEN"

Réponse

{
    "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
    "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "permitted_network": {
        "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
    },
    "type": "vpc",
    "state": "ACTIVE"
}

Liste des réseaux autorisés avec l'API

Lister tous les réseaux permis de votre zone DNS.

Demande

curl -X GET \
         $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/permitted_networks \
         -H "Authorization: $TOKEN"

Réponse

{
    "permitted_networks": [
        {
            "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
            "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
            "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
            "permitted_network": {
                "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
            },
            "type": "vpc",
            "state": "ACTIVE"
        }
    ]
}

Suppression d'un réseau autorisé avec l'API

Retirer un réseau permis spécifique de votre instance et détacher le VPC correspondant de la zone à laquelle il était lié.

Demande

curl -X DELETE \
         $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/permitted_networks/$PERMITTED_NETWORK_ID \
         -H "Authorization: $TOKEN"

Réponse

{
    "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
    "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "permitted_network": {
        "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
    },
    "type": "vpc",
    "state": "REMOVAL_IN_PROGRESS"
}

Le retrait d'un réseau permis peut prendre jusqu'à 5 minutes. Si vous changez d'avis et souhaitez le rajouter à la liste des réseaux permis de la zone DNS, vous devez attendre que son retrait soit complet.