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.
- Sélectionnez la zone voulue dans la table de la page Zones DNS.
- Sélectionnez l'onglet Réseaux permis.
- Cliquez sur Ajouter un réseau.
- Dans le menu Région du réseau du panneau qui apparaît, sélectionnez la région de votre réseau.
- Dans le menu Réseau qui apparaît, sélectionnez le réseau voulu.
- Cliquez sur Ajouter un réseau.
L'ajout du même VPC à deux zones DNS portant le même nom n'est pas autorisé.
Liste des réseaux autorisés dans la console
- Sélectionnez la zone voulue dans la table de la page Zones DNS.
- Sélectionnez l'onglet Réseaux permis.
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.