Utilisation de l'interface de ligne de commande (CLI)

Vous pouvez créer et gérer des restrictions basées sur le contexte avec IBM Cloud CLI en installant le plug-in CLI pour les restrictions basées sur le contexte.

Création de zones réseau dans l'interface utilisateur

1. Allez dans Gérer > Restrictions contextuelles dans la console IBM Cloud®

2. Sélectionnez Zones réseau.

3. Cliquez sur Créer.

4. Donnez un nom à votre zone de réseau et fournissez une description.

5. Entrez vos adresses IP autorisées. Vous pouvez saisir une seule adresse IP, une série d'adresses IP ou un seul CIDR.

   Le champ Adresses IP refusées est facultatif et ne doit inclure que les exceptions contenues dans les plages d'adresses IP que vous indiquez dans le champ Adresses IP autorisées.

6. Choisissez vos VPC autorisés, en sélectionnant autant que vous le souhaitez.

7. Référencer un service: Vous pouvez sélectionner Cloud Databases comme service source pour les restrictions basées sur le contexte, mais pas comme service cible. Par exemple, vous pouvez provisionner une instance Cloud Databases en utilisant BYOK à partir de IBM® Key Protect for IBM Cloud® Dans cet exemple, Cloud Databases est la formation source et IBM® Key Protect for IBM Cloud® est la formation cible. Ensuite, vous devez créer une zone réseau avec une référence de service Cloud Databases et créer une règle associée à la zone réseau qui cible IBM® Key Protect for IBM Cloud® Pour ajouter une référence de service Cloud Databases, pour le type de service, les services IAM sont sélectionnés automatiquement. Dans le menu déroulant Service, sélectionnez un service spécifique Cloud Databases Si la zone que vous créez est associée à une règle ciblant Cloud Databases, une référence de service n'est pas autorisée.

Les références de service fonctionnent uniquement de Key Protect service à Cloud Databases.

Créer des zones de réseau dans l'interface de ligne de commande

Pour créer des zones de réseau dans l'interface de gestion, utilisez la commande cbr-zone-create pour ajouter des ressources aux zones de réseau. Pour plus d'informations, voir la référence CLI sur les restrictions basées sur le contexte.

Créez une zone en utilisant une commande telle que

ibmcloud cbr zone-create --addresses=1.1.1.1,5.5.5.5 --name=<NAME>

Création de zones réseau dans Terraform

Pour créer des zones dans Terraform, suivez les instructions de la documentation du fournisseurIBM Cloud Terraform.

Exemple de script Terraform pour créer une zone CBR :

resource "ibm_cbr_zone" "cbr_zone" {
  account_id = "12ab34cd56ef78ab90cd12ef34ab56cd"
  addresses {
    type = "ipAddress"
    value = "169.23.56.234"
  }
  addresses {
    type = "ipRange"
    value = "169.23.22.0-169.23.22.255"
  }
  excluded {
    type  = "ipAddress"
    value = "169.23.22.10"
  }
  excluded {
    type  = "ipAddress"
    value = "169.23.22.11"
  }
  description = "this is an example of zone"
  excluded {
        type = "ipAddress"
        value = "value"
  }
  name = "an example of zone"
}

Vous pouvez également utiliser Terraform IBM Modules(TIM)for CBR Zone pour créer une zone pour les restrictions basées sur le contexte ou mettre à jour les adresses dans une zone existante.

Exemple de création d'une zone CBR à l'aide de Terraform IBM Modules(TIM):

module "ibm_cbr" "zone" {
  source           = "terraform-ibm-modules/cbr/ibm//modules/cbr-zone-module"
  version          = "X.X.X" # Replace "X.X.X" with a release version to lock into a specific release
  name             = "zone_for_pg_access"
  account_id       = "defc0df06b644a9cabc6e44f55b3880s"
  zone_description = "Zone created from terraform"
  addresses        = [{type  = "vpc",value = "vpc_crn"}]
}

Mise à jour des zones réseau dans l'interface de gestion

Mettez à jour une zone à l'aide d'une commande telle que

ibmcloud cbr zone-update <ZONE-ID> --addresses=1.2.3.4 --name=<NAME>

La mise à jour nécessite le ZONE-ID, et non le nom de la zone. Utilisez la commande suivante pour dresser la liste de vos zones et récupérer les ZONE-ID pertinents :

ibmcloud cbr zones

La commande zone-update est un écrasement. Incluez tous les champs obligatoires comme si vous créiez la règle à partir de zéro. Si vous omettez des champs obligatoires, la règle remplace les champs manquants par des champs vides, et la règle peut échouer car certains de ces champs sont obligatoires, qu'ils modifient ou non la règle.

Supprimer des zones de réseau dans l'interface de gestion

Supprimez une zone à l'aide d'une commande telle que

ibmcloud cbr zone-delete <ZONE-ID>

Création de règles à l'aide de l'interface utilisateur

1. Allez dans Gérer > Restrictions contextuelles dans la console IBM Cloud®

2. Sélectionnez Règles.

3. Cliquez sur Créer.

4. Sous Service, sélectionnez le service que vous souhaitez cibler avec votre règle.

5. Sous API, sélectionnez Data plane Actuellement, toute autre sélection entraîne une erreur.

   0 actions sont attendues pour le type d'API du plan de données.

   Cloud Databases ne prend actuellement pas en charge le plan de contrôle en tant qu'option.

6. Sous Ressources, étendez la règle à Toutes les ressources ou Ressources spécifiques. Pour plus d'informations, voir Protéger les ressources Cloud Databases

7. Cliquez sur Continu.

8. Définir les types de terminaux autorisés.

   • Laissez la case à cocher sur Non pour autoriser tous les types de terminaux.
   • Réglez la case à cocher sur Oui pour n'autoriser que certains types de terminaux, puis choisissez dans la liste.

9. Sélectionnez une ou plusieurs zones réseau que vous avez déjà créées, ou créez une nouvelle zone réseau en cliquant sur Créer.

   Les contextes définissent l'endroit où l'on peut accéder à vos ressources, ce qui permet de relier efficacement votre zone réseau à votre règle.

10. Cliquez sur Ajouter pour ajouter votre configuration au résumé.

11. Cliquez sur Suivant.

12. Nommez votre règle.

13. Sélectionnez la manière dont vous souhaitez appliquer la règle.

    Le mode « Rapport uniquement » n'est pas disponible pour Cloud Databases.

Créer des règles dans l'interface de programmation

Pour créer une règle dans l'interface de programmation, vous devez disposer des fichiers Cloud Databases service_name appropriés :

• databases-for-postgresql
• databases-for-mongodb
• databases-for-redis
• databases-for-elasticsearch
• database-for-mysql
• messages-for-rabbitmq

Tous les autres paramètres qui suivent sont expliqués dans le guide de référence du plugin CBR.

Exemple de commande pour la création d'une règle CBR :

ibmcloud cbr rule-create --enforcement-mode enabled --context-attributes "networkZoneId=<ZONE-ID>" --resource-group-id <RESOURCE_GROUP_ID> --service-name <SERVICE-NAME> --service-instance <SERVICE-INSTANCE> --api-types crn:v1:bluemix:public:context-based-restrictions::::api-type:data-plane --description <DESCRIPTION>

La seule api-type option actuellement prise en charge par Cloud Databases est le plan de données.

Le mode « Rapport uniquement » n'est pas disponible pour Cloud Databases.

Mise à jour des règles dans l'interface de programmation

Exemple de commande pour la mise à jour d'une règle CBR :

ibmcloud cbr rule-update <RULE-ID> --enforcement-mode disabled --context-attributes="networkZoneId=<ZONE-ID>" --resource-group-id   <RESOURCE_GROUP_ID> --service-name <SERVICE_NAME> --api-types crn:v1:bluemix:public:context-based-restrictions::::api-type:data-plane --description    <DESCRIPTION>

La commande rule-update est un écrasement. Incluez tous les champs obligatoires comme si vous créiez la règle à partir de zéro. Si vous omettez des champs obligatoires, la règle remplace les champs manquants par des champs vides et la règle risque d'échouer parce que certains de ces champs sont obligatoires, qu'ils modifient ou non la règle.

La mise à jour nécessite le RULE-ID, et non le nom de la règle. Utilisez la commande suivante pour dresser la liste de vos règles et récupérer les RULE-ID pertinents :

ibmcloud cbr rules

Supprimer des règles dans l'interface de gestion

Supprimez une règle à l'aide d'une commande telle que

ibmcloud cbr rule-delete <RULE-ID>

Utilisez ibmcloud cbr <command> — help pour obtenir la liste complète des options et des paramètres. Par exemple, ibmcloud cbr rule-create — help fournit des paramètres pour la création de règles.

Créer des règles dans Terraform

Pour créer des règles dans Terraform, suivez les instructions de la documentation du fournisseurIBM Cloud Terraform.

Pour créer une règle, vous devez disposer des éléments Cloud Databases service_name appropriés :

• databases-for-postgresql
• databases-for-mongodb
• databases-for-redis
• databases-for-elasticsearch
• database-for-mysql
• messages-for-rabbitmq

Créez une règle à l'aide d'une commande telle que

resource "ibm_cbr_rule" "cbr_rule" {
  contexts {
        attributes {
            name = "networkZoneId"
            value = "559052eb8f43302824e7ae490c0281eb"
        }
        attributes {
               name = "endpointType"
               value = "private"
    }
  }
  description = "this is an example of a rule with one context one zone"
  enforcement_mode = "enabled"
  operations {
        api_types {
            api_type_id = "api_type_id"
        }
  }
  resources {
        attributes {
            name = "accountId"
            value = "12ab34cd56ef78ab90cd12ef34ab56cd"
        }
        attributes {
              name = "serviceName"
              value = "network-policy-enabled"
        }
        tags {
              name     = "tag_name"
              value    = "tag_value"
        }
  }
}